Ignore:
Timestamp:
May 27, 2007, 12:26:26 AM (18 years ago)
Author:
Paul Smedley
Message:

Upgrade source to 3.0.25a

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/samba/docs/manpages/smbspool.8

    r1 r39  
    1919..
    2020.TH "SMBSPOOL" 8 "" "" ""
    21 .SH NAME
    22 smbspool \- send a print file to an SMB printer
     21.SH "NAME"
     22smbspool - send a print file to an SMB printer
    2323.SH "SYNOPSIS"
    24 .ad l
    25 .hy 0
    2624.HP 9
    2725\fBsmbspool\fR {job} {user} {title} {copies} {options} [filename]
    28 .ad
    29 .hy
    30 
    3126.SH "DESCRIPTION"
    32 
    3327.PP
    34 This tool is part of the \fBsamba\fR(7) suite\&.
    35 
     28This tool is part of the
     29\fBsamba\fR(7)
     30suite.
    3631.PP
    37 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\&.
    38 
     32smbspool 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.
    3933.PP
    4034\fBDEVICE URI\fR
     35.PP
     36smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb". This string can take a number of forms:
     37.TP 3n
     38•
     39smb://server[:port]/printer
     40.TP 3n
     41•
     42smb://workgroup/server[:port]/printer
     43.TP 3n
     44•
     45smb://username:password@server[:port]/printer
     46.TP 3n
     47•
     48smb://username:password@workgroup/server[:port]/printer
     49.PP
     50smbspool tries to get the URI from the environment variable
     51\fBDEVICE_URI\fR. If
     52\fBDEVICE_URI\fR
     53is not present, smbspool will use argv[0] if that starts with
     54“smb://”
     55or argv[1] if that is not the case.
     56.PP
     57Programs using the
     58\fBexec(2)\fR
     59functions can pass the URI in argv[0], while shell scripts must set the
     60\fBDEVICE_URI\fR
     61environment variable prior to running smbspool.
     62.SH "OPTIONS"
     63.TP 3n
     64•
     65The job argument (argv[1]) contains the job ID number and is presently not used by smbspool.
     66.TP 3n
     67•
     68The user argument (argv[2]) contains the print user's name and is presently not used by smbspool.
     69.TP 3n
     70•
     71The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job.
     72.TP 3n
     73•
     74The 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.
     75.TP 3n
     76•
     77The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool.
     78.TP 3n
     79•
     80The 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.
     81.SH "VERSION"
     82.PP
     83This man page is correct for version 3.0 of the Samba suite.
     84.SH "SEE ALSO"
     85.PP
     86\fBsmbd\fR(8)
     87and
     88\fBsamba\fR(7).
     89.SH "AUTHOR"
     90.PP
     91\fBsmbspool\fR
     92was written by Michael Sweet at Easy Software Products.
     93.PP
     94The 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.
     95.PP
     96The 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
     97ftp://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.
    4198
    42 .PP
    43 smbspool specifies the destination using a Uniform Resource Identifier ("URI") with a method of "smb"\&. This string can take a number of forms:
    44 
    45 .TP 3
    46 \(bu
    47 smb://server[:port]/printer
    48 .TP
    49 \(bu
    50 smb://workgroup/server[:port]/printer
    51 .TP
    52 \(bu
    53 smb://username:password@server[:port]/printer
    54 .TP
    55 \(bu
    56 smb://username:password@workgroup/server[:port]/printer
    57 .LP
    58 
    59 .PP
    60 smbspool tries to get the URI from the environment variable\fBDEVICE_URI\fR\&. If \fBDEVICE_URI\fR is not present, smbspool will use argv[0] if that starts with ``smb://'' or argv[1] if that is not the case\&.
    61 
    62 .PP
    63 Programs using the \fBexec(2)\fR functions can pass the URI in argv[0], while shell scripts must set the\fBDEVICE_URI\fR environment variable prior to running smbspool\&.
    64 
    65 .SH "OPTIONS"
    66 
    67 .TP 3
    68 \(bu
    69 The job argument (argv[1]) contains the job ID number and is presently not used by smbspool\&.
    70 .TP
    71 \(bu
    72 The user argument (argv[2]) contains the print user's name and is presently not used by smbspool\&.
    73 .TP
    74 \(bu
    75 The title argument (argv[3]) contains the job title string and is passed as the remote file name when sending the print job\&.
    76 .TP
    77 \(bu
    78 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\&.
    79 .TP
    80 \(bu
    81 The options argument (argv[5]) contains the print options in a single string and is currently not used by smbspool\&.
    82 .TP
    83 \(bu
    84 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\&.
    85 .LP
    86 
    87 .SH "VERSION"
    88 
    89 .PP
    90 This man page is correct for version 3\&.0 of the Samba suite\&.
    91 
    92 .SH "SEE ALSO"
    93 
    94 .PP
    95 \fBsmbd\fR(8) and \fBsamba\fR(7)\&.
    96 
    97 .SH "AUTHOR"
    98 
    99 .PP
    100 \fBsmbspool\fR was written by Michael Sweet at Easy Software Products\&.
    101 
    102 .PP
    103 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\&.
    104 
    105 .PP
    106 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 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\&.
    107 
Note: See TracChangeset for help on using the changeset viewer.