usermond(1M)                   DG/UX R4.11MU05                  usermond(1M)


NAME
       usermond - license server

SYNOPSIS
       usermond [ -t time ] [ -f frequency ] [ -d ] [ -x username ]

DESCRIPTION
       Usermond writes license and user count information to a binary data
       file, /var/license/.licensedata.  This information is used by
       commands such as login(1) to determine if a user is to be granted
       access to a system.  If the user count written exceeds the license
       then users may not be able to login to the system.  In addition, if
       the number of users exceeds the license purchased, a log entry is
       made in /var/license/usermon.log, syslog(3C) is called to make a
       system log entry,  and a mail message is sent to the user root.

       The data written to the data file includes such things as the process
       id of usermond, the license, the user count, and a userid for each
       user counted.

   Options
       -t time   Specifies how long to wait (in minutes) between counting
                 the number of users on the system and writing license data
                 to the data file.  The minimum value for time is 5 minutes
                 and the maximum is 60 minutes.  By default, the time is 15
                 minutes.

       -f frequency
                 Specifies the notification frequency which is how many
                 times to count the users before making a log entry in
                 /var/license/usermon.log and sending mail to root.  By
                 default the frequency is 4.  Thus by default, mail will be
                 sent to root once every hour (since the default time is 15
                 minutes) if the user count exceeds the license.  If the
                 user count exceeds the license for any one of the 4 times
                 the count is taken in an hour, mail will be sent to root
                 (note that this example uses the default values for both
                 the time and frequency).

       -d        Tells usermond to enter debug mode.  When the -d switch is
                 used, usermond will not fork(2) to put itself in the
                 background.  This enables usermond to be debugged and
                 allows an inittab(4) entry to have init(1M) start usermond.
                 Do not remove the -d switch from the usermond command line
                 in /etc/inittab.  Removal of this switch will not improve
                 performance, it will cause many copies of usermond to be
                 started by init(1M).

       -x username
                 Exempt user.  Allows the system administrator to choose one
                 user by name who will be exempt from license enforcement.
                 On generic DG/UX systems, the default exempt user is
                 sysadm. On systems with DG/UX information security, the
                 default exempt user is proto.  The -x switch is primarily
                 used on DG/UX systems with information security, which do
                 not allow users to log in as sysadm, root, or any
                 administrative role.  Use the -x switch on such systems to
                 change the exempt user to something other than proto.  The
                 username argument will recognize only the first 32
                 characters given.  A username longer than 32 characters is
                 allowed but only the first 32 characters will be used.

FILES
       /var/license/.licensedata
                 Data file to which usermond(1M) writes license data.

       /var/license/usermon.log
                 Log file for usermond.

       /etc/license.dat
                 Configuration file for usermond.

       /etc/inittab
                 Script for init(1M).

       /etc/utmp

DIAGNOSTICS
   Exit Codes
        1     There was an error in the command line.

        2     The operation failed because /etc/userlicense.dat could not be
              edited.

        4     The program was executed by a user who does not have
              appropriate privilege (see NOTES, below).

        5     The program was unable to create an independent server.

SEE ALSO
       admuserlicense(1M), admlicense(1M), utmp(4), userlicense.dat(4M),
       init(1M), f4appropriate_privilege(5).

NOTES
       In order to make full use of the license purchased, usermond must be
       running.  If it is not, your license will be set to 2 users and
       access to your system will be restricted to 2 users.  What this means
       is that when usermond is not running that new users will not be
       allowed login if 2 or more users are already logged into the system.

       Do not remove the -d switch from the usermond command line in
       /etc/inittab.  This will cause init(1M) to start many copies of
       usermond and may greatly degrade system performance.

       On a generic DG/UX system, appropriate privilege is granted by having
       an effective UID of 0 (root). See the appropriateprivilege(5) man
       page for more information.

       On a system with DG/UX information security, appropriate privilege is
       granted by having one or more specific capabilities enabled in the
       effective capability set of the user.  See the capdefaults(5) man
       page for more information.



Licensed material--property of copyright holder(s)