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.
|