Lists the users, groups, and servers from an administrative list
Synopsis
bos lsadmin -server machine -adminlist filename [{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine that houses the administrative list whose principals and groups are to be displayed. The BOS Server on this machine executes
the command. Specify the machine's DCE path name, its host name, or its IP address.
-adminlist filename
Names the administrative list whose principals and groups are to be displayed. The complete path name is unnecessary if the list is stored in the
default configuration directory (dcelocal/var/dfs).
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. 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 lsadmin command lists the principal names of users and server machines and the names of groups found in the administrative list specified by the
-adminlist option on the server machine specified by the -server option. Principals whose names are specified in the administrative list or that are members of groups specified in
the list can issue administrative commands for the DFS server process associated with the list.
The default path for the 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.
Use the bos addadmin command to add principals and groups to an administrative list. Use the bos rmadmin command to remove principals and groups from an administrative list.
Privilege Required
No privileges are required.
Output
The command displays the output
Admin Users are:
followed by the principal name of each user and machine and the name of each group contained in the administrative list. Names from the local cell are displayed in an abbreviated form (for example, username for /.../cellname/username); names from foreign cells are displayed in full. Each name is preceded by one of the following strings:
user:
Precedes the principal name of each user or machine from the local cell
foreign_user:
Precedes the principal name of each user or machine from a foreign cell
group:
Precedes the name of each group from the local cell
foreign_group:
Precedes the name of each group from a foreign cell
Examples
The following command lists the members of the admin.bos file on the server machine named fs1. The administrative list contains two users, a server
machine, and two groups, all of which are from the local cell.
$ bos lsa -server /.../abc.com/hosts/fs1 -adminlist admin.bos
Admin Users are: user: jones, user: smith,
user: hosts/fs1/self, group: dfs-admin, group: fs1-admin
Related Information
Commands: bos addadmin(8dfs)
Files: admin.bak(4dfs)