Sun Microsystems, Inc.
spacerspacer
spacer www.sun.com docs.sun.com |
spacer
black dot
 
 
25.  BSM Services Reference Audit Token Formats process Token  Previous   Contents   Next 
   
 

The praudit command displays the process token as follows:

process,root,root,wheel,root,wheel,0,0,0,0.0.0.0

The following figure shows the format of a process token.

Figure 25-22 process Token Format

The audit ID, user ID, group ID, process ID, and session ID are long instead of short.


Note - The process token fields for the session ID, the real user ID, or the real group ID might be unavailable. The value is then set to -1.


Any token that contains a terminal ID has several variations. The praudit command hides these variations on output of the terminal ID so that they all appear the same. This field is handled the same way for any token that contains it. The terminal ID is either an IP address and port number, or a device ID, such as the serial port that is connected to a modem, in which case it is zero. The terminal ID is specified in one of several formats:

For device numbers:

  • 32-bit applications: 4-byte device number, 4-bytes unused

  • 64-bit applications: 8-byte device number, 4-bytes unused

For port numbers in the Solaris 7 release or earlier releases:

  • 32-bit applications: 4-byte port number, 4-byte IP address

  • 64-bit applications: 8-byte port number, 4-byte IP address

For port numbers in the Solaris 8 or 9 releases:

  • 32-bit with IPV4: 4-byte port number, 4-byte IP type, 4-byte IP address

  • 32-bit with IPV6: 4-byte port number, 4-byte IP type, 16-byte IP address

  • 64-bit with IPV4: 8-byte port number, 4-byte IP type, 4-byte IP address

  • 64-bit with IPV6: 8-byte port number, 4-byte IP type, 16-byte IP address

return Token

The return token contains the return status of the system call (u_error) and the process return value (u_rval1). This token has three fields:

  • a token ID that identifies this token as a return token

  • the error status of the system call

  • the system call return value

The return token is always returned as part of kernel-generated audit records for system calls. This token indicates exit status and other return values in application auditing.

The praudit command displays the return token as follows:

return,success,0

The following figures shows the format of a return token.

Figure 25-23 return Token Format

seq Token

The seq token (sequence token) is an optional token that contains a sequence number. Used for debugging, this token is added to each audit record when the seq policy is active. The seq token has two fields:

  • a token ID that identifies this token as a seq token

  • a 32-bit unsigned long field that contains the sequence number

The sequence number is incremented every time an audit record is generated and added to the audit trail. The praudit command displays the seq token as follows:
sequence,1292

The following figure shows the format of a seq token.

Figure 25-24 seq Token Format


Note - The seq token is output only when the seq audit policy is active.


socket Token

The socket token contains information that describes an Internet socket. This token has six fields:

  • a token ID that identifies this token as a socket token

  • a socket type field that indicates the type of socket referenced (TCP/UDP/UNIX)

  • the local port address

  • the local Internet address

  • the remote port address

  • the remote Internet address

The praudit command displays the socket token as follows:

socket,0x0000,0x0000,0.0.0.0,0x0000,0.0.0.0

For the Solaris 8 release, the Internet address can be displayed as a IPv4 address that uses 4 bytes, or as an IPv6 address that uses 16 bytes to describe the type, and 16 bytes to describe the addresses. The following figure shows the format of a socket token.

Figure 25-25 socket Token Format

subject Token

The subject token describes a user who performs or attempts to perform an operation. The format is the same as the process token. The subject token has nine fields:

  • an ID that identifies this token as a subject token

  • the invariant audit ID

  • the effective user ID

  • the effective group ID

  • the real user ID

  • the real group ID

  • the process ID

  • the audit session ID

  • a terminal ID that consists of a device ID and a machine ID

 
 
 
  Previous   Contents   Next