]> git.ipfire.org Git - thirdparty/cups.git/blame - man/client.conf.man.in
More man page modernization.
[thirdparty/cups.git] / man / client.conf.man.in
CommitLineData
b423cd4c 1.\"
e4e5666b 2.\" "$Id$"
b423cd4c 3.\"
7131e285 4.\" client.conf man page for CUPS.
b423cd4c 5.\"
7131e285
MS
6.\" Copyright 2007-2014 by Apple Inc.
7.\" Copyright 2006 by Easy Software Products.
b423cd4c 8.\"
7131e285
MS
9.\" These coded instructions, statements, and computer programs are the
10.\" property of Apple Inc. and are protected by Federal copyright
11.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12.\" which should have been included with this file. If this file is
13.\" file is missing or damaged, see the license at "http://www.cups.org/".
b423cd4c 14.\"
7131e285 15.TH client.conf 5 "CUPS" "15 April 2014" "Apple Inc."
b423cd4c 16.SH NAME
7131e285 17client.conf \- client configuration file for cups (deprecated)
b423cd4c 18.SH DESCRIPTION
7131e285
MS
19The \fBclient.conf\fR file configures the CUPS client and is normally located in the \fI/etc/cups\fR and/or \fI~/.cups\fR directories.
20Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
21.LP
22\fBNote:\fR Starting with OS X 10.7, this file is only used by command-line and X11 applications.
23The \fBServerName\fR directive is not supported on OS X at all.
24.SS DIRECTIVES
25The following directives are understood by the client. Consult the online help for detailed descriptions:
b423cd4c 26.TP 5
7131e285 27\fBEncryption IfRequested\fR
b423cd4c 28.TP 5
7131e285 29\fBEncryption Never\fR
b423cd4c 30.TP 5
7131e285
MS
31\fBEncryption Required\fR
32Specifies the level of encryption that should be used.
b423cd4c 33.TP 5
7131e285
MS
34\fBGSSServiceName \fIname\fR
35Specifies the Kerberos service name that is used for authentication, typically "host", "http", or "ipp".
36CUPS adds the remote hostname ("name@server.example.com") for you. The default name is "http".
07ed0e9a 37.TP 5
7131e285 38\fBServerName \fIhostname-or-ip-address\fR[\fI:port\fR]
b423cd4c 39.TP 5
7131e285
MS
40\fBServerName \fI/domain/socket\fR
41Specifies the address and optionally the port to use when connecting to the server.
42\fBNote: This directive it not supported on OS X 10.7 or later.\fR
3e7fe0ca 43.TP 5
7131e285
MS
44\fBServerName \fIhostname-or-ip-address\fR[\fI:port\fR]\fB/version=1.1\fR
45Specifies the address and optionally the port to use when connecting to a server running CUPS 1.3.12 and earlier.
3699c637 46.TP 5
7131e285 47\fBUser \fIname\fR
3e7fe0ca 48Specifies the default user name to use for requests.
7131e285
MS
49.SH NOTES
50The \fBclient.conf\fR file is deprecated and will no longer be supported in a future version of CUPS.
b423cd4c 51.SH SEE ALSO
7131e285
MS
52.BR cups (1),
53CUPS Online Help (http://localhost:631/help)
b423cd4c 54.SH COPYRIGHT
7131e285 55Copyright \[co] 2007-2014 by Apple Inc.
b423cd4c 56.\"
e4e5666b 57.\" End of "$Id$".
b423cd4c 58.\"