STLICENSE(1M) UNIX Programmer's Manual STLICENSE(1M)
NAME
stlicense - server access control program for X
SYNOPSIS
stlicense [-v] [-fp directory] {-fn typeface | -pr product}
[[+-]device ...]
DESCRIPTION
The stlicense program is run interactively by the font
administrator to give devices access to typefaces. Respon-
sibility for maintaining security rests with users root, bin
, and the owners of the font directories.
OPTIONS
stlicense accepts the command line options described below.
-fp directory
The path of directories to search for the specified
product or typeface. If several directories are
specified, they are separated by the colon (":")
character. Stlicense will search the path until it
finds a directory that contains the the specified
product or typeface. It will use that directory for
all of its operations. If no -fp option is speci-
fies, the value of environment variable STPATH is
used. If neither -fp nor STPATH is present, the
default path is /usr/lib/X11/fonts/ifo.st.
-fn typeface
The typeface being licensed. It is specified as an
XLFD font name. The entire font name does not have
to be specified. The program will use the first
typeface whose name matches the name specified.
-pr product
Specifying a product instead of a typeface provides
a convenient way to license collections of
typefaces. Product names are established when
typefaces are loaded. Use either the -fn or the -pr
option, but never both. One of them must be present
for license additions or removals.
-v The verbose option controls the number messages
returned. By default, stlicense prints messages
only when a request could not be fulfilled. With
the verbose option, status messages are printed for
all licensing requests.
-help If this is the only option specified, a brief mes-
sage listing the valid options to stlicense will be
printed.
Printed 5/7/91 Release 4 1
STLICENSE(1M) UNIX Programmer's Manual STLICENSE(1M)
+device The device is granted a license to the product or
typeface specified. Adding a product license to the
device means adding licenses to all of the typefaces
which comprise the product. Typefaces licensed to
device STSYSTEM will be available to all devices.
The device is specified in the form host:device.
The host name is a node on the network. They can be
discless nodes, workstations, and the like. The dev-
ice, usually a printer, is attached to the host. The
name of the device must be a valid file name. Special
device DISPLAYS refers to all servers running on the
host. Special device PRINTERS refers to all printers
connected to the host.
The host defaults to the host on which stlicense is running.
The device defaults to DISPLAYS. Adding a product
license to a device which already has a license for the
product causes the device's fonts.dir file to be
updated with the current definition of the product.
-device The license for specified typeface or product is
removed from this device.
device The licenses for specified typeface or product are
displayed.
nothing If no devices are given, the list of devices that
have licenses for the typeface is printed on the
standard output.
FILES
This program updates the device's license files in the
licenses subdirectory of the typeface directory (*.st). It
creates and deletes licensing files as necessary. If files
for the device do not exist, it creates them. Deleting the
last license from a device will cause the device's licensing
files to be deleted.
Hosts have directories in licenses. Devices have directories
within their host's directory. Typefaces available to the
device are stored in fonts.dir. Licenses issued to the dev-
ice are stored in products.dir.
The typefaces that comprise valid products are specified in
the products directory of typeface directories (*.st).
SEE ALSO
stload (1M), stmkfont(1), stconv(1M), stmkdirs(1)
Printed 5/7/91 Release 4 2
STLICENSE(1M) UNIX Programmer's Manual STLICENSE(1M)
COPYRIGHT
Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
AUTHORS
Printed 5/7/91 Release 4 3