test/ippinfra.man

   1 .\"
   2 .\" ippinfra man page for CUPS.
   3 .\"
   4 .\" Copyright 2014 by Apple Inc.
   5 .\"
   6 .\" These coded instructions, statements, and computer programs are the
   7 .\" property of Apple Inc. and are protected by Federal copyright
   8 .\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
   9 .\" which should have been included with this file.  If this file is
  10 .\" file is missing or damaged, see the license at "http://www.cups.org/".
  11 .\"
  12 .TH ippinfra 1 "CUPS" "16 September 2014" "Apple Inc."
  13 .SH NAME
  14 ippinfra \- a simple ipp infrastructure server
  15 .SH SYNOPSIS
  16 .B ippinfra
  17 [
  18 .B \-d
  19 .I spool-directory
  20 ] [
  21 .B \-h
  22 ] [
  23 .B \-k
  24 ] [
  25 .B \-n
  26 .I hostname
  27 ] [
  28 .B \-p
  29 .I port
  30 ] [
  31 .B \-u
  32 .I username:password
  33 ] [
  34 .B \-v[vvv]
  35 ]
  36 .I service-name
  37 .SH DESCRIPTION
  38 .B ippinfra
  39 is a simple Internet Printing Protocol (IPP) infrastructure server conforming to the IPP Shared Infrastructure Extensions (INFRA) specification. It can be used as a very basic infrastructure server between standard IPP clients and IPP proxies conforming to the INFRA specification.
  40 .SH OPTIONS
  41 The following options are recognized by
  42 .B ippinfra:
  43 .TP 5
  44 \fB\-d \fIspool-directory\fR
  45 Specifies the directory that will hold the print files.
  46 The default is a directory under the user's current temporary directory.
  47 .TP 5
  48 .B \-h
  49 Shows program help.
  50 .TP 5
  51 .B \-k
  52 Keeps the print documents in the spool directory rather than deleting them.
  53 .TP 5
  54 \fB\-n \fIhostname\fR
  55 Specifies the hostname that is reported by the server.
  56 The default is the name returned by the
  57 .BR hostname (1)
  58 command.
  59 .TP 5
  60 \fB\-p \fIport\fR
  61 Specifies the port number to listen on.
  62 The default is a user-specific number from 8000 to 8999.
  63 .TP 5
  64 \fB\-u \fIusername:password\fR
  65 Specifies the username and password for the IPP proxy.
  66 The default is "test:test123".
  67 .TP 5
  68 .B \-v[vvv]
  69 Be (very) verbose when logging activity to the standard output.
  70 .SH EXIT STATUS
  71 The
  72 .B ippinfra
  73 program returns 1 if it is unable to process the command-line arguments.
  74 Otherwise
  75 .B ippinfra
  76 will run continuously until terminated.
  77 .SH CONFORMING TO
  78 The
  79 .B ippinfra
  80 program is unique to CUPS and conforms to the IPP Shared Infrastructure Extensions (INFRA) specification as an Infrastructure Printer.
  81 .SH EXAMPLES
  82 Run
  83 .B ippinfra
  84 with a service name of My Cool Printer:
  85 .nf
  86
  87     ippinfra "My Cool Printer"
  88 .fi
  89 .LP
  90 Specify a proxy username of "foo" and password of "bar":
  91 .nf
  92
  93     ippinfra \-u foo:bar "My Cool Printer"
  94 .fi
  95 .SH SEE ALSO
  96 PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)
  97 .SH COPYRIGHT
  98 Copyright \[co] 2007-2014 by Apple Inc.