docs/manpages/smbspool.8

   1 .\" This manpage has been automatically generated by docbook2man-spec
   2 .\" from a DocBook document.  docbook2man-spec can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .TH "SMBSPOOL" "8" "28 January 2002" "" ""
   7 .SH NAME
   8 smbspool \- send print file to an SMB printer
   9 .SH SYNOPSIS
  10 .sp
  11 \fBsmbspool\fR [ \fBjob\fR ]  [ \fBuser\fR ]  [ \fBtitle\fR ]  [ \fBcopies\fR ]  [ \fBoptions\fR ]  [ \fBfilename\fR ]
  12 .SH "DESCRIPTION"
  13 .PP
  14 This tool is part of the  Sambasuite.
  15 .PP
  16 smbspool is a very small print spooling program that
  17 sends a print file to an SMB printer. The command-line arguments
  18 are position-dependent for compatibility with the Common UNIX
  19 Printing System, but you can use smbspool with any printing system
  20 or from a program or script.
  21 .PP
  22 \fBDEVICE URI\fR
  23 .PP
  24 smbspool specifies the destination using a Uniform Resource
  25 Identifier ("URI") with a method of "smb". This string can take
  26 a number of forms:
  27 .TP 0.2i
  28 \(bu
  29 smb://server/printer
  30 .TP 0.2i
  31 \(bu
  32 smb://workgroup/server/printer
  33 .TP 0.2i
  34 \(bu
  35 smb://username:password@server/printer
  36 .TP 0.2i
  37 \(bu
  38 smb://username:password@workgroup/server/printer
  39 .PP
  40 smbspool tries to get the URI from argv[0]. If argv[0]
  41 contains the name of the program then it looks in the \fB DEVICE_URI\fR environment variable.
  42 .PP
  43 .PP
  44 Programs using the \fBexec(2)\fR functions can
  45 pass the URI in argv[0], while shell scripts must set the
  46 \fBDEVICE_URI\fR environment variable prior to
  47 running smbspool.
  48 .PP
  49 .SH "OPTIONS"
  50 .TP 0.2i
  51 \(bu
  52 The job argument (argv[1]) contains the
  53 job ID number and is presently not used by smbspool.
  54 .TP 0.2i
  55 \(bu
  56 The user argument (argv[2]) contains the
  57 print user's name and is presently not used by smbspool.
  58 .TP 0.2i
  59 \(bu
  60 The title argument (argv[3]) contains the
  61 job title string and is passed as the remote file name
  62 when sending the print job.
  63 .TP 0.2i
  64 \(bu
  65 The copies argument (argv[4]) contains
  66 the number of copies to be printed of the named file. If
  67 no filename is provided than this argument is not used by
  68 smbspool.
  69 .TP 0.2i
  70 \(bu
  71 The options argument (argv[5]) contains
  72 the print options in a single string and is presently
  73 not used by smbspool.
  74 .TP 0.2i
  75 \(bu
  76 The filename argument (argv[6]) contains the
  77 name of the file to print. If this argument is not specified
  78 then the print file is read from the standard input.
  79 .SH "VERSION"
  80 .PP
  81 This man page is correct for version 2.2 of
  82 the Samba suite.
  83 .SH "SEE ALSO"
  84 .PP
  85 \fBsmbd(8)\fR,
  86 and samba(7).
  87 .SH "AUTHOR"
  88 .PP
  89 \fBsmbspool\fR was written by Michael Sweet
  90 at Easy Software Products.
  91 .PP
  92 The original Samba software and related utilities
  93 were created by Andrew Tridgell. Samba is now developed
  94 by the Samba Team as an Open Source project similar
  95 to the way the Linux kernel is developed.
  96 .PP
  97 The original Samba man pages were written by Karl Auer.
  98 The man page sources were converted to YODL format (another
  99 excellent piece of Open Source software, available at
 100 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
 101 release by Jeremy Allison. The conversion to DocBook for
 102 Samba 2.2 was done by Gerald Carter