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