source: branches/samba-3.0/docs/manpages/smbspool.8@ 104

Last change on this file since 104 was 44, checked in by Paul Smedley, 18 years ago

Update source to 3.0.25b

File size: 3.2 KB
Line 
1.\"Generated by db2man.xsl. Don't modify this, modify the source.
2.de Sh \" Subsection
3.br
4.if t .Sp
5.ne 5
6.PP
7\fB\\$1\fR
8.PP
9..
10.de Sp \" Vertical space (when we can't use .PP)
11.if t .sp .5v
12.if n .sp
13..
14.de Ip \" List item
15.br
16.ie \\n(.$>=3 .ne \\$3
17.el .ne 3
18.IP "\\$1" \\$2
19..
20.TH "SMBSPOOL" 8 "" "" ""
21.SH "NAME"
22smbspool - send a print file to an SMB printer
23.SH "SYNOPSIS"
24.HP 1
25smbspool {job} {user} {title} {copies} {options} [filename]
26.SH "DESCRIPTION"
27.PP
28This tool is part of the
29\fBsamba\fR(7)
30suite.
31.PP
32smbspool 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.
33.PP
34\fBDEVICE URI\fR
35.PP
36smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb". This string can take a number of forms:
37.TP 3n
38\(bu
39smb://server[:port]/printer
40.TP 3n
41\(bu
42smb://workgroup/server[:port]/printer
43.TP 3n
44\(bu
45smb://username:password@server[:port]/printer
46.TP 3n
47\(bu
48smb://username:password@workgroup/server[:port]/printer
49.PP
50smbspool tries to get the URI from the environment variable
51\fBDEVICE_URI\fR. If
52\fBDEVICE_URI\fR
53is not present, smbspool will use argv[0] if that starts with
54\fBsmb://\fR
55or argv[1] if that is not the case.
56.PP
57Programs using the
58exec(2)
59functions can pass the URI in argv[0], while shell scripts must set the
60\fBDEVICE_URI\fR
61environment variable prior to running smbspool.
62.SH "OPTIONS"
63.TP 3n
64\(bu
65The job argument (argv[1]) contains the job ID number and is presently not used by smbspool.
66.TP 3n
67\(bu
68The user argument (argv[2]) contains the print user's name and is presently not used by smbspool.
69.TP 3n
70\(bu
71The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job.
72.TP 3n
73\(bu
74The 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.
75.TP 3n
76\(bu
77The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool.
78.TP 3n
79\(bu
80The 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.
81.SH "VERSION"
82.PP
83This man page is correct for version 3.0 of the Samba suite.
84.SH "SEE ALSO"
85.PP
86\fBsmbd\fR(8)
87and
88\fBsamba\fR(7).
89.SH "AUTHOR"
90.PP
91smbspool
92was written by Michael Sweet at Easy Software Products.
93.PP
94The 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.
95.PP
96The 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
97ftp://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.
98
Note: See TracBrowser for help on using the repository browser.