trying to get HEAD building again. If you want the code
[ira/wip.git] / docs / htmldocs / smbspool.8.html
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbspool</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbspool.8"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>smbspool &#8212; send a print file to an SMB printer</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">smbspool</tt>  {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" lang="en"><h2>DESCRIPTION</h2><p>This tool is part of the <a href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a> suite.</p><p>smbspool is a very small print spooling program that 
2         sends a print file to an SMB printer. The command-line arguments 
3         are position-dependent for compatibility with the Common UNIX 
4         Printing System, but you can use smbspool with any printing system 
5         or from a program or script.</p><p><span class="emphasis"><em>DEVICE URI</em></span></p><p>smbspool specifies the destination using a Uniform Resource 
6         Identifier (&quot;URI&quot;) with a method of &quot;smb&quot;. This string can take 
7         a number of forms:</p><div class="itemizedlist"><ul type="disc"><li><p>smb://server/printer</p></li><li><p>smb://workgroup/server/printer</p></li><li><p>smb://username:password@server/printer</p></li><li><p>smb://username:password@workgroup/server/printer</p></li></ul></div><p>smbspool tries to get the URI from argv[0]. If argv[0] 
8         contains the name of the program then it looks in the <tt class="envar">
9         DEVICE_URI</tt> environment variable.</p><p>Programs using the <b class="command">exec(2)</b> functions can 
10         pass the URI in argv[0], while shell scripts must set the 
11         <tt class="envar">DEVICE_URI</tt> environment variable prior to
12         running smbspool.</p></div><div class="refsect1" lang="en"><h2>OPTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>The job argument (argv[1]) contains the 
13                 job ID number and is presently not used by smbspool.
14                 </p></li><li><p>The user argument (argv[2]) contains the 
15                 print user's name and is presently not used by smbspool.
16                 </p></li><li><p>The title argument (argv[3]) contains the 
17                 job title string and is passed as the remote file name 
18                 when sending the print job.</p></li><li><p>The copies argument (argv[4]) contains 
19                 the number of copies to be printed of the named file. If 
20                 no filename is provided then this argument is not used by 
21                 smbspool.</p></li><li><p>The options argument (argv[5]) contains 
22                 the print options in a single string and is currently 
23                 not used by smbspool.</p></li><li><p>The filename argument (argv[6]) contains the 
24                 name of the file to print. If this argument is not specified 
25                 then the print file is read from the standard input.</p></li></ul></div></div><div class="refsect1" lang="en"><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><h2>SEE ALSO</h2><p><a href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.</p></div><div class="refsect1" lang="en"><h2>AUTHOR</h2><p><b class="command">smbspool</b> was written by Michael Sweet 
26         at Easy Software Products.</p><p>The original Samba software and related utilities 
27         were created by Andrew Tridgell. Samba is now developed
28         by the Samba Team as an Open Source project similar 
29         to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer. 
30         The man page sources were converted to YODL format (another 
31         excellent piece of Open Source software, available at <a href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
32         ftp://ftp.icce.rug.nl/pub/unix/</a>) and updated for the Samba 2.0 
33         release by Jeremy Allison.  The conversion to DocBook for 
34         Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
35         for Samba 3.0 was done by Alexander Bokovoy.</p></div></div></body></html>