Changeset 231 for branches/samba-3.2.x/docs/manpages/smbspool.8
- Timestamp:
- May 27, 2009, 9:08:03 AM (16 years ago)
- File:
-
- 1 edited
-
branches/samba-3.2.x/docs/manpages/smbspool.8 (modified) (3 diffs)
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.2.x/docs/manpages/smbspool.8
r229 r231 1 1 .\" Title: smbspool 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.7 3.1<http://docbook.sf.net/>4 .\" Date: 12/19/20082 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 02/03/2009 5 5 .\" Manual: System Administration tools 6 6 .\" Source: Samba 3.2 7 .\" Language: English 7 8 .\" 8 .TH "SMBSPOOL" "8" "12/19/2008" "Samba 3\.2" "System Administration tools" 9 .TH "SMBSPOOL" "8" "02/03/2009" "Samba 3\&.2" "System Administration tools" 10 .\" ----------------------------------------------------------------- 11 .\" * (re)Define some macros 12 .\" ----------------------------------------------------------------- 13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 14 .\" toupper - uppercase a string (locale-aware) 15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 16 .de toupper 17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ 18 \\$* 19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz 20 .. 21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 22 .\" SH-xref - format a cross-reference to an SH section 23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 24 .de SH-xref 25 .ie n \{\ 26 .\} 27 .toupper \\$* 28 .el \{\ 29 \\$* 30 .\} 31 .. 32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 33 .\" SH - level-one heading that works better for non-TTY output 34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 35 .de1 SH 36 .\" put an extra blank line of space above the head in non-TTY output 37 .if t \{\ 38 .sp 1 39 .\} 40 .sp \\n[PD]u 41 .nr an-level 1 42 .set-an-margin 43 .nr an-prevailing-indent \\n[IN] 44 .fi 45 .in \\n[an-margin]u 46 .ti 0 47 .HTML-TAG ".NH \\n[an-level]" 48 .it 1 an-trap 49 .nr an-no-space-flag 1 50 .nr an-break-flag 1 51 \." make the size of the head bigger 52 .ps +3 53 .ft B 54 .ne (2v + 1u) 55 .ie n \{\ 56 .\" if n (TTY output), use uppercase 57 .toupper \\$* 58 .\} 59 .el \{\ 60 .nr an-break-flag 0 61 .\" if not n (not TTY), use normal case (not uppercase) 62 \\$1 63 .in \\n[an-margin]u 64 .ti 0 65 .\" if not n (not TTY), put a border/line under subheading 66 .sp -.6 67 \l'\n(.lu' 68 .\} 69 .. 70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 71 .\" SS - level-two heading that works better for non-TTY output 72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 73 .de1 SS 74 .sp \\n[PD]u 75 .nr an-level 1 76 .set-an-margin 77 .nr an-prevailing-indent \\n[IN] 78 .fi 79 .in \\n[IN]u 80 .ti \\n[SN]u 81 .it 1 an-trap 82 .nr an-no-space-flag 1 83 .nr an-break-flag 1 84 .ps \\n[PS-SS]u 85 \." make the size of the head bigger 86 .ps +2 87 .ft B 88 .ne (2v + 1u) 89 .if \\n[.$] \&\\$* 90 .. 91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 92 .\" BB/BE - put background/screen (filled box) around block of text 93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 94 .de BB 95 .if t \{\ 96 .sp -.5 97 .br 98 .in +2n 99 .ll -2n 100 .gcolor red 101 .di BX 102 .\} 103 .. 104 .de EB 105 .if t \{\ 106 .if "\\$2"adjust-for-leading-newline" \{\ 107 .sp -1 108 .\} 109 .br 110 .di 111 .in 112 .ll 113 .gcolor 114 .nr BW \\n(.lu-\\n(.i 115 .nr BH \\n(dn+.5v 116 .ne \\n(BHu+.5v 117 .ie "\\$2"adjust-for-leading-newline" \{\ 118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 119 .\} 120 .el \{\ 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 122 .\} 123 .in 0 124 .sp -.5v 125 .nf 126 .BX 127 .in 128 .sp .5v 129 .fi 130 .\} 131 .. 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 133 .\" BM/EM - put colored marker in margin next to block of text 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 135 .de BM 136 .if t \{\ 137 .br 138 .ll -2n 139 .gcolor red 140 .di BX 141 .\} 142 .. 143 .de EM 144 .if t \{\ 145 .br 146 .di 147 .ll 148 .gcolor 149 .nr BH \\n(dn 150 .ne \\n(BHu 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] 152 .in 0 153 .nf 154 .BX 155 .in 156 .fi 157 .\} 158 .. 159 .\" ----------------------------------------------------------------- 160 .\" * set default formatting 161 .\" ----------------------------------------------------------------- 9 162 .\" disable hyphenation 10 163 .nh 11 164 .\" disable justification (adjust text to left margin only) 12 165 .ad l 13 .SH "NAME" 14 smbspool - send a print file to an SMB printer 15 .SH "SYNOPSIS" 16 .HP 1 17 smbspool {job} {user} {title} {copies} {options} [filename] 166 .\" ----------------------------------------------------------------- 167 .\" * MAIN CONTENT STARTS HERE * 168 .\" ----------------------------------------------------------------- 169 .SH "Name" 170 smbspool \- send a print file to an SMB printer 171 .SH "Synopsis" 172 .fam C 173 .HP \w'\ 'u 174 \FCsmbspool\F[] {job} {user} {title} {copies} {options} [filename] 175 .fam 18 176 .SH "DESCRIPTION" 19 177 .PP 20 178 This tool is part of the 21 179 \fBsamba\fR(7) 22 suite\ .23 .PP 24 smbspool is a very small print spooling program that sends a print file to an SMB printer\ . The command\-line arguments are position\-dependent for compatibility with the Common UNIX Printing System, but you can use smbspool with any printing system or from a program or script\.180 suite\&. 181 .PP 182 smbspool is a very small print spooling program that sends a print file to an SMB printer\&. The command\-line arguments are position\-dependent for compatibility with the Common UNIX Printing System, but you can use smbspool with any printing system or from a program or script\&. 25 183 .PP 26 184 \fIDEVICE URI\fR 27 185 .PP 28 smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb"\ . This string can take a number of forms:186 smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb"\&. This string can take a number of forms: 29 187 .sp 30 188 .RS 4 … … 74 232 .PP 75 233 smbspool tries to get the URI from the environment variable 76 \fBDEVICE_URI\fR\ . If234 \fBDEVICE_URI\fR\&. If 77 235 \fBDEVICE_URI\fR 78 236 is not present, smbspool will use argv[0] if that starts with 79 237 \(lqsmb://\(rq 80 or argv[1] if that is not the case\ .238 or argv[1] if that is not the case\&. 81 239 .PP 82 240 Programs using the 83 exec(2) 241 \FCexec(2)\F[] 84 242 functions can pass the URI in argv[0], while shell scripts must set the 85 243 \fBDEVICE_URI\fR 86 environment variable prior to running smbspool\ .244 environment variable prior to running smbspool\&. 87 245 .SH "OPTIONS" 88 246 .sp … … 95 253 .IP \(bu 2.3 96 254 .\} 97 The job argument (argv[1]) contains the job ID number and is presently not used by smbspool\ .98 .RE 99 .sp 100 .RS 4 101 .ie n \{\ 102 \h'-04'\(bu\h'+03'\c 103 .\} 104 .el \{\ 105 .sp -1 106 .IP \(bu 2.3 107 .\} 108 The user argument (argv[2]) contains the print user\'s name and is presently not used by smbspool\ .109 .RE 110 .sp 111 .RS 4 112 .ie n \{\ 113 \h'-04'\(bu\h'+03'\c 114 .\} 115 .el \{\ 116 .sp -1 117 .IP \(bu 2.3 118 .\} 119 The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job\ .120 .RE 121 .sp 122 .RS 4 123 .ie n \{\ 124 \h'-04'\(bu\h'+03'\c 125 .\} 126 .el \{\ 127 .sp -1 128 .IP \(bu 2.3 129 .\} 130 The copies argument (argv[4]) contains the number of copies to be printed of the named file\ . If no filename is provided then this argument is not used by smbspool\.131 .RE 132 .sp 133 .RS 4 134 .ie n \{\ 135 \h'-04'\(bu\h'+03'\c 136 .\} 137 .el \{\ 138 .sp -1 139 .IP \(bu 2.3 140 .\} 141 The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool\ .142 .RE 143 .sp 144 .RS 4 145 .ie n \{\ 146 \h'-04'\(bu\h'+03'\c 147 .\} 148 .el \{\ 149 .sp -1 150 .IP \(bu 2.3 151 .\} 152 The filename argument (argv[6]) contains the name of the file to print\ . If this argument is not specified then the print file is read from the standard input\.255 The job argument (argv[1]) contains the job ID number and is presently not used by smbspool\&. 256 .RE 257 .sp 258 .RS 4 259 .ie n \{\ 260 \h'-04'\(bu\h'+03'\c 261 .\} 262 .el \{\ 263 .sp -1 264 .IP \(bu 2.3 265 .\} 266 The user argument (argv[2]) contains the print user\'s name and is presently not used by smbspool\&. 267 .RE 268 .sp 269 .RS 4 270 .ie n \{\ 271 \h'-04'\(bu\h'+03'\c 272 .\} 273 .el \{\ 274 .sp -1 275 .IP \(bu 2.3 276 .\} 277 The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job\&. 278 .RE 279 .sp 280 .RS 4 281 .ie n \{\ 282 \h'-04'\(bu\h'+03'\c 283 .\} 284 .el \{\ 285 .sp -1 286 .IP \(bu 2.3 287 .\} 288 The copies argument (argv[4]) contains the number of copies to be printed of the named file\&. If no filename is provided then this argument is not used by smbspool\&. 289 .RE 290 .sp 291 .RS 4 292 .ie n \{\ 293 \h'-04'\(bu\h'+03'\c 294 .\} 295 .el \{\ 296 .sp -1 297 .IP \(bu 2.3 298 .\} 299 The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool\&. 300 .RE 301 .sp 302 .RS 4 303 .ie n \{\ 304 \h'-04'\(bu\h'+03'\c 305 .\} 306 .el \{\ 307 .sp -1 308 .IP \(bu 2.3 309 .\} 310 The filename argument (argv[6]) contains the name of the file to print\&. If this argument is not specified then the print file is read from the standard input\&. 153 311 .SH "VERSION" 154 312 .PP 155 This man page is correct for version 3 of the Samba suite\ .313 This man page is correct for version 3 of the Samba suite\&. 156 314 .SH "SEE ALSO" 157 315 .PP 158 316 \fBsmbd\fR(8) 159 317 and 160 \fBsamba\fR(7)\ .318 \fBsamba\fR(7)\&. 161 319 .SH "AUTHOR" 162 320 .PP 163 smbspool 164 was written by Michael Sweet at Easy Software Products\ .165 .PP 166 The original Samba software and related utilities were created by Andrew Tridgell\ . Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\.167 .PP 168 The original Samba man pages were written by Karl Auer\ . The man page sources were converted to YODL format (another excellent piece of Open Source software, available at169 ftp://ftp\ .icce\.rug\.nl/pub/unix/) and updated for the Samba 2\.0 release by Jeremy Allison\. The conversion to DocBook for Samba 2\.2 was done by Gerald Carter\. The conversion to DocBook XML 4\.2 for Samba 3\.0 was done by Alexander Bokovoy\.321 \FCsmbspool\F[] 322 was written by Michael Sweet at Easy Software Products\&. 323 .PP 324 The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&. 325 .PP 326 The original Samba man pages were written by Karl Auer\&. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at 327 ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
Note:
See TracChangeset
for help on using the changeset viewer.
