bos_adduser(8)

bos_adduser8

Adds a privileged user to the userlist file

Usage

bos adduser -server <machine name> -user <user names>+ [-cell <cell name>] [-noauth] [-localauth] [-help]

bos addu -s <machine name> -u <user names>+ [-c <cell name>] [-n] [-l] [-h]

Overview

The bos adduser command adds each user name specified with the -user argument to the /etc/openafs/server/UserList file on the machine named by the -server argument. It is the issuer's responsibility to verify that an entry for the user exists in the Authentication and Protection Databases.

Options

-server <machine name>

Indicates the server machine on which to change the /etc/openafs/server/UserList file. Identify the machine by IP address or its host name (either fully-qualified or abbreviated unambiguously). For details, see bos(8).

In cells that use the Update Server to distribute the contents of the /etc/openafs/server directory, it is conventional to specify only the system control machine as a value for the -server argument. Otherwise, repeat the command for each file server machine. For further discussion, see bos(8).

-user <user names>+

Specifies each user name to insert into the /etc/openafs/server/UserList file.

-cell <cell name>

Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see bos(8).

-noauth

Assigns the unprivileged identity "anonymous" to the issuer. Do not combine this flag with the -localauth flag. For more details, see bos(8).

-localauth

Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile or /etc/openafs/server/KeyFileExt file. The bos command interpreter presents the ticket to the BOS Server during mutual authentication. Do not combine this flag with the -cell or -noauth options. For more details, see bos(8).

-help

Prints the online help for this command. All other valid options are ignored.

Examples

The following command adds the user names "pat" and "smith" to the /etc/openafs/server/UserList file on the machine "fs1.example.com" (the system control machine).

   % bos adduser -server fs1.example.com -user pat smith

Privilege required

The issuer must be listed in the /etc/openafs/server/UserList file on the machine named by the -server argument, or must be logged onto a server machine as the local superuser "root" if the -localauth flag is included.

Releases

10 releases since Debian 4.0 (Etch); the text changed 9 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13

From openafs-client 1.8.13.2-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.