NAME

       ippserver - a simple internet printing protocol server

SYNOPSIS

       ippserver  [  -2  ]  [ -M manufacturer ] [ -P ] [ -c command ] [ -d spool-directory ] [ -f
       type/subtype[,...]  ] [ -h ] [ -i iconfile.png ] [ -k ] [ -l location ] [ -m model ] [  -n
       hostname ] [ -p port ] [ -r subtype ] [ -s speed[,color-speed] ] [ -v[vvv] ] service-name

DESCRIPTION

       ippserver  is  a  simple  Internet  Printing  Protocol  (IPP) server conforming to the IPP
       Everywhere (PWG 5100.14) specification. It can be used to test client software or act as a
       very basic print server that runs a command for every job that is printed.

OPTIONS

       The following options are recognized by ippserver:

       -2   Report support for two-sided (duplex) printing.

       -M manufacturer
            Set the manufacturer of the printer.  The default is "Test".

       -P   Report support for PIN printing.

       -c command
            Run the specified command for each document that is printed.

       -d spool-directory
            Specifies  the  directory that will hold the print files.  The default is a directory
            under the user's current temporary directory.

       -f type/subtype[,...]
            Specifies a list of MIME media types that the server will  accept.   The  default  is
            "application/pdf,image/jpeg,image/pwg-raster".

       -h   Shows program help.

       -i iconfile.png
            Specifies the printer icon file for the server.  The default is "printer.png".

       -k   Keeps the print documents in the spool directory rather than deleting them.

       -l location
            Specifies  the  human-readable  location  string that is reported by the server.  The
            default is the empty string.

       -m model
            Specifies the model name of the printer.  The default is "Printer".

       -n hostname
            Specifies the hostname that is reported by the  server.   The  default  is  the  name
            returned by the hostname(1) command.

       -p port
            Specifies  the  port number to listen on.  The default is a user-specific number from
            8000 to 8999.

       -r subtype
            Specifies the Bonjour subtype(s) to advertise.  Separate  multiple  subtypes  with  a
            comma.  The default is "_print".

       -s speed[,color-speed]
            Specifies  the  printer  speed in pages per minute.  If two numbers are specified and
            the second number is greater than zero, the server  will  report  support  for  color
            printing.  The default is "10,0".

       -v[vvv]
            Be (very) verbose when logging activity to the standard output.

EXIT STATUS

       The  ippserver  program returns 1 if it is unable to process the command-line arguments or
       register the IPP service.  Otherwise ippserver will run continuously until terminated.

CONFORMING TO

       The ippserver program is unique to CUPS and conforms to the IPP Everywhere  (PWG  5100.14)
       specification.

ENVIRONMENT

       ippserver  adds  environment  variables starting with "IPP_" for all IPP Job attributes in
       the print request.  For example, when executing a command for an IPP  Job  containing  the
       "media"  Job  Template  attribute, the "IPP_MEDIA" environment variable will be set to the
       value of that attribute.

       Enumerated values are converted to their keyword  equivalents.   For  example,  a  "print-
       quality" Job Template attribute with a enum value of 3 will become the "IPP_PRINT_QUALITY"
       environment variable with a value of "draft".

EXAMPLES

       Run ippserver with a service name of My Cool Printer:

           ippserver "My Cool Printer"

       Run the file(1) command whenever a job is sent to the server:

           ippserver -c file "My Cool Printer"

SEE ALSO

       PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)

COPYRIGHT

       Copyright © 2007-2014 by Apple Inc.