Initial import
[samba] / docs / manpages / smbspool.8
diff --git a/docs/manpages/smbspool.8 b/docs/manpages/smbspool.8
new file mode 100644 (file)
index 0000000..90c62ae
--- /dev/null
@@ -0,0 +1,107 @@
+.\"Generated by db2man.xsl. Don't modify this, modify the source.
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "SMBSPOOL" 8 "" "" ""
+.SH NAME
+smbspool \- send a print file to an SMB printer
+.SH "SYNOPSIS"
+.ad l
+.hy 0
+.HP 9
+\fBsmbspool\fR {job} {user} {title} {copies} {options} [filename]
+.ad
+.hy
+
+.SH "DESCRIPTION"
+
+.PP
+This tool is part of the \fBsamba\fR(7) suite\&.
+
+.PP
+smbspool is a very small print spooling program that sends a print file to an SMB printer\&. The command\-line arguments are position\-dependent for compatibility with the Common UNIX Printing System, but you can use smbspool with any printing system or from a program or script\&.
+
+.PP
+\fBDEVICE URI\fR
+
+.PP
+smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb"\&. This string can take a number of forms:
+
+.TP 3
+\(bu
+smb://server[:port]/printer
+.TP
+\(bu
+smb://workgroup/server[:port]/printer
+.TP
+\(bu
+smb://username:password@server[:port]/printer
+.TP
+\(bu
+smb://username:password@workgroup/server[:port]/printer
+.LP
+
+.PP
+smbspool tries to get the URI from the environment variable\fBDEVICE_URI\fR\&. If \fBDEVICE_URI\fR is not present, smbspool will use argv[0] if that starts with ``smb://'' or argv[1] if that is not the case\&.
+
+.PP
+Programs using the \fBexec(2)\fR functions can pass the URI in argv[0], while shell scripts must set the\fBDEVICE_URI\fR environment variable prior to running smbspool\&.
+
+.SH "OPTIONS"
+
+.TP 3
+\(bu
+The job argument (argv[1]) contains the job ID number and is presently not used by smbspool\&.
+.TP
+\(bu
+The user argument (argv[2]) contains the print user's name and is presently not used by smbspool\&.
+.TP
+\(bu
+The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job\&.
+.TP
+\(bu
+The copies argument (argv[4]) contains the number of copies to be printed of the named file\&. If no filename is provided then this argument is not used by smbspool\&.
+.TP
+\(bu
+The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool\&.
+.TP
+\(bu
+The filename argument (argv[6]) contains the name of the file to print\&. If this argument is not specified then the print file is read from the standard input\&.
+.LP
+
+.SH "VERSION"
+
+.PP
+This man page is correct for version 3\&.0 of the Samba suite\&.
+
+.SH "SEE ALSO"
+
+.PP
+\fBsmbd\fR(8) and \fBsamba\fR(7)\&.
+
+.SH "AUTHOR"
+
+.PP
+\fBsmbspool\fR was written by Michael Sweet at Easy Software Products\&.
+
+.PP
+The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.
+
+.PP
+The original Samba man pages were written by Karl Auer\&. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
+