STLICENSE(1M)															     STLICENSE(1M)

NAME

       stlicense - server access control program for X

SYNOPSIS

       stlicense [-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
       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.  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  pro-
	       gram 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 estab-
	       lished 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; typefaces
	      licensed to STSYSTEM are available to every host.  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 netdev which already has a license for the product causes the net-
	      dev's fonts.dir file to be updated with the current definition 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  DIS-
	       PLAYS  (respectively).	So  running  stlicense	without any [+|-]netdev arguments is identical to specifying an argument of `host-
	       name`: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 subdirectory 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 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 dis-
       plays.

       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.

X Version 11							     Release 5							     STLICENSE(1M)