STLICENSE(1M)STLICENSE(1M)NAMEstlicense - server access control program for X
SYNOPSISstlicense [-v] [-fp directory] {-fn typeface | -pr product} [[+-]netdev
...]
DESCRIPTION
The stlicense program is run interactively by the font administrator to
give devices attached to hosts on the network, netdevs, access to type‐
faces. Responsibility for maintaining security rests with users root,
bin, and the owners of the font directories.
OPTIONSstlicense accepts the command line options described below.
-fp directory
The path of directories to search for the specified product or
typeface. The directories must have the suffix .st or they
will be ignored. 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
specified product or typeface. It will use that directory for
all of its operations. If no -fp option is specifies, 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 conve‐
nient 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 of 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 message listing
the valid options to stlicense will be printed.
+netdev The netdev is granted a license to the product or typeface
specified. Adding a product license to the netdev means adding
licenses to all of the typefaces which comprise the product.
The netdev 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 device, usually a
printer, is attached to the host. The name of the device must
be a valid file name.
Special host STSYSTEM refers to all nodes on the network; type‐
faces
licensed to STSYSTEM are available to every host. Special
device DISPLAYS refers to all servers running on the host. Spe‐
cial 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
netdev which already has a license for the product causes the
netdev's fonts.dir file to be updated with the current defini‐
tion of the product.
-netdev The license for specified typeface or product is removed from
this netdev.
netdev The products/typefaces licensed for this netdev are displayed.
If the -pr or -fn option is specified, stlicense reports
whether the specified product or typeface is licensed for this
netdev. In the case of typefaces, only those that have been
individually licensed with the -fn option (that is, not
licensed as part of a product with the -pr option) can be
queried by this option.
As with addition and removal of licenses, the host and device
portions of the netdev specification default to `hostname` and
DISPLAYS (respectively). So running stlicense without any
[+|-]netdev arguments is identical to specifying an argument of
`hostname`:DISPLAYS; licensing information is returned for
device DISPLAYS for the host on which stlicense is running.
FILES
This program updates the netdev's license files in the licenses subdi‐
rectory of the typeface directory (*.st). It creates and deletes
licensing files as necessary. If files for the netdev do not exist, it
creates them. Deleting the last license from a netdev will cause the
netdev's licensing files to be deleted.
Hosts have directories in licenses. Devices have directories within
their host's directory. Typefaces available to the netdev are stored
in fonts.dir. Product licenses issued to the netdev are stored in
products.dir.
The typefaces that comprise valid products are specified in the prod‐
ucts directory of typeface directories (*.st).
EXAMPLESstlicense-pr builtin +STSYSTEM:DISPLAYS
Licenses the Intellifont fonts contained in the product "builtin" (and
listed in /usr/lib/X11/fonts/ifo.st/products/builtin) for all displays.
stlicense-fp /usr/lib/X11/fonts/type1.st -pr builtin +STSYSTEM:DIS‐
PLAYS
Licenses the Type 1 fonts contained in the product "builtin" (and
listed in /usr/lib/X11/fonts/type1.st/products/builtin) for all dis‐
plays.
SEE ALSO
stload (1M), stmkfont(1), stconv(1M), stmkdirs(1)COPYRIGHT
Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
X Version 11 Release 5 STLICENSE(1M)