forked from pool/cups-airprint
51 lines
1.7 KiB
Groff
51 lines
1.7 KiB
Groff
|
.TH airprint-generate.py 8 "January 2016" "cups-airprint" "System Administration"
|
||
|
|
||
|
.SH NAME
|
||
|
airprint-generate.py - create Avahi service files for shared CUPS printers
|
||
|
.SH SYNOPSIS
|
||
|
.B airprint-generate.py
|
||
|
.I [options]
|
||
|
.SH DESCRIPTION
|
||
|
This script will connect to a CUPS server and, for each printer configured and
|
||
|
marked as shared, it will generate a .service file for Avahi that is compatible
|
||
|
with Apple's AirPrint announcements. Any printer that can be configured to work
|
||
|
with CUPS can be used. Printers should not be configured in CUPS as raw, unless
|
||
|
the printer can natively print PDF; that is, CUPS needs to already be
|
||
|
configured with a PDF filter.
|
||
|
.SH OPTIONS
|
||
|
.TP
|
||
|
.BR \-h ", " \-\-help
|
||
|
show this help message and exit
|
||
|
.TP
|
||
|
.BR \-H " " \fIHOSTNAME\fR ", " \-\-host =\fIHOSTNAME\fR
|
||
|
Hostname of CUPS server
|
||
|
.TP
|
||
|
.BR \-P " " \fIPORT\fR ", " \-\-port =\fIPORT\fR
|
||
|
Port number of CUPS server
|
||
|
.TP
|
||
|
.BR \-u " " \fIUSER\fR, \-\-user =\fIUSER\fR
|
||
|
Username to authenticate with against CUPS
|
||
|
.TP
|
||
|
.BR \-d " " \fIDIRECTORY\fR ", " \-\-directory =\fIDIRECTORY\fR
|
||
|
Directory in which service files are created
|
||
|
.TP
|
||
|
.BR \-v ", " \-\-verbose
|
||
|
Print debugging information to STDERR
|
||
|
.TP
|
||
|
.BR \-p " " \fIPREFIX\fR, \-\-prefix =\fIPREFIX\fR
|
||
|
Prefix all files with this string
|
||
|
.SH REMARKS
|
||
|
DNSSD has a limit of 255 characters for a given txt-record; because of this,
|
||
|
the list of accepted PDLs will be truncated to fit. If you're curious to see
|
||
|
which ones are trimmed out of the list, run the script with the verbose flag.
|
||
|
|
||
|
If
|
||
|
.I python-lxml
|
||
|
is installed, .service files will be generated in a human readble format (I
|
||
|
wasn't able to get minidom's version to work acceptably).
|
||
|
.SH AUTHOR
|
||
|
Timothy J. Fontaine <tjfontaine@gmail.com> wrote the
|
||
|
.B airprint-generate.py
|
||
|
script.
|
||
|
|