Release 5

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.  Responsibility 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 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 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 message listing the valid options to stlicense will be printed. 

+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 device, 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 device are stored in products.dir. 

The typefaces that comprise valid products are specified in the products directory of typeface directories (*.st). 

EXAMPLES

stlicense -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:DISPLAYS Licenses the Type 1 fonts contained in the product "builtin" (and listed in /usr/lib/X11/fonts/type1.st/products/builtin) for all displays.

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. 

Hewlett-Packard Company  —  HP-UX 9.0 August 1992