summaryrefslogtreecommitdiff
path: root/docs/manpages
diff options
context:
space:
mode:
authorAndrew Tridgell <tridge@samba.org>1997-12-03 05:08:07 +0000
committerAndrew Tridgell <tridge@samba.org>1997-12-03 05:08:07 +0000
commit7a668a7641cd747455b7a9854dbc208a3e4bc7ef (patch)
tree337d3570bd8160d93ee74c2e3ff139be0db9e4d9 /docs/manpages
parent02bc90ea442f5d115df17de0ebd0bbfdf214c1a5 (diff)
downloadsamba-7a668a7641cd747455b7a9854dbc208a3e4bc7ef.tar.gz
samba-7a668a7641cd747455b7a9854dbc208a3e4bc7ef.tar.bz2
samba-7a668a7641cd747455b7a9854dbc208a3e4bc7ef.zip
applied a patch from Norm Jacobs to allow "printcap name = lpstat"
to use lpstat to obtain the printer list on systemV systems. I've now made this the default on all SYSV systems. Jeremy, you were a little worried about the security of this patch. I believe it's OK as the user has no control over the options given to popen() and the pipe is only open for reading. (This used to be commit 6a83de0ae954bb18d3f15382f2b0b3259fedff09)
Diffstat (limited to 'docs/manpages')
-rw-r--r--docs/manpages/smb.conf.516
1 files changed, 13 insertions, 3 deletions
diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5
index 147b3dce9f..8937fe74eb 100644
--- a/docs/manpages/smb.conf.5
+++ b/docs/manpages/smb.conf.5
@@ -210,6 +210,12 @@ could be used simply to limit access to a subset of your local printers.
An alias, by the way, is defined as any component of the first entry of a
printcap record. Records are separated by newlines, components (if there are
more than one) are separated by vertical bar symbols ("|").
+
+NOTE: On SYSV systems which use lpstat to determine what printers are
+defined on the system you may be able to use "printcap name = lpstat"
+to automatically obtain a list of printers. See the "printcap name"
+option for more detils.
+
.RE
.SH PARAMETERS
Parameters define the specific attributes of services.
@@ -2759,9 +2765,13 @@ This parameter may be used to override the compiled-in default printcap
name used by the server (usually /etc/printcap). See the discussion of the
[printers] section above for reasons why you might want to do this.
-For those of you without a printcap (say on SysV) you can just create a
-minimal file that looks like a printcap and set "printcap name =" in
-[global] to point at it.
+On SystemV systems that use lpstat to list available printers you
+can use "printcap name = lpstat" to automatically obtain lists of
+available printers. This is the default for systems that define
+SYSV at compile time in Samba (this includes most SystemV based
+systems). If "printcap name" is set to lpstat on these systems then
+Samba will launch "lpstat -v" and attempt to parse the output to
+obtain a printer list.
A minimal printcap file would look something like this: