usr/src/uts/common/os/priv_defs

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 /*
  22  * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
  23  * Copyright 2015, Joyent, Inc. All rights reserved.
  24  *
  25 INSERT COMMENT
  26  */
  27
  28 #
  29 # Privileges can be added to this file at any location, not
  30 # necessarily at the end.  For patches, it is probably best to
  31 # add the new privilege at the end; for ordinary releases privileges
  32 # should be ordered alphabetically.
  33 #
  34
  35 privilege PRIV_CONTRACT_EVENT
  36
  37         Allows a process to request critical events without limitation.
  38         Allows a process to request reliable delivery of all events on
  39         any event queue.
  40
  41 privilege PRIV_CONTRACT_IDENTITY
  42
  43         Allows a process to set the service FMRI value of a process
  44         contract template.
  45
  46 privilege PRIV_CONTRACT_OBSERVER
  47
  48         Allows a process to observe contract events generated by
  49         contracts created and owned by users other than the process's
  50         effective user ID.
  51         Allows a process to open contract event endpoints belonging to
  52         contracts created and owned by users other than the process's
  53         effective user ID.
  54
  55 privilege PRIV_CPC_CPU
  56
  57         Allow a process to access per-CPU hardware performance counters.
  58
  59 privilege PRIV_DTRACE_KERNEL
  60
  61         Allows DTrace kernel-level tracing.
  62
  63 privilege PRIV_DTRACE_PROC
  64
  65         Allows DTrace process-level tracing.
  66         Allows process-level tracing probes to be placed and enabled in
  67         processes to which the user has permissions.
  68
  69 privilege PRIV_DTRACE_USER
  70
  71         Allows DTrace user-level tracing.
  72         Allows use of the syscall and profile DTrace providers to
  73         examine processes to which the user has permissions.
  74
  75 privilege PRIV_FILE_CHOWN
  76
  77         Allows a process to change a file's owner user ID.
  78         Allows a process to change a file's group ID to one other than
  79         the process' effective group ID or one of the process'
  80         supplemental group IDs.
  81
  82 privilege PRIV_FILE_CHOWN_SELF
  83
  84         Allows a process to give away its files; a process with this
  85         privilege will run as if {_POSIX_CHOWN_RESTRICTED} is not
  86         in effect.
  87
  88 privilege PRIV_FILE_DAC_EXECUTE
  89
  90         Allows a process to execute an executable file whose permission
  91         bits or ACL do not allow the process execute permission.
  92
  93 privilege PRIV_FILE_DAC_READ
  94
  95         Allows a process to read a file or directory whose permission
  96         bits or ACL do not allow the process read permission.
  97
  98 privilege PRIV_FILE_DAC_SEARCH
  99
 100         Allows a process to search a directory whose permission bits or
 101         ACL do not allow the process search permission.
 102
 103 privilege PRIV_FILE_DAC_WRITE
 104
 105         Allows a process to write a file or directory whose permission
 106         bits or ACL do not allow the process write permission.
 107         In order to write files owned by uid 0 in the absence of an
 108         effective uid of 0 ALL privileges are required.
 109
 110 privilege PRIV_FILE_DOWNGRADE_SL
 111
 112         Allows a process to set the sensitivity label of a file or
 113         directory to a sensitivity label that does not dominate the
 114         existing sensitivity label.
 115         This privilege is interpreted only if the system is configured
 116         with Trusted Extensions.
 117
 118 privilege PRIV_FILE_FLAG_SET
 119
 120         Allows a process to set immutable, nounlink or appendonly
 121         file attributes.
 122
 123 basic privilege PRIV_FILE_LINK_ANY
 124
 125         Allows a process to create hardlinks to files owned by a uid
 126         different from the process' effective uid.
 127
 128 privilege PRIV_FILE_OWNER
 129
 130         Allows a process which is not the owner of a file or directory
 131         to perform the following operations that are normally permitted
 132         only for the file owner: modify that file's access and
 133         modification times; remove or rename a file or directory whose
 134         parent directory has the ``save text image after execution''
 135         (sticky) bit set; mount a ``namefs'' upon a file; modify
 136         permission bits or ACL except for the set-uid and set-gid
 137         bits.
 138
 139 basic privilege PRIV_FILE_READ
 140
 141         Allows a process to read objects in the filesystem.
 142
 143 privilege PRIV_FILE_SETID
 144
 145         Allows a process to change the ownership of a file or write to
 146         a file without the set-user-ID and set-group-ID bits being
 147         cleared.
 148         Allows a process to set the set-group-ID bit on a file or
 149         directory whose group is not the process' effective group or
 150         one of the process' supplemental groups.
 151         Allows a process to set the set-user-ID bit on a file with
 152         different ownership in the presence of PRIV_FILE_OWNER.
 153         Additional restrictions apply when creating or modifying a
 154         set-uid 0 file.
 155
 156 privilege PRIV_FILE_UPGRADE_SL
 157
 158         Allows a process to set the sensitivity label of a file or
 159         directory to a sensitivity label that dominates the existing
 160         sensitivity label.
 161         This privilege is interpreted only if the system is configured
 162         with Trusted Extensions.
 163
 164 basic privilege PRIV_FILE_WRITE
 165
 166         Allows a process to modify objects in the filesystem.
 167
 168 privilege PRIV_GRAPHICS_ACCESS
 169
 170         Allows a process to make privileged ioctls to graphics devices.
 171         Typically only xserver process needs to have this privilege.
 172         A process with this privilege is also allowed to perform
 173         privileged graphics device mappings.
 174
 175 privilege PRIV_GRAPHICS_MAP
 176
 177         Allows a process to perform privileged mappings through a
 178         graphics device.
 179
 180 privilege PRIV_IPC_DAC_READ
 181
 182         Allows a process to read a System V IPC
 183         Message Queue, Semaphore Set, or Shared Memory Segment whose
 184         permission bits do not allow the process read permission.
 185         Allows a process to read remote shared memory whose
 186         permission bits do not allow the process read permission.
 187
 188 privilege PRIV_IPC_DAC_WRITE
 189
 190         Allows a process to write a System V IPC
 191         Message Queue, Semaphore Set, or Shared Memory Segment whose
 192         permission bits do not allow the process write permission.
 193         Allows a process to read remote shared memory whose
 194         permission bits do not allow the process write permission.
 195         Additional restrictions apply if the owner of the object has uid 0
 196         and the effective uid of the current process is not 0.
 197
 198 privilege PRIV_IPC_OWNER
 199
 200         Allows a process which is not the owner of a System
 201         V IPC Message Queue, Semaphore Set, or Shared Memory Segment to
 202         remove, change ownership of, or change permission bits of the
 203         Message Queue, Semaphore Set, or Shared Memory Segment.
 204         Additional restrictions apply if the owner of the object has uid 0
 205         and the effective uid of the current process is not 0.
 206
 207 basic privilege PRIV_NET_ACCESS
 208
 209         Allows a process to open a TCP, UDP, SDP or SCTP network endpoint.
 210
 211 privilege PRIV_NET_BINDMLP
 212
 213         Allow a process to bind to a port that is configured as a
 214         multi-level port(MLP) for the process's zone. This privilege
 215         applies to both shared address and zone-specific address MLPs.
 216         See tnzonecfg(4) from the Trusted Extensions manual pages for
 217         information on configuring MLP ports.
 218         This privilege is interpreted only if the system is configured
 219         with Trusted Extensions.
 220
 221 privilege PRIV_NET_ICMPACCESS
 222
 223         Allows a process to send and receive ICMP packets.
 224
 225 privilege PRIV_NET_MAC_AWARE
 226
 227         Allows a process to set NET_MAC_AWARE process flag by using
 228         setpflags(2). This privilege also allows a process to set
 229         SO_MAC_EXEMPT socket option by using setsockopt(3SOCKET).
 230         The NET_MAC_AWARE process flag and the SO_MAC_EXEMPT socket
 231         option both allow a local process to communicate with an
 232         unlabeled peer if the local process' label dominates the
 233         peer's default label, or if the local process runs in the
 234         global zone.
 235         This privilege is interpreted only if the system is configured
 236         with Trusted Extensions.
 237
 238 privilege PRIV_NET_MAC_IMPLICIT
 239
 240         Allows a process to set SO_MAC_IMPLICIT option by using
 241         setsockopt(3SOCKET).  This allows a privileged process to
 242         transmit implicitly-labeled packets to a peer.
 243         This privilege is interpreted only if the system is configured
 244         with Trusted Extensions.
 245
 246 privilege PRIV_NET_OBSERVABILITY
 247
 248         Allows a process to access /dev/lo0 and the devices in /dev/ipnet/
 249         while not requiring them to need PRIV_NET_RAWACCESS.
 250
 251 privilege PRIV_NET_PRIVADDR
 252
 253         Allows a process to bind to a privileged port
 254         number. The privilege port numbers are 1-1023 (the traditional
 255         UNIX privileged ports) as well as those ports marked as
 256         "udp/tcp_extra_priv_ports" with the exception of the ports
 257         reserved for use by NFS.
 258
 259 privilege PRIV_NET_RAWACCESS
 260
 261         Allows a process to have direct access to the network layer.
 262
 263 unsafe privilege PRIV_PROC_AUDIT
 264
 265         Allows a process to generate audit records.
 266         Allows a process to get its own audit pre-selection information.
 267
 268 privilege PRIV_PROC_CHROOT
 269
 270         Allows a process to change its root directory.
 271
 272 privilege PRIV_PROC_CLOCK_HIGHRES
 273
 274         Allows a process to use high resolution timers.
 275
 276 basic privilege PRIV_PROC_EXEC
 277
 278         Allows a process to call execve().
 279
 280 basic privilege PRIV_PROC_FORK
 281
 282         Allows a process to call fork1()/forkall()/vfork()
 283
 284 basic privilege PRIV_PROC_INFO
 285
 286         Allows a process to examine the status of processes other
 287         than those it can send signals to.  Processes which cannot
 288         be examined cannot be seen in /proc and appear not to exist.
 289
 290 privilege PRIV_PROC_LOCK_MEMORY
 291
 292         Allows a process to lock pages in physical memory.
 293
 294 privilege PRIV_PROC_MEMINFO
 295
 296         Allows a process to access physical memory information.
 297
 298 privilege PRIV_PROC_OWNER
 299
 300         Allows a process to send signals to other processes, inspect
 301         and modify process state to other processes regardless of
 302         ownership.  When modifying another process, additional
 303         restrictions apply:  the effective privilege set of the
 304         attaching process must be a superset of the target process'
 305         effective, permitted and inheritable sets; the limit set must
 306         be a superset of the target's limit set; if the target process
 307         has any uid set to 0 all privilege must be asserted unless the
 308         effective uid is 0.
 309         Allows a process to bind arbitrary processes to CPUs.
 310
 311 privilege PRIV_PROC_PRIOUP
 312
 313         Allows a process to elevate its priority above its current level.
 314
 315 privilege PRIV_PROC_PRIOCNTL
 316
 317         Allows all that PRIV_PROC_PRIOUP allows.
 318         Allows a process to change its scheduling class to any scheduling class,
 319         including the RT class.
 320
 321 basic privilege PRIV_PROC_SECFLAGS
 322
 323         Allows a process to manipulate the secflags of processes (subject to,
 324         additionally, the ability to signal that process)
 325
 326 basic privilege PRIV_PROC_SESSION
 327
 328         Allows a process to send signals or trace processes outside its
 329         session.
 330
 331 unsafe privilege PRIV_PROC_SETID
 332
 333         Allows a process to set its uids at will.
 334         Assuming uid 0 requires all privileges to be asserted.
 335
 336 privilege PRIV_PROC_TASKID
 337
 338         Allows a process to assign a new task ID to the calling process.
 339
 340 privilege PRIV_PROC_ZONE
 341
 342         Allows a process to trace or send signals to processes in
 343         other zones.
 344
 345 privilege PRIV_SYS_ACCT
 346
 347         Allows a process to enable and disable and manage accounting through
 348         acct(2), getacct(2), putacct(2) and wracct(2).
 349
 350 privilege PRIV_SYS_ADMIN
 351
 352         Allows a process to perform system administration tasks such
 353         as setting node and domain name and specifying nscd and coreadm
 354         settings.
 355
 356 privilege PRIV_SYS_AUDIT
 357
 358         Allows a process to start the (kernel) audit daemon.
 359         Allows a process to view and set audit state (audit user ID,
 360         audit terminal ID, audit sessions ID, audit pre-selection mask).
 361         Allows a process to turn off and on auditing.
 362         Allows a process to configure the audit parameters (cache and
 363         queue sizes, event to class mappings, policy options).
 364
 365 privilege PRIV_SYS_CONFIG
 366
 367         Allows a process to perform various system configuration tasks.
 368         Allows a process to add and remove swap devices; when adding a swap
 369         device, a process must also have sufficient privileges to read from
 370         and write to the swap device.
 371
 372 privilege PRIV_SYS_DEVICES
 373
 374         Allows a process to successfully call a kernel module that
 375         calls the kernel drv_priv(9F) function to check for allowed
 376         access.
 377         Allows a process to open the real console device directly.
 378         Allows a process to open devices that have been exclusively opened.
 379
 380 privilege PRIV_SYS_IPC_CONFIG
 381
 382         Allows a process to increase the size of a System V IPC Message
 383         Queue buffer.
 384
 385 privilege PRIV_SYS_LINKDIR
 386
 387         Allows a process to unlink and link directories.
 388
 389 privilege PRIV_SYS_MOUNT
 390
 391         Allows filesystem specific administrative procedures, such as
 392         filesystem configuration ioctls, quota calls and creation/deletion
 393         of snapshots.
 394         Allows a process to mount and unmount filesystems which would
 395         otherwise be restricted (i.e., most filesystems except
 396         namefs).
 397         A process performing a mount operation needs to have
 398         appropriate access to the device being mounted (read-write for
 399         "rw" mounts, read for "ro" mounts).
 400         A process performing any of the aforementioned
 401         filesystem operations needs to have read/write/owner
 402         access to the mount point.
 403         Only regular files and directories can serve as mount points
 404         for processes which do not have all zone privileges asserted.
 405         Unless a process has all zone privileges, the mount(2)
 406         system call will force the "nosuid" and "restrict" options, the
 407         latter only for autofs mountpoints.
 408         Regardless of privileges, a process running in a non-global zone may
 409         only control mounts performed from within said zone.
 410         Outside the global zone, the "nodevices" option is always forced.
 411
 412 privilege PRIV_SYS_IPTUN_CONFIG
 413
 414         Allows a process to configure IP tunnel links.
 415
 416 privilege PRIV_SYS_DL_CONFIG
 417
 418         Allows a process to configure all classes of datalinks, including
 419         configuration allowed by PRIV_SYS_IPTUN_CONFIG.
 420
 421 privilege PRIV_SYS_IP_CONFIG
 422
 423         Allows a process to configure a system's IP interfaces and routes.
 424         Allows a process to configure network parameters using ndd.
 425         Allows a process access to otherwise restricted information using ndd.
 426         Allows a process to configure IPsec.
 427         Allows a process to pop anchored STREAMs modules with matching zoneid.
 428
 429 privilege PRIV_SYS_NET_CONFIG
 430
 431         Allows all that PRIV_SYS_IP_CONFIG, PRIV_SYS_DL_CONFIG, and
 432         PRIV_SYS_PPP_CONFIG allow.
 433         Allows a process to push the rpcmod STREAMs module.
 434         Allows a process to INSERT/REMOVE STREAMs modules on locations other
 435         than the top of the module stack.
 436
 437 privilege PRIV_SYS_NFS
 438
 439         Allows a process to perform Sun private NFS specific system calls.
 440         Allows a process to bind to ports reserved by NFS: ports 2049 (nfs)
 441         and port 4045 (lockd).
 442
 443 privilege PRIV_SYS_PPP_CONFIG
 444
 445         Allows a process to create and destroy PPP (sppp) interfaces.
 446         Allows a process to configure PPP tunnels (sppptun).
 447
 448 privilege PRIV_SYS_RES_BIND
 449
 450         Allows a process to bind processes to processor sets.
 451
 452 privilege PRIV_SYS_RES_CONFIG
 453
 454         Allows all that PRIV_SYS_RES_BIND allows.
 455         Allows a process to create and delete processor sets, assign
 456         CPUs to processor sets and override the PSET_NOESCAPE property.
 457         Allows a process to change the operational status of CPUs in
 458         the system using p_online(2).
 459         Allows a process to configure resource pools and to bind
 460         processes to pools
 461
 462 unsafe privilege PRIV_SYS_RESOURCE
 463
 464         Allows a process to modify the resource limits specified
 465         by setrlimit(2) and setrctl(2) without restriction.
 466         Allows a process to exceed the per-user maximum number of
 467         processes.
 468         Allows a process to extend or create files on a filesystem that
 469         has less than minfree space in reserve.
 470
 471 privilege PRIV_SYS_SMB
 472
 473         Allows a process to access the Sun private SMB kernel module.
 474         Allows a process to bind to ports reserved by NetBIOS and SMB:
 475         ports 137 (NBNS), 138 (NetBIOS Datagram Service), 139 (NetBIOS
 476         Session Service and SMB-over-NBT) and 445 (SMB-over-TCP).
 477
 478 privilege PRIV_SYS_SUSER_COMPAT
 479
 480         Allows a process to successfully call a third party loadable module
 481         that calls the kernel suser() function to check for allowed access.
 482         This privilege exists only for third party loadable module
 483         compatibility and is not used by Solaris proper.
 484
 485 privilege PRIV_SYS_TIME
 486
 487         Allows a process to manipulate system time using any of the
 488         appropriate system calls: stime, adjtime, ntp_adjtime and
 489         the IA specific RTC calls.
 490
 491 privilege PRIV_SYS_TRANS_LABEL
 492
 493         Allows a process to translate labels that are not dominated
 494         by the process' sensitivity label to and from an external
 495         string form.
 496         This privilege is interpreted only if the system is configured
 497         with Trusted Extensions.
 498
 499 privilege PRIV_VIRT_MANAGE
 500
 501         Allows a process to manage virtualized environments such as
 502         xVM(5).
 503
 504 privilege PRIV_WIN_COLORMAP
 505
 506         Allows a process to override colormap restrictions.
 507         Allows a process to install or remove colormaps.
 508         Allows a process to retrieve colormap cell entries allocated
 509         by other processes.
 510         This privilege is interpreted only if the system is configured
 511         with Trusted Extensions.
 512
 513 privilege PRIV_WIN_CONFIG
 514
 515         Allows a process to configure or destroy resources that are
 516         permanently retained by the X server.
 517         Allows a process to use SetScreenSaver to set the screen
 518         saver timeout value.
 519         Allows a process to use ChangeHosts to modify the display
 520         access control list.
 521         Allows a process to use GrabServer.
 522         Allows a process to use the SetCloseDownMode request which
 523         may retain window, pixmap, colormap, property, cursor, font,
 524         or graphic context resources.
 525         This privilege is interpreted only if the system is configured
 526         with Trusted Extensions.
 527
 528 privilege PRIV_WIN_DAC_READ
 529
 530         Allows a process to read from a window resource that it does
 531         not own (has a different user ID).
 532         This privilege is interpreted only if the system is configured
 533         with Trusted Extensions.
 534
 535 privilege PRIV_WIN_DAC_WRITE
 536
 537         Allows a process to write to or create a window resource that
 538         it does not own (has a different user ID). A newly created
 539         window property is created with the window's user ID.
 540         This privilege is interpreted only if the system is configured
 541         with Trusted Extensions.
 542
 543 privilege PRIV_WIN_DEVICES
 544
 545         Allows a process to perform operations on window input devices.
 546         Allows a process to get and set keyboard and pointer controls.
 547         Allows a process to modify pointer button and key mappings.
 548         This privilege is interpreted only if the system is configured
 549         with Trusted Extensions.
 550
 551 privilege PRIV_WIN_DGA
 552
 553         Allows a process to use the direct graphics access (DGA) X protocol
 554         extensions. Direct process access to the frame buffer is still
 555         required. Thus the process must have MAC and DAC privileges that
 556         allow access to the frame buffer, or the frame buffer must be
 557         allocated to the process.
 558         This privilege is interpreted only if the system is configured
 559         with Trusted Extensions.
 560
 561 privilege PRIV_WIN_DOWNGRADE_SL
 562
 563         Allows a process to set the sensitivity label of a window resource
 564         to a sensitivity label that does not dominate the existing
 565         sensitivity label.
 566         This privilege is interpreted only if the system is configured
 567         with Trusted Extensions.
 568
 569 privilege PRIV_WIN_FONTPATH
 570
 571         Allows a process to set a font path.
 572         This privilege is interpreted only if the system is configured
 573         with Trusted Extensions.
 574
 575 privilege PRIV_WIN_MAC_READ
 576
 577         Allows a process to read from a window resource whose sensitivity
 578         label is not equal to the process sensitivity label.
 579         This privilege is interpreted only if the system is configured
 580         with Trusted Extensions.
 581
 582 privilege PRIV_WIN_MAC_WRITE
 583
 584         Allows a process to create a window resource whose sensitivity
 585         label is not equal to the process sensitivity label.
 586         A newly created window property is created with the window's
 587         sensitivity label.
 588         This privilege is interpreted only if the system is configured
 589         with Trusted Extensions.
 590
 591 privilege PRIV_WIN_SELECTION
 592
 593         Allows a process to request inter-window data moves without the
 594         intervention of the selection confirmer.
 595         This privilege is interpreted only if the system is configured
 596         with Trusted Extensions.
 597
 598 privilege PRIV_WIN_UPGRADE_SL
 599
 600         Allows a process to set the sensitivity label of a window
 601         resource to a sensitivity label that dominates the existing
 602         sensitivity label.
 603         This privilege is interpreted only if the system is configured
 604         with Trusted Extensions.
 605
 606 privilege PRIV_XVM_CONTROL
 607
 608         Allows a process access to the xVM(5) control devices for
 609         managing guest domains and the hypervisor. This privilege is
 610         used only if booted into xVM on x86 platforms.
 611
 612 set PRIV_EFFECTIVE
 613
 614         Set of privileges currently in effect.
 615
 616 set PRIV_INHERITABLE
 617
 618         Set of privileges that comes into effect on exec.
 619
 620 set PRIV_PERMITTED
 621
 622         Set of privileges that can be put into the effective set without
 623         restriction.
 624
 625 set PRIV_LIMIT
 626
 627         Set of privileges that determines the absolute upper bound of
 628         privileges this process and its off-spring can obtain.