share/man/man1/profiles.1

   1 '\" te
   2 .\" Copyright (c) 2000, 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 PROFILES 1 "Jan 7, 2018"
   7 .SH NAME
   8 profiles \- print execution profiles for a user
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBprofiles\fR [\fB-l\fR] [ \fIuser\fR ]...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .LP
  17 The \fBprofiles\fR command prints on standard output the names of the execution
  18 profiles that have been assigned to you or to the optionally-specified user or
  19 role name. Profiles are a bundling mechanism used to enumerate the commands and
  20 authorizations needed to perform a specific function. Along with each listed
  21 executable are the process attributes, such as the effective user and group
  22 \fBID\fRs, with which the process runs when started by a privileged command
  23 interpreter. The profile shells are \fBpfksh\fR and \fBpfexec\fR.
  24 See the \fBpfexec\fR(1) man page. Profiles can contain other profiles defined
  25 in \fBprof_attr\fR(4).
  26 .sp
  27 .LP
  28 Multiple profiles can be combined to construct the appropriate access control.
  29 When profiles are assigned, the authorizations are added to the existing set.
  30 If the same command appears in multiple profiles, the first occurrence, as
  31 determined by the ordering of the profiles, is used for process-attribute
  32 settings. For convenience, a wild card can be specified to match all commands.
  33 .sp
  34 .LP
  35 When profiles are interpreted, the profile list is loaded from
  36 \fBuser_attr\fR(4). If any default profile is defined in
  37 \fB/etc/security/policy.conf\fR (see \fBpolicy.conf\fR(4)), the list of default
  38 profiles are added to the list loaded from \fBuser_attr\fR(4). Matching entries
  39 in \fBprof_attr\fR(4) provide the authorizations list, and matching entries in
  40 \fBexec_attr\fR(4) provide the commands list.
  41 .SH OPTIONS
  42 .LP
  43 The following options are supported:
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-l\fR\fR
  48 .ad
  49 .RS 6n
  50 Lists the commands in each profile followed by the special process attributes
  51 such as user and group \fBID\fRs.
  52 .RE
  53
  54 .SH EXAMPLES
  55 .LP
  56 \fBExample 1\fR Sample Output
  57 .sp
  58 .LP
  59 The output of the \fBprofiles\fR command has the following form:
  60
  61 .sp
  62 .in +2
  63 .nf
  64 example% \fBprofiles tester01 tester02\fR
  65 tester01 : Audit Management, All Commands
  66 tester02 : Device Management, All Commands
  67 example%
  68 .fi
  69 .in -2
  70 .sp
  71
  72 .LP
  73 \fBExample 2\fR Using the \fBlist\fR Option
  74 .sp
  75 .in +2
  76 .nf
  77 example% \fBprofiles -l tester01 tester02\fR
  78 tester01 :
  79     Audit Management:
  80       /usr/sbin/audit          euid=root
  81       /usr/sbin/auditconfig    euid=root    egid=sys
  82     All Commands:
  83       *
  84 tester02 :
  85     Device Management:
  86       /usr/bin/allocate:       euid=root
  87       /usr/bin/deallocate:     euid=root
  88     All Commands
  89       *
  90 example%
  91 .fi
  92 .in -2
  93 .sp
  94
  95 .SH EXIT STATUS
  96 .LP
  97 The following exit values are returned:
  98 .sp
  99 .ne 2
 100 .na
 101 \fB\fB0\fR \fR
 102 .ad
 103 .RS 6n
 104 Successful completion.
 105 .RE
 106
 107 .sp
 108 .ne 2
 109 .na
 110 \fB\fB1\fR \fR
 111 .ad
 112 .RS 6n
 113 An error occurred.
 114 .RE
 115
 116 .SH FILES
 117 .LP
 118 \fB/etc/security/exec_attr\fR
 119 .sp
 120 .LP
 121 \fB/etc/security/prof_attr\fR
 122 .sp
 123 .LP
 124 \fB/etc/user_attr\fR
 125 .sp
 126 .LP
 127 \fB/etc/security/policy.conf\fR
 128 .SH SEE ALSO
 129 .LP
 130 \fBauths\fR(1), \fBpfexec\fR(1), \fBroles\fR(1), \fBgetprofattr\fR(3SECDB),
 131 \fBexec_attr\fR(4), \fBpolicy.conf\fR(4), \fBprof_attr\fR(4),
 132 \fBuser_attr\fR(4), \fBattributes\fR(5)