share/man/man1/ppriv.1

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH PPRIV 1 "Feb 24, 2008"
   7 .SH NAME
   8 ppriv \- inspect or modify process privilege sets and attributes
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/bin/ppriv\fR \fB-e\fR [\fB-D\fR | \fB-N\fR] [\fB-M\fR] [\fB-s\fR \fIspec\fR] \fIcommand\fR [\fIarg\fR]...
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fB/usr/bin/ppriv\fR [\fB-v\fR] [\fB-S\fR] [\fB-D\fR | \fB-N\fR] [\fB-s\fR \fIspec\fR]
  18      [\fIpid\fR | \fIcore\fR]...
  19 .fi
  20
  21 .LP
  22 .nf
  23 \fB/usr/bin/ppriv\fR \fB-l\fR [\fB-v\fR] [\fIprivilege-specification\fR]...
  24 .fi
  25
  26 .SH DESCRIPTION
  27 .sp
  28 .LP
  29 The first invocation of the \fBppriv\fR command runs the \fIcommand\fR
  30 specified with the privilege sets and flags modified according to the arguments
  31 on the command line.
  32 .sp
  33 .LP
  34 The second invocation examines or changes the privilege state of running
  35 process and core files.
  36 .sp
  37 .LP
  38 The third invocation lists the privileges defined and information about
  39 specified privileges or privileges set specifications.
  40 .SH OPTIONS
  41 .sp
  42 .LP
  43 The following options are supported:
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-D\fR\fR
  48 .ad
  49 .RS 11n
  50 Turns on privilege debugging for the processes or command supplied.
  51 .RE
  52
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fB-e\fR\fR
  57 .ad
  58 .RS 11n
  59 Interprets the remainder of the arguments as a command line and runs the
  60 command line with specified privilege attributes and sets.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fB-l\fR\fR
  67 .ad
  68 .RS 11n
  69 Lists all currently defined privileges on stdout.
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB-N\fR\fR
  76 .ad
  77 .RS 11n
  78 Turns off privilege debugging for the processes or command supplied.
  79 .RE
  80
  81 .sp
  82 .ne 2
  83 .na
  84 \fB\fB-s\fR \fIspec\fR\fR
  85 .ad
  86 .RS 11n
  87 Modifies a process's privilege sets according to \fIspec\fR, a specification
  88 with the format \fB[AEILP][+-=]\fR\fIprivsetspec\fR, containing no spaces,
  89 where:
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fBAEILP\fR\fR
  94 .ad
  95 .RS 15n
  96 Indicates one or more letters indicating which privilege sets to change. These
  97 are case insensitive, for example, either \fBa\fR or \fBA\fR indicates all
  98 privilege sets.
  99 .RE
 100
 101 .sp
 102 .ne 2
 103 .na
 104 \fB\fB+-=\fR\fR
 105 .ad
 106 .RS 15n
 107 Indicates a modifier to respectively add (\fB+\fR), remove (\fB-\fR), or assign
 108 (\fB=\fR) the listed privileges to the specified set(s) in \fIprivsetspec\fR.
 109 .RE
 110
 111 .sp
 112 .ne 2
 113 .na
 114 \fB\fIprivsetspec\fR\fR
 115 .ad
 116 .RS 15n
 117 Indicates a comma-separated privilege set specification
 118 (\fBpriv1\fR,\fBpriv2\fR, and so on), as described in
 119 \fBpriv_str_to_set\fR(3C).
 120 .RE
 121
 122 Modifying the same set with multiple \fB-s\fR options is possible as long as
 123 there is either precisely one assignment to an individual set or any number of
 124 additions and removals. That is, assignment and addition or removal for one set
 125 are mutually exclusive.
 126 .RE
 127
 128 .sp
 129 .ne 2
 130 .na
 131 \fB\fB-S\fR\fR
 132 .ad
 133 .RS 11n
 134 Short. Reports the shortest possible output strings for sets. The default is
 135 portable output. See \fBpriv_str_to_set\fR(3C).
 136 .RE
 137
 138 .sp
 139 .ne 2
 140 .na
 141 \fB\fB-v\fR\fR
 142 .ad
 143 .RS 11n
 144 Verbose. Reports privilege sets using privilege names.
 145 .RE
 146
 147 .SH USAGE
 148 .sp
 149 .LP
 150 The \fBppriv\fR utility examines processes and core files and prints or changes
 151 their privilege sets.
 152 .sp
 153 .LP
 154 \fBppriv\fR can run commands with privilege debugging on or off or with fewer
 155 privileges than the invoking process.
 156 .sp
 157 .LP
 158 When executing a sub process, the only sets that can be modified are \fBL\fR
 159 and \fBI\fR. Privileges can only be removed from \fBL\fR and \fBI\fR as
 160 \fBppriv\fR starts with \fBP=E=I\fR.
 161 .sp
 162 .LP
 163 \fBppriv\fR can also be used to remove privileges from processes or to convey
 164 privileges to other processes. In order to control a process, the effective set
 165 of the \fBppriv\fR utility must be a super set of the controlled process's
 166 \fBE\fR, \fBI\fR, and \fBP\fR. The utility's limit set must be a super set of
 167 the target's limit set. If the target's process uids do not match, the
 168 \fB{PRIV_PROC_OWNER}\fR privilege must be asserted in the utility's effective
 169 set. If the controlled processes have any uid with the value \fB0\fR, more
 170 restrictions might exist. See \fBprivileges\fR(5).
 171 .SH EXAMPLES
 172 .LP
 173 \fBExample 1 \fRObtaining the Process Privileges of the Current Shell
 174 .sp
 175 .LP
 176 The following example obtains the process privileges of the current shell:
 177
 178 .sp
 179 .in +2
 180 .nf
 181 example$ \fBppriv $$\fR
 182 387:   -sh
 183 flags = <none>
 184          E: basic
 185          I: basic
 186          P: basic
 187          L: all
 188 .fi
 189 .in -2
 190 .sp
 191
 192 .LP
 193 \fBExample 2 \fRRemoving a Privilege From Your Shell's Inheritable and
 194 Effective Set
 195 .sp
 196 .LP
 197 The following example removes a privilege from your shell's inheritable and
 198 effective set.
 199
 200 .sp
 201 .in +2
 202 .nf
 203 example$ \fBppriv -s EI-proc_session $$\fR
 204 .fi
 205 .in -2
 206 .sp
 207
 208 .sp
 209 .LP
 210 The subprocess can still inspect the parent shell but it can no longer
 211 influence the parent because the parent has more privileges in its Permitted
 212 set than the \fBppriv\fR child process:
 213
 214 .sp
 215 .in +2
 216 .nf
 217 example$ \fBtruss -p $$\fR
 218 truss: permission denied: 387
 219
 220 example$ \fBppriv $$\fR
 221 387:   -sh
 222 flags = <none>
 223          E: basic,!proc_session
 224          I: basic,!proc_session
 225          P: basic
 226          L: all
 227 .fi
 228 .in -2
 229 .sp
 230
 231 .LP
 232 \fBExample 3 \fRRunning a Process with Privilege Debugging
 233 .sp
 234 .LP
 235 The following example runs a process with privilege debugging:
 236
 237 .sp
 238 .in +2
 239 .nf
 240 example$ \fBppriv -e -D cat /etc/shadow\fR
 241 cat[418]: missing privilege "file_dac_read" (euid = 21782),
 242                     needed at ufs_access+0x3c
 243 cat: cannot open /etc/shadow
 244 .fi
 245 .in -2
 246 .sp
 247
 248 .sp
 249 .LP
 250 The privilege debugging error messages are sent to the controlling terminal of
 251 the current process. The \fBneeded at\fR address specification is an artifact
 252 of the kernel implementation and it can be changed at any time after a software
 253 update.
 254
 255 .sp
 256 .LP
 257 The system call number can be mapped to a system call using
 258 \fB/etc/name_to_sysnum\fR.
 259
 260 .LP
 261 \fBExample 4 \fRListing the Privileges Available in the Current Zone
 262 .sp
 263 .LP
 264 The following example lists the privileges available in the current zone (see
 265 \fBzones\fR(5)). When run in the global zone, all defined privileges are
 266 listed.
 267
 268 .sp
 269 .in +2
 270 .nf
 271 example$ \fBppriv -l zone\fR
 272  ... listing of all privileges elided ...
 273 .fi
 274 .in -2
 275 .sp
 276
 277 .LP
 278 \fBExample 5 \fRExamining a Privilege Aware Process
 279 .sp
 280 .LP
 281 The following example examines a privilege aware process:
 282
 283 .sp
 284 .in +2
 285 .nf
 286 example$ \fBppriv -S `pgrep rpcbind`\fR
 287
 288
 289 928:    /usr/sbin/rpcbind
 290 flags = PRIV_AWARE
 291         E: net_privaddr,proc_fork,sys_nfs
 292         I: none
 293         P: net_privaddr,proc_fork,sys_nfs
 294         L: none
 295 .fi
 296 .in -2
 297 .sp
 298
 299 .sp
 300 .LP
 301 See \fBsetpflags\fR(2) for explanations of the flags.
 302
 303 .SH EXIT STATUS
 304 .sp
 305 .LP
 306 The following exit values are returned:
 307 .sp
 308 .ne 2
 309 .na
 310 \fB\fB0\fR\fR
 311 .ad
 312 .RS 12n
 313 Successful operation.
 314 .RE
 315
 316 .sp
 317 .ne 2
 318 .na
 319 \fBnon-zero\fR
 320 .ad
 321 .RS 12n
 322 An error has occurred.
 323 .RE
 324
 325 .SH FILES
 326 .sp
 327 .ne 2
 328 .na
 329 \fB\fB/proc/*\fR\fR
 330 .ad
 331 .RS 23n
 332 Process files
 333 .RE
 334
 335 .sp
 336 .ne 2
 337 .na
 338 \fB\fB/etc/name_to_sysnum\fR\fR
 339 .ad
 340 .RS 23n
 341 system call name to number mapping
 342 .RE
 343
 344 .SH ATTRIBUTES
 345 .sp
 346 .LP
 347 See \fBattributes\fR(5) for descriptions of the following attributes:
 348 .sp
 349
 350 .sp
 351 .TS
 352 box;
 353 c | c
 354 l | l .
 355 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 356 _
 357 Interface Stability     See below.
 358 .TE
 359
 360 .sp
 361 .LP
 362 The invocation is Committed. The output is Uncommitted.
 363 .SH SEE ALSO
 364 .sp
 365 .LP
 366 \fBgcore\fR(1), \fBtruss\fR(1), \fBsetpflags\fR(2), \fBpriv_str_to_set\fR(3C),
 367 \fBproc\fR(4), \fBattributes\fR(5), \fBprivileges\fR(5), \fBzones\fR(5)