summaryrefslogtreecommitdiffstats
path: root/src/man/kdestroy.1
diff options
context:
space:
mode:
Diffstat (limited to 'src/man/kdestroy.1')
-rw-r--r--src/man/kdestroy.1113
1 files changed, 113 insertions, 0 deletions
diff --git a/src/man/kdestroy.1 b/src/man/kdestroy.1
new file mode 100644
index 0000000000..9ca6264825
--- /dev/null
+++ b/src/man/kdestroy.1
@@ -0,0 +1,113 @@
+.TH "KDESTROY" "1" "January 06, 2012" "0.0.1" "MIT Kerberos"
+.SH NAME
+kdestroy \- destroy Kerberos tickets
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" Man page generated from reStructeredText.
+.
+.SH SYNOPSIS
+.INDENT 0.0
+.TP
+.B \fIkdestroy\fP
+.sp
+[\fB\-A\fP]
+[\fB\-q\fP]
+[\fB\-c\fP \fIcache_name\fP]
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The \fIkdestroy\fP utility destroys the user\(aqs active Kerberos
+authorization tickets by writing zeros to the specified
+credentials cache that contains them. If the credentials
+cache is not specified, the default credentials cache is destroyed.
+.SH OPTIONS
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B \fB\-A\fP
+.sp
+Destroys all caches in the collection, if a cache collection is
+available.
+.TP
+.B \fB\-q\fP
+.sp
+Run quietly. Normally \fIkdestroy\fP beeps if it fails to destroy the user\(aqs tickets.
+The \fI\-q\fP flag suppresses this behavior.
+.TP
+.B \fB\-c\fP \fIcache_name\fP
+.sp
+Use \fIcache_name\fP as the credentials (ticket) cache name and location;
+if this option is not used, the default cache name and location are used.
+.sp
+The default credentials cache may vary between systems.
+If the \fBKRB5CCNAME\fP environment variable is set, its
+value is used to name the default ticket cache.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SH NOTE
+.sp
+Most installations recommend that you place the \fIkdestroy\fP command in your \fI.logout\fP file,
+so that your tickets are destroyed automatically when you log out.
+.SH ENVIRONMENT
+.sp
+\fIkdestroy\fP uses the following environment variable:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B \fBKRB5CCNAME\fP
+.sp
+Location of the default Kerberos 5 credentials (ticket)
+cache, in the form \fItype\fP:\fIresidual\fP. If no type prefix is
+present, the \fBFILE\fP type is assumed. The type of the
+default cache may determine the availability of a cache
+collection; for instance, a default cache of type \fBDIR\fP
+causes caches within the directory to be present in the
+collection.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SH FILES
+.sp
+/tmp/krb5cc_[uid] \- Default location of Kerberos 5 credentials cache ([\fIuid\fP] is the decimal UID of the user).
+.SH SEE ALSO
+.sp
+kinit(1), klist(1)
+.SH BUGS
+.sp
+Only the tickets in the specified credentials cache are destroyed.
+Separate ticket caches are used to hold root instance and password changing tickets.
+These should probably be destroyed too, or all of a user\(aqs tickets kept in a single credentials cache.
+.SH AUTHOR
+MIT
+.SH COPYRIGHT
+2011, MIT
+.\" Generated by docutils manpage writer.
+.