blob: 9be04433440095097a499c7bf955b3c36433d035 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
.TH "testprns " "1" "23 Oct 1998" "Samba" "SAMBA"
.PP
.SH "NAME"
testprns \- check printer name for validity with smbd
.PP
.SH "SYNOPSIS"
.PP
\fBtestprns\fP printername [printcapname]
.PP
.SH "DESCRIPTION"
.PP
This program is part of the \fBSamba\fP suite\&.
.PP
\fBtestprns\fP is a very simple test program to determine whether a
given printer name is valid for use in a service to be provided by
\fBsmbd\fP\&.
.PP
"Valid" in this context means "can be found in the printcap
specified"\&. This program is very stupid - so stupid in fact that it
would be wisest to always specify the printcap file to use\&.
.PP
.SH "OPTIONS"
.PP
.IP
.IP "\fBprintername\fP"
The printer name to validate\&.
.IP
Printer names are taken from the first field in each record in the
printcap file, single printer names and sets of aliases separated by
vertical bars ("|") are recognized\&. Note that no validation or
checking of the printcap syntax is done beyond that required to
extract the printer name\&. It may be that the print spooling system is
more forgiving or less forgiving than \fBtestprns\fP\&. However, if
\fBtestprns\fP finds the printer then \fBsmbd\fP should
do so as well\&.
.IP
.IP "\fBprintcapname\fP"
This is the name of the printcap file within
which to search for the given printer name\&.
.IP
If no printcap name is specified \fBtestprns\fP will attempt to scan the
printcap file name specified at compile time\&.
.IP
.PP
.SH "FILES"
.PP
\fB/etc/printcap\fP This is usually the default printcap file to
scan\&. See \fBprintcap (5)\fP\&.
.PP
.SH "DIAGNOSTICS"
.PP
If a printer is found to be valid, the message "Printer name
<printername> is valid" will be displayed\&.
.PP
If a printer is found to be invalid, the message "Printer name
<printername> is not valid" will be displayed\&.
.PP
All messages that would normally be logged during operation of the
\fBSamba\fP daemons are logged by this program to the
file \f(CWtest\&.log\fP in the current directory\&. The program runs at
debuglevel 3, so quite extensive logging information is written\&. The
log should be checked carefully for errors and warnings\&.
.PP
Other messages are self-explanatory\&.
.PP
.SH "SEE ALSO"
.PP
\fBprintcap (5)\fP, \fBsmbd (8)\fP, \fBsmbclient
(1)\fP
.PP
.SH "AUTHOR"
.PP
The original Samba software and related utilities were created by
Andrew Tridgell \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&. Samba is now developed
by the Samba Team as an Open Source project similar to the way the
Linux kernel is developed\&.
.PP
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
\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
and updated for the Samba2\&.0 release by Jeremy Allison\&.
\fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&.
.PP
See \fBsamba (7)\fP to find out how to get a full
list of contributors and details on how to submit bug reports,
comments etc\&.
|