Scroll to navigation

FS_NUKENFSCREDS(1) AFS Command Reference FS_NUKENFSCREDS(1)

NAME

fs_nukenfscreds - Discard NFS translator tokens

SYNOPSIS

fs nukenfscreds -addr <host>
[-help]

fs nu -a <host>
[-h]

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 fs nukenfscreds 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.

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 fs_nukenfscreds command, you can destroy all credentials associated with the machine when it is decommissioned, ensuring that that situation cannot occur.

OPTIONS

Specifies which host to invalidate tokens for. Specify either a resolvable host name or an IP address.
Prints the online help for this command. All other valid options are ignored.

OUTPUT

If the specified tokens were destroyed successfully, no output is generated.

EXAMPLES

The following example destroys credentials from all PAGs for the NFS translator client host 198.51.100.20:

   % fs nukenfscreds -addr 198.51.100.20

PRIVILEGE REQUIRED

The issuer must be logged in as the local superuser "root".

SEE ALSO

fs_exportafs(1), klog(1), knfs(1)

COPYRIGHT

Copyright 2013 Sine Nomine Associates

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.

2022-12-22 OpenAFS