LOCAL.OPTION(1M) UNIX 5.0 (9 November 1990) LOCAL.OPTION(1M)
NAME
local.option - site administrator options file for FLEXlm
licensed applications
SYNOPSIS
/usr/local/flexlm/licenses/local.option
DESCRIPTION
The local.option file contains optional information supplied
by the system administrator at the end-user site. This
information can be used to tailor the behavior of the
license daemons. The options file can contain the following
information:
reserved license information
logfile control options
license timeout control
Lines beginning with an octothorp (#) are ignored, and can
be used as comments.
There is no default location or name for the options file;
it is only active if it has been specified in the
license.dat file as the fourth argument on the DAEMON line.
Note that if there are multiple DAEMON lines in the
license.dat file, then there can be multiple options files,
one for each DAEMON line. Not all of the lines in an
options file refer to a feature, so the site administrator
MUST set up separate options files in order to use the NOLOG
and REPORTLOG features.
Each line in the options file starts with a keyword which
identifies the information on that line. The keyword is one
of RESERVE, NOLOG, GROUP, INCLUDE, EXCLUDE, TIMEOUT, or
REPORTLOG.
The RESERVE line is of the form
RESERVE numlic feature {USER|HOST|DISPLAY|GROUP} name
The RESERVE command reserves the specified number of
licenses for the specified user, host, display, or group.
Note that reserving a license decreases the number of
generally available licenses.
The NOLOG line is of the form
NOLOG {IN|OUT|DENIED|QUEUED}
NOLOG causes messages of the specified type to be filtered
out of the daemon's log file. Specifying a NOLOG option
will reduce the amount of output to the log file, which can
Page 1 FLEXlm V2.0
LOCAL.OPTION(1M) UNIX 5.0 (9 November 1990) LOCAL.OPTION(1M)
be useful in those cases where the log file grows too
quickly.
The GROUP line is of the form
GROUP group-name member-list
The GROUP command is used to define collections of users,
which can then be used in RESERVE, INCLUDE, or EXCLUDE
commands.
The INCLUDE and EXCLUDE commands are of the form
{INCLUDE|EXCLUDE} feature {USER|HOST|DISPLAY|GROUP} name
INCLUDE and EXCLUDE are used to specify which users (or
hosts, displays, or groups) are allowed to use a particular
feature. Any user who is EXCLUDEd from a feature will not
be able to use that feature. Specifying an INCLUDE line has
the effect of excluding everyone else from that feature;
thus, only those users specifically INCLUDEd will be able to
use that feature.
The TIMEOUT line is of the form
TIMEOUT feature idletime
The TIMEOUT command is used to set up a minimum idle time
after which a user will lose his license if he is not using
it. This allows the site administrator to prevent users
from wasting a license (by keeping it checked out when they
are not using it) when someone else wants a license.
The REPORTLOG line is of the form
REPORTLOG filename
REPORTLOG tells the daemon that it should create a log file
suitable for use with the FLEXlm report writing tools. This
log file maintains more detailed information than the
standard log file, but is not meant to be human readable.
If the filename starts with a plus character (+), the file
will be opened in append mode.
EXAMPLE
Here is an example of an options file.
REPORTLOG /usr/adm/gsi.replog
RESERVE compile USER pat
RESERVE compile USER less
RESERVE compile HOST terry
NOLOG QUEUED
Page 2 FLEXlm V2.0
LOCAL.OPTION(1M) UNIX 5.0 (9 November 1990) LOCAL.OPTION(1M)
FILES
/usr/local/flexlm/licenses/local.option
SEE ALSO
licensedat(1M)
Page 3 FLEXlm V2.0