This commit was manufactured by cvs2svn to create branch 'SAMBA_3_0'.(This used to...
[samba.git] / docs / htmldocs / smbspool.8.html
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="ENVAR"
93 >       DEVICE_URI</TT
94 > environment variable.</P
95 ><P
96 >Programs using the <B
97 CLASS="COMMAND"
98 >exec(2)</B
99 > functions can 
100         pass the URI in argv[0], while shell scripts must set the 
101         <TT
102 CLASS="ENVAR"
103 >DEVICE_URI</TT
104 > environment variable prior to
105         running smbspool.</P
106 ></DIV
107 ><DIV
108 CLASS="REFSECT1"
109 ><A
110 NAME="AEN39"
111 ></A
112 ><H2
113 >OPTIONS</H2
114 ><P
115 ></P
116 ><UL
117 ><LI
118 ><P
119 >The job argument (argv[1]) contains the 
120                 job ID number and is presently not used by smbspool.
121                 </P
122 ></LI
123 ><LI
124 ><P
125 >The user argument (argv[2]) contains the 
126                 print user's name and is presently not used by smbspool.
127                 </P
128 ></LI
129 ><LI
130 ><P
131 >The title argument (argv[3]) contains the 
132                 job title string and is passed as the remote file name 
133                 when sending the print job.</P
134 ></LI
135 ><LI
136 ><P
137 >The copies argument (argv[4]) contains 
138                 the number of copies to be printed of the named file. If 
139                 no filename is provided than this argument is not used by 
140                 smbspool.</P
141 ></LI
142 ><LI
143 ><P
144 >The options argument (argv[5]) contains 
145                 the print options in a single string and is presently 
146                 not used by smbspool.</P
147 ></LI
148 ><LI
149 ><P
150 >The filename argument (argv[6]) contains the 
151                 name of the file to print. If this argument is not specified 
152                 then the print file is read from the standard input.</P
153 ></LI
154 ></UL
155 ></DIV
156 ><DIV
157 CLASS="REFSECT1"
158 ><A
159 NAME="AEN54"
160 ></A
161 ><H2
162 >VERSION</H2
163 ><P
164 >This man page is correct for version 2.2 of 
165         the Samba suite.</P
166 ></DIV
167 ><DIV
168 CLASS="REFSECT1"
169 ><A
170 NAME="AEN57"
171 ></A
172 ><H2
173 >SEE ALSO</H2
174 ><P
175 ><A
176 HREF="smbd.8.html"
177 TARGET="_top"
178 ><B
179 CLASS="COMMAND"
180 >smbd(8)</B
181 ></A
182 >, 
183         and <A
184 HREF="samba.7.html"
185 TARGET="_top"
186 >samba(7)</A
187 >.
188         </P
189 ></DIV
190 ><DIV
191 CLASS="REFSECT1"
192 ><A
193 NAME="AEN63"
194 ></A
195 ><H2
196 >AUTHOR</H2
197 ><P
198 ><B
199 CLASS="COMMAND"
200 >smbspool</B
201 > was written by Michael Sweet 
202         at Easy Software Products.</P
203 ><P
204 >The original Samba software and related utilities 
205         were created by Andrew Tridgell. Samba is now developed
206         by the Samba Team as an Open Source project similar 
207         to the way the Linux kernel is developed.</P
208 ><P
209 >The original Samba man pages were written by Karl Auer. 
210         The man page sources were converted to YODL format (another 
211         excellent piece of Open Source software, available at
212         <A
213 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
214 TARGET="_top"
215 >       ftp://ftp.icce.rug.nl/pub/unix/</A
216 >) and updated for the Samba 2.0 
217         release by Jeremy Allison.  The conversion to DocBook for 
218         Samba 2.2 was done by Gerald Carter</P
219 ></DIV
220 ></BODY
221 ></HTML
222 >