getprocxsec.1m (2010 09)

g
getprocxsec(1M) getprocxsec(1M)
NAME
getprocxsec - display security attributes of a process
SYNOPSIS
getprocxsec [-c][-e
][-f][-p][-r][pid]
DESCRIPTION
The
getprocxsec command displays security attributes associated with a running process. These
attributes include the permitted privilege set, effective privilege set, retained privilege set, euid, and the
compartment name. See privileges (5) and compartments (5).
Each process has a permitted privilege set, effective privilege set, and retained privilege set. If the com-
partmentalization feature is enabled, it also has a compartment. When a process is created, the child
process inherits these attributes from the parent. When a process executes a binary, these attributes can
be changed. See setfilexsec (1M) and getfilexsec (1M) for information on how these extended attributes can
be manipulated at execution time.
For compatibility, the kernel handles processes with effective uid of zero in special ways. If the compart-
mentalization feature is disabled, these processes are treated as though they have all root replacement
privileges. If, on the other hand, the compartmentalization feature is enabled, these processes are
treated as though they have all the root replacement privileges except those configured as disallowed
privileges for the compartment.
Options
getprocxsec recognizes the following options:
-c Displays the compartment name of the process. If compartments are not enabled, nothing is
reported for this option. If compartments are enabled, all the kernel processes would be
reported as running in "RESERVED CMPT" .
-e Displays the implementation effective privilege set.
-f Displays the full form of the lists.
-p Displays the implementation permitted privilege set.
-r Display the implementation retained privilege set.
If none of the above options are specified, the default is
-perc -1
.
Operands
getprocxsec recognizes the following operand:
pid The process ID of the process whose attributes are being displayed. If pid is
-1
, getprocx-
sec displays attributes of this process. If pid is -2, it displays attributes of the process’
parent. If pid is not specified, it defaults to this process (equivalent to -1
).
Security Restrictions
The specified process must be visible to the user invoking this command or the user must have the
COM-
MALLOWED privilege.
RETURN VALUE
getprocxsec returns the following values:
0 Successful completion. The attributes are displayed.
>0 An error occurred. An error can be caused by an invalid option or because the specified pro-
cess is not visible to the user.
EXAMPLES
Example 1: Display the privilege sets and compartment of the current process:
# getprocxsec
Sample output:
effective= BASIC
permitted= BASIC
retained= BASIC
cmpt= init
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1