LICENSE.OPTIONS(5) — PUBLIC FILES, TABLES, AND TROFF MACROS

NAME

license.options − site administrator options file for FLEXlm licensed applications

SYNOPSIS

/var/flexlm/options/license.options

DESCRIPTION

The license.options 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 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 /var/adm/gsi.replog
RESERVE compile USER pat
RESERVE compile USER less
RESERVE compile HOST terry
NOLOG QUEUED

FILES