vitalnix user management suite 3.2.0


Name

vxgroupbld -- build system groups from VX group tags

Syntax

vxgroupbld [-qv] [--vxdb database] [-G group] [-p prefix]

Description

vxgroupbld updates the system (UNIX) group membership of all users that have a Vitalnix group tag, and moves them from their current Vitalnix-UNIX-Group (VUG) to the new VUG that matches the Vitalnix group tag. vxgroupbld will create the new VUG if necessary. The VUGs can then be used for filesystem permissions, for example.

VUGs are generally prefixed with a fixed string so as to distinguish them from regular UNIX groups. The default prefix is vg-, which allows the Vitalnix group to start with a number. For example, if it was 10NK, the VUG would be called vg-10NK. NOTE: Using a potentially ambiguous or no prefix will obviously cause users to lose membership in secondary groups, because vxgroupbld operates on all secondary groups that have this prefix.

vxgroupbld is typically used after updating the Vitalnix group tag; running it after vxusersync is a common case, e.g. when students move up one grade.

Options

--vxdb database Uses the specified database rather than the default one defined in the VXDB configuration file.
-G group Only operate on users which have group as their primary group. This can either be a group's name or its GID.
-p prefix Prefix to use for VUGs. The default is vg-.
-q Quiet operation. This is the default.
-v Verbose operation. This will print progress information messages every second.

Exit status

vxgroupbld will return 0 if all operations completed successfully. On error, it will abort right away and returns non-zero.