SaUsers(3tlib)

SaUsers: SaUsersGet, SaGroupsGet, SaGetPwEnts -- get data about users and groups on a specified host

Synopsis

SaUsersGet [host]
SaGroupsGet [host]
SaGetPwEnts [host]

Description

These functions provide access to data about users and groups on the specified host. They use the SCOadmin framework and the account Osa and are therefore capable of querying a remote host given the proper networking support.

SaUsersGet

returns a Tcl list of user names

SaGroupsGet

returns a Tcl list of group names

SaGetPwEnts

returns a list of keyed lists, one for each user on the system. Each list contains values for the following keys:

pw_name: user name
pw_uid: user ID
pw_gid: login group ID
pw_dir: home directory
pw_shell: login shell

Arguments

host: optional host name. Defaults to local host. Any host must be network accessible and must have the SCOadmin framework and account Osa installed.

Diagnostics

Errors will be thrown, along with a SCOadmin error stack. See ErrorCatch(3tlib). Possible errors are any that may be encountered performing and ObjectGet(3tlib) on the account Osa.

References

SaPrinter(3tlib), Object(3tlib).