s3-param: Rename loadparm_s3_context -> loadparm_s3_helpers
[kai/samba.git] / source3 / printing / print_standard.c
1 /*
2    Unix SMB/CIFS implementation.
3    printcap parsing
4    Copyright (C) Karl Auer 1993-1998
5
6    Re-working by Martin Kiff, 1994
7
8    Re-written again by Andrew Tridgell
9
10    Modified for SVID support by Norm Jacobs, 1997
11
12    Modified for CUPS support by Michael Sweet, 1999
13
14    This program is free software; you can redistribute it and/or modify
15    it under the terms of the GNU General Public License as published by
16    the Free Software Foundation; either version 3 of the License, or
17    (at your option) any later version.
18
19    This program is distributed in the hope that it will be useful,
20    but WITHOUT ANY WARRANTY; without even the implied warranty of
21    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22    GNU General Public License for more details.
23
24    You should have received a copy of the GNU General Public License
25    along with this program.  If not, see <http://www.gnu.org/licenses/>.
26 */
27
28 /*
29  *  This module contains code to parse and cache printcap data, possibly
30  *  in concert with the CUPS/SYSV/AIX-specific code found elsewhere.
31  *
32  *  The way this module looks at the printcap file is very simplistic.
33  *  Only the local printcap file is inspected (no searching of NIS
34  *  databases etc).
35  *
36  *  There are assumed to be one or more printer names per record, held
37  *  as a set of sub-fields separated by vertical bar symbols ('|') in the
38  *  first field of the record. The field separator is assumed to be a colon
39  *  ':' and the record separator a newline.
40  *
41  *  Lines ending with a backspace '\' are assumed to flag that the following
42  *  line is a continuation line so that a set of lines can be read as one
43  *  printcap entry.
44  *
45  *  A line stating with a hash '#' is assumed to be a comment and is ignored
46  *  Comments are discarded before the record is strung together from the
47  *  set of continuation lines.
48  *
49  *  Opening a pipe for "lpc status" and reading that would probably
50  *  be pretty effective. Code to do this already exists in the freely
51  *  distributable PCNFS server code.
52  */
53
54 /* printcap parsing specific code moved here from printing/pcap.c */
55
56
57 #include "includes.h"
58 #include "system/filesys.h"
59 #include "printing/pcap.h"
60
61 /* handle standard printcap - moved from pcap_printer_fn() */
62 bool std_pcap_cache_reload(const char *pcap_name)
63 {
64         XFILE *pcap_file;
65         char *pcap_line;
66
67         if ((pcap_file = x_fopen(pcap_name, O_RDONLY, 0)) == NULL) {
68                 DEBUG(0, ("Unable to open printcap file %s for read!\n", pcap_name));
69                 return false;
70         }
71
72         for (; (pcap_line = fgets_slash(NULL, 1024, pcap_file)) != NULL; free(pcap_line)) {
73                 char name[MAXPRINTERLEN+1];
74                 char comment[62];
75                 char *p, *q;
76
77                 if (*pcap_line == '#' || *pcap_line == 0)
78                         continue;
79
80                 /* now we have a real printer line - cut at the first : */
81                 if ((p = strchr_m(pcap_line, ':')) != NULL)
82                         *p = 0;
83
84                 /*
85                  * now find the most likely printer name and comment
86                  * this is pure guesswork, but it's better than nothing
87                  */
88                 for (*name = *comment = 0, p = pcap_line; p != NULL; p = q) {
89                         bool has_punctuation;
90
91                         if ((q = strchr_m(p, '|')) != NULL)
92                                 *q++ = 0;
93
94                         has_punctuation = (strchr_m(p, ' ') ||
95                                            strchr_m(p, '\t') ||
96                                            strchr_m(p, '"') ||
97                                            strchr_m(p, '\'') ||
98                                            strchr_m(p, ';') ||
99                                            strchr_m(p, ',') ||
100                                            strchr_m(p, '(') ||
101                                            strchr_m(p, ')'));
102
103                         if (strlen(p) > strlen(comment) && has_punctuation) {
104                                 strlcpy(comment, p, sizeof(comment));
105                                 continue;
106                         }
107
108                         if (strlen(p) <= MAXPRINTERLEN && *name == '\0' && !has_punctuation) {
109                                 strlcpy(name, p, sizeof(name));
110                                 continue;
111                         }
112
113                         if (!strchr_m(comment, ' ') &&
114                             strlen(p) > strlen(comment)) {
115                                 strlcpy(comment, p, sizeof(comment));
116                                 continue;
117                         }
118                 }
119
120                 if (*name && !pcap_cache_add(name, comment, NULL)) {
121                         x_fclose(pcap_file);
122                         return false;
123                 }
124         }
125
126         x_fclose(pcap_file);
127         return true;
128 }