.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "FS_NUKENFSCREDS 1"
.TH FS_NUKENFSCREDS 1 2024-03-20 OpenAFS "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
fs_nukenfscreds \- Discard NFS translator tokens
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBfs nukenfscreds\fR \fB\-addr\fR\ <\fIhost\fR>
    [\fB\-help\fR]
.PP
\&\fBfs nu\fR \fB\-a\fR\ <\fIhost\fR>
    [\fB\-h\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
When using the NFS translator, it is possible for clients to supply AFS tokens
that the NFS translator will use for NFS-originating accesses from a specific
host and uid. The \fBfs nukenfscreds\fR command, when run on the translator host,
will destroy all tokens for all uids for a specific NFS client host. After this
command is run successfully, all accesses for all users from that host will be
unauthenticated until they provide AFS tokens again.
.PP
This command can be useful in the following scenario. Say you have an NFS
client machine accessing a translator, and the machine is decommissioned, and a
new machine is brought up with the same IP. If there are credentials associated
with certain uids from that host, it is possible that accesses from the new
host will use the same credentials from the old host, even if they haven't
authenticated. With the \fBfs_nukenfscreds\fR command, you can destroy all
credentials associated with the machine when it is decommissioned, ensuring
that that situation cannot occur.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-addr\fR <\fIhost\fR>" 4
.IX Item "-addr <host>"
Specifies which host to invalidate tokens for. Specify either a resolvable host
name or an IP address.
.IP \fB\-help\fR 4
.IX Item "-help"
Prints the online help for this command. All other valid options are
ignored.
.SH OUTPUT
.IX Header "OUTPUT"
If the specified tokens were destroyed successfully, no output is generated.
.SH EXAMPLES
.IX Header "EXAMPLES"
The following example destroys credentials from all PAGs for the NFS translator
client host 198.51.100.20:
.PP
.Vb 1
\&   % fs nukenfscreds \-addr 198.51.100.20
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer must be logged in as the local superuser \f(CW\*(C`root\*(C'\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBfs_exportafs\fR\|(1),
\&\fBklog\fR\|(1),
\&\fBknfs\fR\|(1)
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2013 Sine Nomine Associates
.PP
This documentation is covered by the BSD License as written in the
doc/LICENSE file. This man page was written by Andrew Deason for
OpenAFS.