'\" te
.\" Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved
.\" 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.
.\" 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.
.\" 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]
.TH PROFILES 1 "Feb 11, 2000"
.SH NAME
profiles \- print execution profiles for a user
.SH SYNOPSIS
.LP
.nf
\fBprofiles\fR [\fB-l\fR] [ \fIuser\fR ]...
.fi

.SH DESCRIPTION
.sp
.LP
The \fBprofiles\fR command prints on standard output the names of the execution
profiles that have been assigned to you or to the optionally-specified user or
role name. Profiles are a bundling mechanism used to enumerate the commands and
authorizations needed to perform a specific function. Along with each listed
executable are the process attributes, such as the effective user and group
\fBID\fRs, with which the process runs when started by a privileged command
interpreter. The profile shells are \fBpfcsh\fR, \fBpfksh\fR, and \fBpfexec\fR.
See the \fBpfexec\fR(1) man page. Profiles can contain other profiles defined
in \fBprof_attr\fR(4).
.sp
.LP
Multiple profiles can be combined to construct the appropriate access control.
When profiles are assigned, the authorizations are added to the existing set.
If the same command appears in multiple profiles, the first occurrence, as
determined by the ordering of the profiles, is used for process-attribute
settings. For convenience, a wild card can be specified to match all commands.
.sp
.LP
When profiles are interpreted, the profile list is loaded from
\fBuser_attr\fR(4). If any default profile is defined in
\fB/etc/security/policy.conf\fR (see \fBpolicy.conf\fR(4)), the list of default
profiles are added to the list loaded from \fBuser_attr\fR(4). Matching entries
in \fBprof_attr\fR(4) provide the authorizations list, and matching entries in
\fBexec_attr\fR(4) provide the commands list.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-l\fR\fR
.ad
.RS 6n
Lists the commands in each profile followed by the special process attributes
such as user and group \fBID\fRs.
.RE

.SH EXAMPLES
.LP
\fBExample 1 \fRSample Output
.sp
.LP
The output of the \fBprofiles\fR command has the following form:

.sp
.in +2
.nf
example% \fBprofiles tester01 tester02\fRtester01 : Audit Management, All Commands
tester02 : Device Management, All Commands
example%
.fi
.in -2
.sp

.LP
\fBExample 2 \fRUsing the \fBlist\fR Option
.sp
.in +2
.nf
example% \fBprofiles -l tester01 tester02\fRtester01 :
    Audit Management:
      /usr/sbin/audit          euid=root
      /usr/sbin/auditconfig    euid=root    egid=sys
    All Commands:
      *
tester02 :
    Device Management:
      /usr/bin/allocate:       euid=root
      /usr/bin/deallocate:     euid=root
    All Commands
      *
example%
.fi
.in -2
.sp

.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR \fR
.ad
.RS 6n
Successful completion.
.RE

.sp
.ne 2
.na
\fB\fB1\fR \fR
.ad
.RS 6n
An error occurred.
.RE

.SH FILES
.sp
.LP
\fB/etc/security/exec_attr\fR
.sp
.LP
\fB/etc/security/prof_attr\fR
.sp
.LP
\fB/etc/user_attr\fR
.sp
.LP
\fB/etc/security/policy.conf\fR
.SH SEE ALSO
.sp
.LP
\fBauths\fR(1), \fBpfexec\fR(1), \fBroles\fR(1), \fBgetprofattr\fR(3SECDB),
\fBexec_attr\fR(4), \fBpolicy.conf\fR(4), \fBprof_attr\fR(4),
\fBuser_attr\fR(4), \fBattributes\fR(5)