syncing up with SAMBA_2_2
[Samba/gbeck.git] / docs / htmldocs / smbspool.8.html
blobf689b4a0bce3c8189a19323d5c3621b50e773861
1 <HTML
2 ><HEAD
3 ><TITLE
4 >smbspool</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
8 ><BODY
9 CLASS="REFENTRY"
10 BGCOLOR="#FFFFFF"
11 TEXT="#000000"
12 LINK="#0000FF"
13 VLINK="#840084"
14 ALINK="#0000FF"
15 ><H1
16 ><A
17 NAME="SMBSPOOL"
18 >smbspool</A
19 ></H1
20 ><DIV
21 CLASS="REFNAMEDIV"
22 ><A
23 NAME="AEN5"
24 ></A
25 ><H2
26 >Name</H2
27 >smbspool&nbsp;--&nbsp;send print file to an SMB printer</DIV
28 ><DIV
29 CLASS="REFSYNOPSISDIV"
30 ><A
31 NAME="AEN8"
32 ></A
33 ><H2
34 >Synopsis</H2
35 ><P
36 ><B
37 CLASS="COMMAND"
38 >smbspool</B
39 > [job] [user] [title] [copies] [options] [filename]</P
40 ></DIV
41 ><DIV
42 CLASS="REFSECT1"
43 ><A
44 NAME="AEN17"
45 ></A
46 ><H2
47 >DESCRIPTION</H2
48 ><P
49 >This tool is part of the <A
50 HREF="samba.7.html"
51 TARGET="_top"
52 > Samba</A
53 > suite.</P
54 ><P
55 >smbspool is a very small print spooling program that
56 sends a print file to an SMB printer. The command-line arguments
57 are position-dependent for compatibility with the Common UNIX
58 Printing System, but you can use smbspool with any printing system
59 or from a program or script.</P
60 ><P
61 ><EM
62 >DEVICE URI</EM
63 ></P
64 ><P
65 >smbspool specifies the destination using a Uniform Resource
66 Identifier ("URI") with a method of "smb". This string can take
67 a number of forms:</P
68 ><P
69 ></P
70 ><UL
71 ><LI
72 ><P
73 >smb://server/printer</P
74 ></LI
75 ><LI
76 ><P
77 >smb://workgroup/server/printer</P
78 ></LI
79 ><LI
80 ><P
81 >smb://username:password@server/printer</P
82 ></LI
83 ><LI
84 ><P
85 >smb://username:password@workgroup/server/printer
86 </P
87 ></LI
88 ></UL
89 ><P
90 >smbspool tries to get the URI from argv[0]. If argv[0]
91 contains the name of the program then it looks in the <TT
92 CLASS="PARAMETER"
93 ><I
94 > DEVICE_URI</I
95 ></TT
96 > environment variable.</P
97 ><P
98 >Programs using the <B
99 CLASS="COMMAND"
100 >exec(2)</B
101 > functions can
102 pass the URI in argv[0], while shell scripts must set the
104 CLASS="PARAMETER"
106 >DEVICE_URI</I
107 ></TT
108 > environment variable prior to
109 running smbspool.</P
110 ></DIV
111 ><DIV
112 CLASS="REFSECT1"
114 NAME="AEN39"
115 ></A
116 ><H2
117 >OPTIONS</H2
119 ></P
120 ><UL
121 ><LI
123 >The job argument (argv[1]) contains the
124 job ID number and is presently not used by smbspool.
126 ></LI
127 ><LI
129 >The user argument (argv[2]) contains the
130 print user's name and is presently not used by smbspool.
132 ></LI
133 ><LI
135 >The title argument (argv[3]) contains the
136 job title string and is passed as the remote file name
137 when sending the print job.</P
138 ></LI
139 ><LI
141 >The copies argument (argv[4]) contains
142 the number of copies to be printed of the named file. If
143 no filename is provided than this argument is not used by
144 smbspool.</P
145 ></LI
146 ><LI
148 >The options argument (argv[5]) contains
149 the print options in a single string and is presently
150 not used by smbspool.</P
151 ></LI
152 ><LI
154 >The filename argument (argv[6]) contains the
155 name of the file to print. If this argument is not specified
156 then the print file is read from the standard input.</P
157 ></LI
158 ></UL
159 ></DIV
160 ><DIV
161 CLASS="REFSECT1"
163 NAME="AEN54"
164 ></A
165 ><H2
166 >VERSION</H2
168 >This man page is correct for version 2.2 of
169 the Samba suite.</P
170 ></DIV
171 ><DIV
172 CLASS="REFSECT1"
174 NAME="AEN57"
175 ></A
176 ><H2
177 >SEE ALSO</H2
180 HREF="smbd.8.html"
181 TARGET="_top"
183 CLASS="COMMAND"
184 >smbd(8)</B
185 ></A
187 and <A
188 HREF="samba.7.html"
189 TARGET="_top"
190 >samba(7)</A
193 ></DIV
194 ><DIV
195 CLASS="REFSECT1"
197 NAME="AEN63"
198 ></A
199 ><H2
200 >AUTHOR</H2
203 CLASS="COMMAND"
204 >smbspool</B
205 > was written by Michael Sweet
206 at Easy Software Products.</P
208 >The original Samba software and related utilities
209 were created by Andrew Tridgell. Samba is now developed
210 by the Samba Team as an Open Source project similar
211 to the way the Linux kernel is developed.</P
213 >The original Samba man pages were written by Karl Auer.
214 The man page sources were converted to YODL format (another
215 excellent piece of Open Source software, available at
217 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
218 TARGET="_top"
219 > ftp://ftp.icce.rug.nl/pub/unix/</A
220 >) and updated for the Samba 2.0
221 release by Jeremy Allison. The conversion to DocBook for
222 Samba 2.2 was done by Gerald Carter</P
223 ></DIV
224 ></BODY
225 ></HTML