preparing for release of 2.2.0-alpha2
[Samba/ekacnet.git] / docs / manpages / smbspool.8
blob90ba1cd7aba6fe4bb4abfe576559b2735d3df9f3
1 .TH SMBSPOOL 8 "30 Jan 2001" "smbspool 2.2.0-alpha2"
2 .PP 
3 .SH "NAME" 
4 smbspool \- send print file to an SMB printer
5 .PP 
6 .SH "SYNOPSIS" 
7 \fBsmbspool\fP job user title copies options [filename]
8 .PP 
9 .SH "DESCRIPTION" 
10 .PP 
11 This program is part of the Samba suite\&.
12 .PP 
13 smbspool is a very small print spooling program that sends a print
14 file to an SMB printer\&. The command-line arguments are position-dependent for
15 compatibility with the Common UNIX Printing System, but you can use
16 smbspool with any printing system or from a program or script\&.
17 .PP 
18 .SH "DEVICE URI" 
19 .PP 
20 smbspool specifies the destination using a Uniform Resource Identifier
21 ("URI") with a method of "smb"\&. This string can take a number of
22 forms:
23 .PP 
24 .IP o 
25 smb://server/printer
26 .IP 
27 .IP o 
28 smb://workgroup/server/printer
29 .IP 
30 .IP o 
31 smb://username:password@server/printer
32 .IP 
33 .IP o 
34 smb://username:password@workgroup/server/printer
35 .IP 
36 .PP 
37 smbspool tries to get the URI from argv[0]\&. If argv[0] contains the
38 name of the program then it looks in the DEVICE_URI environment variable\&.
39 .PP 
40 Programs using the exec(2) functions can pass the URI in argv[0],
41 while shell scripts must set the DEVICE_URI environment variable prior to
42 running smbspool\&.
43 .PP 
44 .SH "OPTIONS" 
45 .PP 
46 The job argument (argv[1]) contains the job ID number and is presently
47 not used by smbspool\&.
48 .PP 
49 The user argument (argv[2]) contains the print user\'s name and is
50 presently not used by smbspool\&.
51 .PP 
52 The title argument (argv[3]) contains the job title string and is
53 passed as the remote file name when sending the print job\&.
54 .PP 
55 The copies argument (argv[4]) contains the number of copies to be
56 printed of the named file\&. If no filename is provided than this argument is
57 not used by smbspool\&.
58 .PP 
59 The options argument (argv[5]) contains the print options in a single
60 string and is presently not used by smbspool\&.
61 .PP 
62 The filename argument (argv[6]) contains the name of the file to print\&.
63 If this argument is not specified then the print file is read from the
64 standard input\&.
65 .PP 
66 .SH "VERSION" 
67 .PP 
68 This man page is correct for version 2\&.0 of the Samba suite\&.
69 .PP 
70 .SH "SEE ALSO" 
71 \fBsmbd (8)\fP
72 .PP 
73 .SH "AUTHOR" 
74 .PP 
75 smbspool was written by Michael Sweet at Easy Software Products\&.
76 .PP 
77 The original Samba software and related utilities were created by
78 Andrew Tridgell samba@samba\&.org\&. Samba is now developed
79 by the Samba Team as an Open Source project similar to the way the
80 Linux kernel is developed\&.
81 .PP 
82 See samba (7) to find out how to get a full
83 list of contributors and details on how to submit bug reports,
84 comments etc\&.