Utilities in JRButils for Netware v16

T to Z

Tidyhome

Tidyhome cleans up home directories and resets them to a given status. It is ideal for managing sets of temporary accounts which are used for examinations or seminars, and for student accounts where all files are deleted periodically. Features include:

  • Can process individual users, users selected via wildcards, all members of a group, or a list of users in a file.
  • Can delete the contents of the home directory, retaining just the home directory itself.
  • The actual home directory can be deleted if required.
  • Can remove all extraneous trustee assignments which may have been created to grant rights to other users.
  • Can set the user’s trustee rights to a given value.
  • Can remove a directory quota or set it to a given value.
  • Can remove a volume quota or set it to a given value.

Trstlist

Trstlist displays trustee assignments for multiple objects, or for selected directories or files. Features include:

  • Can display trustees for files, directories, all directories in a tree, for an entire volume, or all volumes on a server.
  • Can process multiple files servers in a single command.
  • Can display trustees for a given path and each of its parent directories including the volume root.
  • Can display trustees for any class of object on any or all volumes.
  • Can display inherited rights filters.
  • Optional sorting by user, directory or rights.
  • Optional filtering by trustee rights e.g. trstlist can list only those trustees with supervisory rights.
  • Can list the trustee rights as settrust, rights or grant commands allowing them to be saved in a form in which they can be restored via a batch file.
  • Can optionally list the trustee rights as settrust, rights or remove commands allowing them to be saved in a form in which they can be removed via a batch file.
  • Can optionally list trustee rights for an object which are inherited through security equivalence. As a user is security equivalent to groups belonged to, this includes trustee rights inherited via group membership. Under NDS this includes trustees of each of the container objects forming the object’s distinguished name, plus [Public] and [Root]. Every object is security equivalent to each of its parent objects.
  • Can display only those files and/or directories without trustees.
  • Can display trustee assignments for all volume objects in an NDS tree.
  • Displays paths in the DOS or LONG name space.
  • Can produce comma delimited output with the fields and their order determined by the user.
  • Can display rights in Windows format e.g. RWXD.
  • Can display trustees as Windows cacls or icacls commands. An option is included to produce icacls commands granting non-propagated GR+GE rights to parent directories.

Userapps

Lists the ZEN application objects with which one or more users are associated. Features include:

  • Can list applications associated directly, via group objects, via container objects, or via all three.
  • Can list the object via which the association is made.
  • Optional sorting by user name.
  • Optional sorting of the associated applications.
  • Can include or exclude selected applications.
  • Can process users in the specified container and all containers below it.
  • Flexible output formatting options.
  • Can display only those associated applications which exist in a particular context.

Usercert

Usercert assists in the management of a user’s public key cryptography certificates. Usercert can do the following:

  • Create certificates with RSA and SHA1, RSA and MD2 or RSA and MD5 signing algorithms. The certificates “Valid from” and “Valid to” dates may be specified.
  • Delete individual or all certificates for each user.
  • List individual or all certificates for each user. Fields displayed are username, certificate name, status, vendor and size.
  • Extract all or selected certificates for each user, using a range of file naming conventions. The private key may be encrypted using the user’s eDir password or a specified password.

In addition to having the NetWare client installed, usercert requires five or six DLLs to run. They are listed below and can be found in the sys:ni\nis30\bin directory.

npkiapi.dll
npkit.dll
ntls.dll
sal.dll
dclient.dll
spmdclnt.dll for npkiapi.dll v3.0.0.0 onwards

Userdls

Userdls displays the GroupWise distribution lists to which users belong. It can also add users to distribution lists, and remove users from distribution lists. Its features include:

  • Can process objects by NDS name or GroupWise name.
  • Optional sorting of results by user name and/or distribution list.
  • Can specify the participation type when adding members.
  • Provides a convenient means of removing a user from all distribution lists without knowing in advance what lists the user belongs to.
  • Can modify user’s memberships using an input file containing both user names and distribution list name, one pair per line.
  • Flexible output formatting options similar to those of usergrps.

Usergrps

Usergrps lists the groups to which one or more users belong. Features include:

  • Optional sorting by user name.
  • Optional sorting of the groups belonged to.
  • Can include or exclude selected groups.
  • Can process users in the specified container and all containers below it.
  • Can display only those groups which exist in a particular context.
  • Very flexible output formatting options including the ability to list the results as grpadd and grpdel commands.

Users

Users displays information about logged in objects, and not-logged-in connections under all versions of NetWare. It has the following features:

  • Can list logged in objects across multiple servers. Wildcards may be used in server names, and servers may be excluded by preceding the name with ‘!’.
  • Can display not logged in connections.
  • Can select from 20 possible output fields and control the order of each field and its width. These fields are:

    Combined network and station address
    Connection number
    Connection status (licensed, unlicensed, bindery). This requires console operator rights.
    File locks held (NW 5.0 or later)
    Full name of the logged in object
    Location of the workstation
    Login date
    Login time
    Network address
    Object class
    Object ID
    Object name
    Period for which the object has been logged in
    Record locks held (NW 5.0 or later)
    Server name
    Server rights (normal, auditor, console, supervisor)
    Total NCP requests made since login *
    Total bytes read *
    Total bytes written *
    Workstation address

    * These fields are not available on OES Linux as the relevant API is not yet implemented. This is expected to change in OES2 SP1.

  • Can display where a user is logged in. This requires a text database mapping network addresses to locations. This file may also contain wildcard entries which are used when no exact match is found. This feature allows, for example, entries for different networks.
  • Can sort the output on any of the fields.
  • Can filter output on numerous fields.
  • Can display the total users logged in on each server.
  • Can show members of selected groups who are logged in.
  • Can set an error level equal to the number of matching logged in objects.
  • Can display connections for Z.E.N. workstation objects.
  • Can display connections based on the connection status (bindery, licensed, unlicensed).
  • Can display connections based on whether they are using the IPX or TCP/IP protocols, or AFP via native file access.
  • The GUI version can display the open files for each connection and can clear the connection.

Vol_info

Vol_info displays information for a single volume, volumes selected via wildcards, all volumes on a server, volumes across multiple servers, or volumes selected via the volume objects in NDS. A number of information summaries are available:

  • Attribute information including whether the volume is NSS or traditional, is read-only, has compression, suballocation, migration or auditing enabled, the name spaces loaded, and for NSS volumes, whether 64 bit file sizes are supported.
  • Volume block information including the block size, total blocks and blocks used, available, purged and purgeable.
  • Directory entry information including the number of blocks used, the percentage of the volume used by directory blocks, and the number of directory entries allocated, used and available.
  • Size information including the volume size, space used and available, the space usable (assuming usage cannot exceed 90% full) and the percentage used.
  • A detailed report including all of the above.
  • For NSS volumes under NW 6.x, a summary indicating whether salvage, compression, directory quotas, volume quotas, flush files immediately, modified file list, snapshot, shredding, transaction tracking and migration are enabled.
  • For NSS volumes under NW 6.x, a detailed report of NSS specific information including the attributes in the previous item, name spaces, pool, owner, GUID, state (mounted or dismounted) creation and as modified dates, salvage high and low water marks, whether the extended Mac name space is supported and enabled, whether the volume is shared and a cluster master or slave, and the total number of files and objects.

Wgrpadd

Wgrpadd is for use with workstation objects and workstation groups which are added to the NDS schema when Z.E.N.works is installed. Wgrpadd is a modified version of grpadd and has similar functionality allowing a single workstation object to be added to a workstation group, all members of another workstation group to be added, or a list of workstation objects in a file to be added.

Wgrpdel

Wgrpdel is for use with workstation objects and workstation groups which are added to the NDS schema when Z.E.N.works is installed. Wgrpdel is a modified version of grpdel and has similar functionality allowing a single workstation object to be removed from a workstation group, all members of another workstation group to be removed, or a list of workstation objects in a file to be removed.

Wgrplist

Wgrplist is for use with workstation objects and workstation groups which are added to the NDS schema when Z.E.N.works is installed. Wgrplist is a modified version of grplist and has similar functionality allowing listing of members of one or more workstation groups, and allowing the use of logical operators ‘and’, ‘or’ and ‘not’ to form an expression combining group names. This program can also display the user histories for workstation objects and the date and time that each entry was added.

Wgrpmemb

For use in a batch file to test if a workstation object is a member of a workstation group. It has similar functionality to grpmemb.

Whodidit

Whodidit displays selected information about files and directories which is useful in determining when they were created, modified, last accessed, archived and by whom. It can list any combination of the following fields:

Archiver - the object which last archived the file
Archive date and time
Attributes
Creation date and time
Cumulative usage. This is the physical size of the current file plus the sum of the sizes of all previously listed files.
DOS name
Extended attributes – number of
Extended attributes – total size
File or directory extension
Finder information for Mac files (command line versions only)
Inherited rights filter
Last access date and time
Logical size as shown by a ‘dir’ command or Explorer
LONG name
Mac name
NFS name
Owning name space
Owner
Physical size (for compressed or sparse files)
Quota (for directories)
Resource fork size for Macintosh files
Space used in a directory exclusive of subdirectories
Update date and time
Updater - the object which last updated the file

The user may select which of the above are to be displayed, in what order, and the width of the columns. Alternatively, a template file containing text and substitution identifiers may be given. This allows any combination of values to be given in any format and may be useful to create a batch file of commands incorporating file names. The output can be filtered on any value e.g. it is possible to display details of files greater than a certain size, files which are compressed, or all files and directories owned by a particular name space. Filters may be combined in a logical expression e.g. “(owner=John) and (size gt 100mb)”.

Whodidit has the ability to use a template file to format the output. The file can contain one or more lines of text and substitution identifiers representing informational items, the volume, path or file name, or any combination of these in any name space. This allows commands to be built for files or directories matching some filter criteria. For example, whodidit could scan a volume for files not accessed during the last 6 months and via the template file, a batch file could be created to copy these to some other location and then delete them.

Whodidit can save owners, updaters, archivers, creation, update and archive dates and times, last access dates, attributes and inherited rights filters, in a form suitable for input to setowner. This option may be useful if NDS is to be removed from a server and subsequently reinstated. All object IDs will change when NDS is reinstated with loss of this information which is stored as object IDs in the directory entry tables. Saving this information with whodidit allows it to be restored via setowner. This facility may also be used to restore ownership for files and directories copied using copy, xcopy and ncopy.

The fully GUI version also allows copying, deleting, renaming, and moving of files within the same volume. It also supports modification of many fields by right clicking on the appropriate column.

Whodidit can display file and directory information for both NetWare and Windows drives.

Wsgroups

Wsgroups lists the workstation groups to which one or more workstation objects belong. Features include:

  • Optional sorting by workstation name.
  • Optional sorting of the groups belonged to.
  • Can include or exclude selected workstation groups.
  • Can process objects in the specified container and all containers below it.
  • Can display only those groups which exist in a particular context.
  • Flexible output formatting options including the ability to list the results as wgrpadd and wgrpdel commands.