Adds a user, group, or server to an administrative list
Synopsis
bos addadmin -server machine -adminlist filename [-principal name...] [-group name...]
[-createlist] [{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine that houses the administrative list to which principals, groups, or both are to be added. The BOS Server on this machine
executes the command. To run this command using a privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the
equivalent of running the command with the -noauth option), specify the machine's host name or IP address.
-adminlist filename
Names the administrative list to which principals, groups, or both are to be added. The complete path name is unnecessary if the list is stored in
the default configuration directory (dcelocal/var/dfs).
-principal name
Specifies the principal name of each user or server machine to be added to the administrative list. A user from the local cell can be specified by a
full or abbreviated principal name (for example, /.../cellname/username or just username); a user from a foreign cell can be specified only by a
full principal name. A server machine from the local cell can be specified by a full or abbreviated principal name (for example,
/.../cellname/hosts/hostname/self or just hosts/hostname/self); a server machine from a foreign cell can be specified only by a
full principal name.
-group name
Specifies the name of each group to be added to the administrative list. A group from the local cell can be specified by a full or abbreviated group name
(for example, /.../cellname/group_name or just group_name); a group from a foreign cell can be specified only by a full group name.
-createlist
Specifies that the file indicated with -adminlist is to be created if it is not found. Any principals or groups specified with the command are added to the
new file; if no principals or groups are specified, the command creates an empty file. This option has no effect if the specified file already exists.
Note: Because the admin.bos list must already exist to issue this command, this option is ignored if admin.bos is specified with the -adminlist option.
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. The command fails if you use this option and DFS
authorization checking is not disabled on the machine specified by -server. If you use this option, do not use the -localauth option.
-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bos addadmin command adds the specified users, groups, and servers to the administrative list specified by the -adminlist option on the server
machine indicated by the -server option. The principal (login) names of users and the principal names of server machines to be added to the administrative list are specified with the
-principal option; the names of groups to be added to the list are specified with the -group option. Principals added to the administrative list either directly (with the
-principal option) or indirectly (as members of groups indicated with the -group option) can then issue administrative commands for the DFS server process associated with the list.
The default path for administrative lists is the configuration directory (dcelocal/var/dfs). If the specified list is stored in the default directory, only the specific file name is required. If the specified list is stored elsewhere, the path name to the file that was used when the associated server process was started is required.
Privilege Required
The issuer must be listed in the admin.bos file on the machine specified by -server.
Examples
The following command adds the user names jones and smith to the admin.bos file on fs1. The administrative list is stored in the
default configuration directory.
$ bos adda -server /.../abc.com/hosts/fs1 -adminlist admin.bos -principal jones smith
Related Information
Commands: bos lsadmin(8dfs)
Files: admin.bak(4dfs)