lib: Rename fgets_slash to x_fgets_slash
[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, struct pcap_cache **_pcache)
63 {
64         TALLOC_CTX *frame = talloc_stackframe();
65         XFILE *pcap_file;
66         char *pcap_line;
67         struct pcap_cache *pcache = NULL;
68         bool print_warning = false;
69
70         if ((pcap_file = x_fopen(pcap_name, O_RDONLY, 0)) == NULL) {
71                 DEBUG(0, ("Unable to open printcap file %s for read!\n", pcap_name));
72                 talloc_free(frame);
73                 return false;
74         }
75
76         for (; (pcap_line = x_fgets_slash(NULL, 1024, pcap_file)) != NULL;
77              free(pcap_line)) {
78                 char *name = NULL;
79                 char *comment = NULL;
80                 char *p, *q;
81
82                 if (*pcap_line == '#' || *pcap_line == 0)
83                         continue;
84
85                 /* now we have a real printer line - cut at the first : */
86                 if ((p = strchr_m(pcap_line, ':')) != NULL)
87                         *p = 0;
88
89                 /*
90                  * now find the most likely printer name and comment
91                  * this is pure guesswork, but it's better than nothing
92                  */
93                 for (p = pcap_line; p != NULL; p = q) {
94                         bool has_punctuation = false;
95
96                         if ((q = strchr_m(p, '|')) != NULL)
97                                 *q++ = 0;
98
99                         has_punctuation = (strchr_m(p, ' ') ||
100                                            strchr_m(p, '\t') ||
101                                            strchr_m(p, '"') ||
102                                            strchr_m(p, '\'') ||
103                                            strchr_m(p, ';') ||
104                                            strchr_m(p, ',') ||
105                                            strchr_m(p, '(') ||
106                                            strchr_m(p, ')'));
107
108                         if (name == NULL && !has_punctuation) {
109                                 name = talloc_strdup(frame, p);
110                                 continue;
111                         }
112
113                         if (has_punctuation) {
114                                 comment = talloc_strdup(frame, p);
115                                 continue;
116                         }
117                 }
118
119                 if (name != NULL) {
120                         bool ok;
121
122                         if (!print_warning && strlen(name) > MAXPRINTERLEN) {
123                                 print_warning = true;
124                         }
125
126                         ok = pcap_cache_add_specific(&pcache,
127                                                      name,
128                                                      comment,
129                                                      NULL);
130                         if (!ok) {
131                                 x_fclose(pcap_file);
132                                 pcap_cache_destroy_specific(&pcache);
133                                 talloc_free(frame);
134                                 return false;
135                         }
136                 }
137                 TALLOC_FREE(name);
138                 TALLOC_FREE(comment);
139         }
140
141         if (print_warning) {
142                 DBG_WARNING("WARNING: You have some printer names that are "
143                             "longer than %u characters. These may not be "
144                             "accessible to some older clients!\n",
145                             (unsigned int)MAXPRINTERLEN);
146         }
147
148         x_fclose(pcap_file);
149         *_pcache = pcache;
150         talloc_free(frame);
151         return true;
152 }