.\" Copyright 2013-2015 David Steele <dsteele@gmail.com>
.\" This file is part of cloudprint
.\" Available under the terms of the GNU General Public License version 2 or later
.TH cloudprint 1 2015-11-14 Linux "User Commands"
.SH NAME
cloudprint \- share CUPS printers with Google Cloud Print

.SH SYNOPSIS
\fBcloudprint\fP [\fIOPTION\fP]...

.SH DESCRIPTION
The \fBcloudprint\fP script makes locally-defined CUPS printers available to
a Google account, enabling local or remote printing from such services as
the Chrome browser, Chrome OS devices, or Android devices.

This is a lower-level command. Cloud Print services would normally be managed
through the cloudprint service.

The cloudprint utility is linked as cloudprintd for the cloudprint-service
package.

.SH OPTIONS
.TP
\fB\-a\fR \fI<account_file>\fR, \fB\-\-account_file\fR \fI<account_file>\fR
path to Google account ident data (default \fI~/.cloudprintauth.json\fP).
.TP
\fB\-c\fR, \fB\-\-credentials\fR
establish credentials to the service, then exit.
.TP
\fB\-d\fR, \fB\-\-daemon\fR
run in daemon mode.
.TP
\fB\-f\fR, \fB\-\-fastpoll\fR
fast poll, if notifications aren't working.
.TP
\fB\-i\fR \fIregexp\fR, \fB\-\-include\fR \fIregexp\fR
include local printers matching regular expression from the start of the printer name.
.TP
\fB\-l\fR, \fB\-\-logout\fR
log out of the Google account. This deletes the account identification file, requiring reauthentication the next time
cloudprint is run.
.TP
\fB\-p\fR \fI<pid_file>\fR, \fB\-\-pidfile\fR \fI<pid_file>\fR
path to PID file in daemon mode (default \fIcloudprint.pid\fP).
.TP
.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbose logging.
.TP
\fB\-x\fR \fIregexp\fR, \fB\-\-exclude\fR \fIregexp\fR
exclude local printers matching regular expression from the start of the printer name.
.TP
\fB\-s\fR \fIsitename\fR, \fB\-\-sitename\fR \fIsitename\fR
define a site name to be prepended to all printer names.
.TP
\fB\-\-syslog-address\fR \fISYSLOG_ADDRESS\fR
syslog address to use in daemon mode (default \fIstdout\fR).
.TP
\fB\-h\fR, \fB\-\-help\fR
display help
.PP
\fBcloudprint\fR will provide a URL to claim the printer, if credentials have not
been established.


.SH FILES
.TP
\fI~/.cloudprintauth\fR
Default location for storing account authentication credentials
.TP
\fI/etc/cloudprint.conf\fR, \fI~/.cloudprint.conf\fR
Configuration file containing additional command-line parameters for \fBcloudprint\fR.

.SH SEE ALSO
.BR cloudprint-service(7), cps-auth(1)