← Back to branch summary

~ubuntu-branches/ubuntu/vivid/munge/vivid

« back to all changes in this revision

Viewing changes to src/munge/unmunge.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Gennaro Oliva
  • Date: 2011-02-28 20:41:12 UTC
  • mfrom: (6.1.6 sid)
  • Revision ID: james.westby@ubuntu.com-20110228204112-2lc8ss9geeusv5uo
Tags: 0.5.10-1
* New upstream release 
* Updated copyright, homepage, watch thanks to Chris Dunlap
* Standards version upgraded to 3.9.1.0 (no changes) 
* Switch to dpkg-source 3.0 (quilt) format
* Added explicit dependency by the same version of libmunge for munge

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/munge/unmunge.1.in
1
1
.\"****************************************************************************
2
 
.\" $Id: unmunge.1.in 771 2010-03-02 23:14:07Z dun $
 
2
.\" $Id: unmunge.1.in 890 2011-01-20 01:54:21Z chris.m.dunlap $
3
3
.\"****************************************************************************
4
4
.\" Written by Chris Dunlap <cdunlap@llnl.gov>.
5
 
.\" Copyright (C) 2007-2010 Lawrence Livermore National Security, LLC.
 
5
.\" Copyright (C) 2007-2011 Lawrence Livermore National Security, LLC.
6
6
.\" Copyright (C) 2002-2007 The Regents of the University of California.
7
7
.\" UCRL-CODE-155910.
8
8
.\"
9
9
.\" This file is part of the MUNGE Uid 'N' Gid Emporium (MUNGE).
10
 
.\" For details, see <http://home.gna.org/munge/>.
 
10
.\" For details, see <http://munge.googlecode.com/>.
11
11
.\"
12
12
.\" MUNGE is free software: you can redistribute it and/or modify it under
13
13
.\" the terms of the GNU General Public License as published by the Free
37
37
[\fIOPTION\fR]...
38
38
 
39
39
.SH DESCRIPTION
40
 
The \fBunmunge\fR program validates a MUNGE credential (e.g., one created by
41
 
the \fBmunge\fR program).
 
40
The \fBunmunge\fR program validates a MUNGE credential (e.g., one created
 
41
by the \fBmunge\fR program).
42
42
.PP
43
 
By default, the credential is read from stdin and the metadata & payload
 
43
By default, the credential is read from stdin and the metadata and payload
44
44
are written to stdout.  When the metadata and payload are written to the
45
45
same stream, they are separated by a blank line.
46
46
 
69
69
.TP
70
70
.BI "-k, --keys " string
71
71
Specify a subset of metadata keys to output.  The keys are case-insensitive
72
 
and delimited by whitespace, commas, semicolons, or periods -- as long as the
73
 
string is treated as a single argument by the shell (e.g., enclosed by quotes).
74
 
If a subset is not specified, all available keys are selected by default.
 
72
and delimited by whitespace, commas, semicolons, or periods -- as long as
 
73
the string is treated as a single argument by the shell (e.g., enclosed
 
74
by quotes).  If a subset is not specified, all available keys are selected
 
75
by default.
75
76
.TP
76
77
.BI "-K, --list-keys"
77
78
Display a list of metadata keys.
89
90
The address of the host on which the credential was encoded.
90
91
.TP
91
92
.B ENCODE_TIME
92
 
The time at which the credential was encoded (according to the clock of the
93
 
host that encoded it).
 
93
The time at which the credential was encoded (according to the local clock
 
94
of the host that encoded it).
94
95
.TP
95
96
.B DECODE_TIME
96
 
The time at which the credential was decoded (according to the local clock).
 
97
The time at which the credential was decoded (according to the local clock
 
98
of the host that decoded it).
97
99
.TP
98
100
.B TTL
99
101
The time-to-live value (in seconds) placed within the credential.
124
126
 
125
127
.SH "EXIT STATUS"
126
128
The \fBunmunge\fR program returns an exit code corresponding to the return
127
 
code of \fBmunge_decode\fR(3).  On success, it returns a zero exit code which
128
 
signifies the credential is valid.  On error, it prints an error message to
129
 
stderr and returns a non-zero exit code.
 
129
code of \fBmunge_decode\fR().  On success, it returns a zero exit code
 
130
which signifies the credential is valid.  On error, it prints an error
 
131
message to stderr and returns a non-zero exit code.
130
132
 
131
133
.SH AUTHOR
132
134
@META_AUTHOR@
133
135
 
134
136
.SH COPYRIGHT
135
 
Copyright (C) 2007-2010 Lawrence Livermore National Security, LLC.
 
137
Copyright (C) 2007-2011 Lawrence Livermore National Security, LLC.
136
138
.br
137
139
Copyright (C) 2002-2007 The Regents of the University of California.
138
 
 
139
 
MUNGE is free software: you can redistribute it and/or modify it under
140
 
the terms of the GNU General Public License as published by the Free
141
 
Software Foundation, either version 3 of the License, or (at your option)
142
 
any later version.  Additionally for the MUNGE library (libmunge), you
143
 
can redistribute it and/or modify it under the terms of the GNU Lesser
144
 
General Public License as published by the Free Software Foundation,
145
 
either version 3 of the License, or (at your option) any later version.
 
140
.PP
 
141
MUNGE is free software: you can redistribute it and/or modify it under the
 
142
terms of the GNU General Public License as published by the Free Software
 
143
Foundation, either version 3 of the License, or (at your option) any later
 
144
version.
 
145
.PP
 
146
Additionally for the MUNGE library (libmunge), you can redistribute it
 
147
and/or modify it under the terms of the GNU Lesser General Public License as
 
148
published by the Free Software Foundation, either version 3 of the License,
 
149
or (at your option) any later version.
146
150
 
147
151
.SH "SEE ALSO"
148
152
.BR munge (1),
153
157
.BR munge (7),
154
158
.BR munged (8).
155
159
.PP
156
 
\fBhttp://home.gna.org/munge/\fR
 
160
\fBhttp://munge.googlecode.com/\fR