dtprinter(1M)                                          dtprinter(1M)


       NAME
             dtprinter - add an entry to the UnixWare Desktop printer table

       SYNOPSIS
             dtprinter -a [-o] file . . .
             dtprinter -d entry . . .

       DESCRIPTION
             The dtprinter command adds or deletes an entry to the printer
             table.  The printer table is used by the UnixWare Desktop
             Printer Setup application to prompt users on the printer they
             want to use.

             -a    add entries in file, to the printer table

             -o    overwrite existing entries of the same name

             -d entry
                   remove entry from the printer table

             A printer table entry contains the following lines, of which
             only entry and name are required:

                   entry:EntryName
                   name:PrinterName[^CatalogFile:Index]
                   terminfo:Terminfo Name
                   interface:Interface Program Name
                   contents:list of content types
                   stty:stty argument list
                   modules:streams module names

             entry tag used to reference the entry

             name  name of printer presented to user.  Note that
                   [CatalogFile:Index:] translates PrinterName.
                   CatalogFile is the file of locale specific translations.
                   index is the line number of the translation.

             terminfo
                   terminfo name of printer.  This may be a comma-separated
                   list.  The default is unknown.

             interface
                   program to use with the printer.  This may be an
                   absolute path or a path that is relative to the LP model
                   directory, that is /usr/lib/lp/model.  The standard


                           Copyright 1994 Novell, Inc.               Page 1

      dtprinter(1M)                                          dtprinter(1M)


                  interface supplied with LP is the default.

            contents
                  comma separated list of types of files the printer can
                  support.  For example, simple for simple ASCII text (the
                  default) and PS for postscript input.

            stty  any stty options needed when initializing the printer.
                  The default is ``''.

            modules
                  comma separated list of all streams modules to be pushed
                  when the printer is initialized.  The default is the
                  users default modules.

         Environment
            The dtprinter command uses the XWINHOME environment variable
            to locate printer tables.  The default value of XWINHOME is
            /usr/X, so /usr/X/desktop/PrintMgr/Printers will be searched.

         Files
            $XWINHOME/desktop/PrintMgr/Printers
            /usr/X/desktop/PrintMgr/Printers

         Exit Codes
            The dtprinter command returns

            0     success

            1     usage error

            2     format error

            3     item exists and -o not specified

            4     cannot read/write file

            5     no memory

      USAGE
            dtprinter resides in /usr/X/adm.  Since the PATH environment
            variable does not normally include that directory, either
            specify the full pathname or add /usr/X/adm to the PATH
            variable.




                          Copyright 1994 Novell, Inc.               Page 2

       dtprinter(1M)                                          dtprinter(1M)


             All streams modules listed under modules are assumed to
             already have been built into the kernel.  This is most likely
             to occur during installation of the printer package.

          Examples
             The example shows an entry for an HP Laser Jet:

                   entry:HPlaser
                   name:HP Laser Jet
                   terminfo:hplaserjet
                   contents:simple

       REFERENCES
             dtfilter(1M), dttypes(1M), lp(1), lpfilter(1M)


































                           Copyright 1994 Novell, Inc.               Page 3