~ubuntu-branches/debian/sid/hal/sid

« back to all changes in this revision

Viewing changes to doc/man/hal-is-caller-privileged.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2007-10-23 12:33:58 UTC
  • Revision ID: james.westby@ubuntu.com-20071023123358-xaf8mjc5n84d5gtz
Tags: upstream-0.5.10
ImportĀ upstreamĀ versionĀ 0.5.10

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" 
 
2
.\" hal-is-caller-privileged manual page.
 
3
.\" Copyright (C) 2007 David Zeuthen <david@fubar.dk>
 
4
.\"
 
5
.TH HAL-IS-CALLER-PRIVILEGED 1
 
6
.SH NAME
 
7
hal-is-caller-privileged \- determine if a caller is privileged
 
8
.SH SYNOPSIS
 
9
.PP
 
10
.B hal-is-caller-privileged
 
11
[options]
 
12
 
 
13
.SH DESCRIPTION
 
14
 
 
15
\fIhal-is-caller-privileged\fP determines if a specific caller is
 
16
privileged for a given
 
17
.B PolicyKit
 
18
action on given device. For
 
19
more information about both the big picture,
 
20
.B HAL
 
21
and
 
22
.B PolicyKit
 
23
, refer to the \fIHAL spec\fP  (which can be found in 
 
24
.I @docdir@/spec/hal-spec.html
 
25
depending on the distribution) and also the 
 
26
.B PolicyKit
 
27
documentation.
 
28
 
 
29
.SH OPTIONS
 
30
The following options are supported:
 
31
.TP
 
32
.I "--udi"
 
33
The UDI (\fIUnique Device Identifier\fP) of the device object.
 
34
.TP
 
35
.I "--action"
 
36
PolicyKit action to check for.
 
37
.TP
 
38
.I "--caller"
 
39
The unique D-Bus name on the system bus of the caller.
 
40
.TP
 
41
.I "--help"
 
42
Print out usage.
 
43
.TP
 
44
.I "--version"
 
45
Print the version.
 
46
 
 
47
.SH RETURN VALUE
 
48
.PP
 
49
If an error occurs this program exits with a non-zero exit
 
50
code. Otherwise the textual reply will be printed on stdout and this
 
51
program will exit with exit code 0. Unprivileged callers (e.g. with a
 
52
non-zero uid) can only ask about callers/processes that matches their
 
53
own uid.
 
54
 
 
55
.SH BUGS
 
56
.PP
 
57
Please send bug reports to either the distribution or the HAL
 
58
mailing list, see 
 
59
.I "http://lists.freedesktop.org/mailman/listinfo/hal"
 
60
on how to subscribe.
 
61
 
 
62
.SH SEE ALSO
 
63
.PP
 
64
\&\fIhald\fR\|(8), 
 
65
\&\fIpolkit-check-caller\fR\|(1)
 
66
 
 
67
.SH AUTHOR
 
68
Written by David Zeuthen <david@fubar.dk> with a lot of help from many
 
69
others.
 
70