share/man/man8/polkit-is-privileged.8

   1 '\" te
   2 .\" Copyright (c) 2006, 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 POLKIT-IS-PRIVILEGED 8 "Aug 22, 2006"
   7 .SH NAME
   8 polkit-is-privileged \- check PolicyKit privileges
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBpolkit-is-privileged\fR  [\fB-hvV\fR] \fB-u\fR \fIuser\fR \fB-p\fR \fIprivilege\fR [\fB-r\fR \fIresource\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBpolkit-is-privileged\fR command queries system policy to determine
  19 whether a user is allowed for a given privilege and resource. The resource name
  20 can be omitted. On the Solaris operating system, RBAC authorizations names
  21 should be used as privilege names.
  22 .sp
  23 .LP
  24 Currently, the only consumer of PolicyKit is \fBhald\fR(8).
  25 .SH OPTIONS
  26 .sp
  27 .LP
  28 The following options are supported:
  29 .sp
  30 .ne 2
  31 .na
  32 \fB\fB-h\fR, \fB--help\fR\fR
  33 .ad
  34 .sp .6
  35 .RS 4n
  36 Display list of options and exit.
  37 .RE
  38
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fB-p\fR \fIprivilege\fR, \fB--privilege\fR \fIprivilege\fR\fR
  43 .ad
  44 .sp .6
  45 .RS 4n
  46 Name of privilege associated with user. Command tests for this privilege.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fB-r\fR \fIresource\fR, \fB--resource\fR \fIresource\fR\fR
  53 .ad
  54 .sp .6
  55 .RS 4n
  56 Name of resource associated with user and privilege. Command tests for this
  57 resource.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-u\fR \fIuser\fR, \fB--user\fR \fIuser\fR\fR
  64 .ad
  65 .sp .6
  66 .RS 4n
  67 User name or user id that is tested for.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB-v\fR, \fB--verbose\fR\fR
  74 .ad
  75 .sp .6
  76 .RS 4n
  77 Verbose mode.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-V\fR, \fB--version\fR\fR
  84 .ad
  85 .sp .6
  86 .RS 4n
  87 Displays version number.
  88 .RE
  89
  90 .SH ATTRIBUTES
  91 .sp
  92 .LP
  93 See \fBattributes\fR(5) for descriptions of the following attributes:
  94 .sp
  95
  96 .sp
  97 .TS
  98 box;
  99 c | c
 100 l | l .
 101 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 102 _
 103 Interface Stability     Volatile
 104 .TE
 105
 106 .SH SEE ALSO
 107 .sp
 108 .LP
 109 \fBauths\fR(1), \fBprofiles\fR(1), \fBhald\fR(8), \fBgetauthattr\fR(3SECDB),
 110 \fBauth_attr\fR(4), \fBpolicy.conf\fR(4), \fBprof_attr\fR(4),
 111 \fBuser_attr\fR(4), \fBattributes\fR(5)