illumos-gate Sdiff usr/src/man/man4/mod

Print this page

2837 - remove print/lp* from gate and use CUPS from userland

   1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc.
   3 .\" All Rights Reserved.
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH MOD_IPP 4 "Nov 26, 2003"
   8 .SH NAME
   9 mod_ipp \- Embedded Internet Print Protocol (IPP) listener for the Apache HTTP
  10 server
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/usr/apache/libexec/mod_ipp.so\fR
  15 .fi
  16 
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBmod_ipp\fR module implements RFCs 2910 and 2911 to provide an IPP
  21 handling service for the Apache HTTP server. When loaded on the Apache server,
  22 \fBmod_ipp\fR processes all HTTP requests with MIME types of
  23 \fBapplication/ipp\fR. The \fBmod_ipp\fR module also processes additional
  24 configuration directives to enable or disable portions of the protocol support.
  25 .SS "Using Configuration Directives"
  26 .sp
  27 .LP
  28 The following is a list of configuration directives that apply to the Apache
  29 IPP Listening service:
  30 .RS +4
  31 .TP
  32 .ie t \(bu
  33 .el o
  34 ipp-conformance (\fIautomatic\fR|\fI1.0\fR|\fI1.1\fR)

 235 .na
 236 \fB\fBrequired\fR\fR
 237 .ad
 238 .RS 26n
 239 This is a place holder for enabling or disabling support for the required IPP
 240 operations implemented by the \fBmod_ipp\fR Apache module.
 241 .RE
 242 
 243 .SH EXAMPLES
 244 .LP
 245 \fBExample 1 \fRUsing a Configuration File to Start a Standalone Apache Server
 246 .sp
 247 .LP
 248 The following configuration file can be used to start a standalone Apache
 249 server to respond to IPP request sent to port 631.
 250 
 251 .sp
 252 .in +2
 253 .nf
 254 ServerType standalone
 255 ServerRoot "/usr/apache"
 256 PidFile /var/run/httpd-standalone-ipp.pid
 257 ErrorLog /var/lp/logs/ipp-errors
 258 
 259 Timeout 300
 260 KeepAlive On
 261 MaxKeepAliveRequests 100
 262 KeepAliveTimeout 15
 263 
 264 MinSpareServers 1
 265 MaxSpareServers 3
 266 StartServers 1
 267 MaxClients 150
 268 MaxRequestsPerChild 0
 269 
 270 LoadModule ipp_module libexec/mod_ipp.so
 271 
 272 ClearModuleList
 273 AddModule mod_ipp.c
 274 AddModule mod_so.c
 275

 374 job:
 375                  http://server[:port]/printers/{queue}/{job-id}
 376                  ipp://server[:port]/printers/{queue}/{job-id}
 377 .fi
 378 .in -2
 379 
 380 .sp
 381 .LP
 382 631 is the default IPP port and implied when the URI scheme is \fBipp\fR.
 383 However, some client implementations do not recognize the \fBipp\fR URI scheme
 384 and require \fBhttp://server:631/...\fR instead. For example, Microsoft's IPP
 385 client implementation does not recognize the \fBipp\fR scheme.
 386 .sp
 387 .LP
 388 In addition to the documentation and man pages included with Solaris, more
 389 information is available at http://www.apache.org
 390 .sp
 391 .LP
 392 The \fBhttpd\fR(8) man page and other Apache man pages are provided with the
 393 programming modules. To view the Apache manual pages with the man command, add
 394 \fB/usr/apache/man\fR to the \fBMANPATH\fR environment variable. See
 395 \fBman\fR(1) for  more information. Running \fBcatman\fR(1M) on the Apache
 396 manual pages is not supported.

   1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc.
   3 .\" All Rights Reserved.
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH MOD_IPP 4 "Nov 26, 2003"
   8 .SH NAME
   9 mod_ipp \- Embedded Internet Print Protocol (IPP) listener for the Apache HTTP
  10 server
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/usr/apache2/2.2/libexec/mod_ipp.so\fR
  15 .fi
  16 
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBmod_ipp\fR module implements RFCs 2910 and 2911 to provide an IPP
  21 handling service for the Apache HTTP server. When loaded on the Apache server,
  22 \fBmod_ipp\fR processes all HTTP requests with MIME types of
  23 \fBapplication/ipp\fR. The \fBmod_ipp\fR module also processes additional
  24 configuration directives to enable or disable portions of the protocol support.
  25 .SS "Using Configuration Directives"
  26 .sp
  27 .LP
  28 The following is a list of configuration directives that apply to the Apache
  29 IPP Listening service:
  30 .RS +4
  31 .TP
  32 .ie t \(bu
  33 .el o
  34 ipp-conformance (\fIautomatic\fR|\fI1.0\fR|\fI1.1\fR)

 235 .na
 236 \fB\fBrequired\fR\fR
 237 .ad
 238 .RS 26n
 239 This is a place holder for enabling or disabling support for the required IPP
 240 operations implemented by the \fBmod_ipp\fR Apache module.
 241 .RE
 242 
 243 .SH EXAMPLES
 244 .LP
 245 \fBExample 1 \fRUsing a Configuration File to Start a Standalone Apache Server
 246 .sp
 247 .LP
 248 The following configuration file can be used to start a standalone Apache
 249 server to respond to IPP request sent to port 631.
 250 
 251 .sp
 252 .in +2
 253 .nf
 254 ServerType standalone
 255 ServerRoot "/usr/apache2/2.2"
 256 PidFile /var/run/httpd-standalone-ipp.pid
 257 ErrorLog /var/lp/logs/ipp-errors
 258 
 259 Timeout 300
 260 KeepAlive On
 261 MaxKeepAliveRequests 100
 262 KeepAliveTimeout 15
 263 
 264 MinSpareServers 1
 265 MaxSpareServers 3
 266 StartServers 1
 267 MaxClients 150
 268 MaxRequestsPerChild 0
 269 
 270 LoadModule ipp_module libexec/mod_ipp.so
 271 
 272 ClearModuleList
 273 AddModule mod_ipp.c
 274 AddModule mod_so.c
 275

 374 job:
 375                  http://server[:port]/printers/{queue}/{job-id}
 376                  ipp://server[:port]/printers/{queue}/{job-id}
 377 .fi
 378 .in -2
 379 
 380 .sp
 381 .LP
 382 631 is the default IPP port and implied when the URI scheme is \fBipp\fR.
 383 However, some client implementations do not recognize the \fBipp\fR URI scheme
 384 and require \fBhttp://server:631/...\fR instead. For example, Microsoft's IPP
 385 client implementation does not recognize the \fBipp\fR scheme.
 386 .sp
 387 .LP
 388 In addition to the documentation and man pages included with Solaris, more
 389 information is available at http://www.apache.org
 390 .sp
 391 .LP
 392 The \fBhttpd\fR(8) man page and other Apache man pages are provided with the
 393 programming modules. To view the Apache manual pages with the man command, add
 394 \fB/usr/apache2/2.2/man\fR to the \fBMANPATH\fR environment variable. See
 395 \fBman\fR(1) for  more information. Running \fBcatman\fR(1M) on the Apache
 396 manual pages is not supported.