.\" Copyright 2013-2014 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 2014-04-16 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
path to Google account ident data (default \fI~/.cloudprintauth\fP). The format of the file is not public.
.TP
\fB\-c\fR
establish credentials to the service, then exit.
.TP
\fB\-d\fR
run in daemon mode.
.TP
\fB\-f\fR
fast poll, if notifications aren't working.
.TP
\fB\-i\fR \fIregexp\fR
include local printers matching regular expression from the start of the printer name.
.TP
\fB\-l\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
path to PID file in daemon mode (default \fIcloudprint.pid\fP).
.TP
\fB\-u\fR
store username/password in addition to login token to avoid authentication expiration.
.TP
\fB\-v\fR
verbose logging.
.TP
\fB\-x\fR \fIregexp\fR
exclude local printers matching regular expression from the start of the printer name.
.TP
\fB\-h\fR
display help
.PP
\fBcloudprint\fR will prompt for a username and password if the information has not been provided.

If two-factor authentication is enabled for the account, then an application-specific password must be used.

.SH FILES
.TP
\fI~/.cloudprintauth\fR
Default location for storing account authentication credentials
.TP
\fI~/.cloudprintauth.sasl\fR
Default location for storing internal authentication tokens

.SH SEE ALSO
.BR cloudprint-service(7), cloudprintd(8), cloudprint(1)