NAME

bos lsadmin − 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 pathname, its host name, or its IP address.

−adminlist filename
Names the administrative list whose principals and groups are to be displayed. The complete pathname is unnecessary if the list is stored in the default configuration directory (dcelocal/var/dfs).

−noauthDirects 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. 

−localauthDirects 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. 

−helpPrints 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 filename is required. If the specified list is stored elsewhere, the pathname 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(1m), bos rmadmin(1m) Files: admin.bak(4), admin.bos(4), admin.fl(4), admin.ft(4), admin.up(4)

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5