2 Unix SMB/Netbios implementation.
5 Copyright (C) Karl Auer 1993-1998
7 Re-working by Martin Kiff, 1994
9 Re-written again by Andrew Tridgell
11 Modified for SVID support by Norm Jacobs, 1997
13 Modified for CUPS support by Michael Sweet, 1999
15 This program is free software; you can redistribute it and/or modify
16 it under the terms of the GNU General Public License as published by
17 the Free Software Foundation; either version 2 of the License, or
18 (at your option) any later version.
20 This program is distributed in the hope that it will be useful,
21 but WITHOUT ANY WARRANTY; without even the implied warranty of
22 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 GNU General Public License for more details.
25 You should have received a copy of the GNU General Public License
26 along with this program; if not, write to the Free Software
27 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
31 * Parse printcap file.
33 * This module does exactly one thing - it looks into the printcap file
34 * and tells callers if a specified string appears as a printer name.
36 * The way this module looks at the printcap file is very simplistic.
37 * Only the local printcap file is inspected (no searching of NIS
40 * There are assumed to be one or more printer names per record, held
41 * as a set of sub-fields separated by vertical bar symbols ('|') in the
42 * first field of the record. The field separator is assumed to be a colon
43 * ':' and the record separator a newline.
45 * Lines ending with a backspace '\' are assumed to flag that the following
46 * line is a continuation line so that a set of lines can be read as one
49 * A line stating with a hash '#' is assumed to be a comment and is ignored
50 * Comments are discarded before the record is strung together from the
51 * set of continuation lines.
53 * Opening a pipe for "lpc status" and reading that would probably
54 * be pretty effective. Code to do this already exists in the freely
55 * distributable PCNFS server code.
57 * Modified to call SVID/XPG4 support if printcap name is set to "lpstat"
58 * in smb.conf under Solaris.
60 * Modified to call CUPS support if printcap name is set to "cups"
69 /* ******************************************
70 Extend for AIX system and qconfig file
71 from 'boulard@univ-rennes1.fr
72 ****************************************** */
73 static int strlocate(char *xpLine,char *xpS)
84 if (strncmp(p,xpS,iS) == 0) {iRet =1;break;};
88 /*DEBUG(3,(" strlocate %s in line '%s',ret=%d\n",xpS,xpLine,iRet));*/
94 /* ******************************************************************* */
95 /* * Scan qconfig and search all virtual printer (device printer) * */
96 /* ******************************************************************* */
97 static void ScanQconfig_fn(char *psz,void (*fn)(char *, char *))
102 pstring name,comment;
107 if ((pfile = x_fopen(psz, O_RDONLY, 0)) == NULL)
109 DEBUG(0,( "Unable to open qconfig file %s for read!\n", psz));
114 /* scan qconfig file for searching <printername>: */
115 for (;(line = fgets_slash(NULL,sizeof(pstring),pfile)); free(line))
117 if (*line == '*' || *line == 0)
121 case 0: /* locate an entry */
122 if (*line == '\t' || *line == ' ') continue;
123 if ((p=strchr_m(line,':')))
126 p = strtok(line,":");
127 if (strcmp(p,"bsh")!=0)
135 case 1: /* scanning device stanza */
136 if (*line == '*' || *line == 0) continue;
137 if (*line != '\t' && *line != ' ')
139 /* name is found without stanza device */
140 /* probably a good printer ??? */
146 if (strlocate(line,"backend"))
148 /* it's a device, not a virtual printer*/
151 else if (strlocate(line,"device"))
153 /* it's a good virtual printer */
164 /* Scan qconfig file and locate de printername */
166 static BOOL ScanQconfig(char *psz,char *pszPrintername)
175 if ((pszPrintername!= NULL) && ((iLg = strlen(pszPrintername)) > 0))
176 pName = malloc(iLg+10);
179 DEBUG(0,(" Unable to allocate memory for printer %s\n",pszPrintername));
182 if ((pfile = x_fopen(psz, O_RDONLY, 0)) == NULL)
184 DEBUG(0,( "Unable to open qconfig file %s for read!\n", psz));
188 slprintf(pName, iLg + 9, "%s:",pszPrintername);
190 /*DEBUG(3,( " Looking for entry %s\n",pName));*/
192 /* scan qconfig file for searching <printername>: */
193 for (;(line = fgets_slash(NULL,sizeof(pstring),pfile)); free(line))
195 if (*line == '*' || *line == 0)
199 case 0: /* scanning entry */
200 if (strncmp(line,pName,iLg) == 0)
206 case 1: /* scanning device stanza */
207 if (*line == '*' || *line == 0) continue;
208 if (*line != '\t' && *line != ' ')
210 /* name is found without stanza device */
211 /* probably a good printer ??? */
218 if (strlocate(line,"backend"))
220 /* it's a device, not a virtual printer*/
223 else if (strlocate(line,"device"))
225 /* it's a good virtual printer */
241 /***************************************************************************
242 Scan printcap file pszPrintcapname for a printer called pszPrintername.
243 Return True if found, else False. Returns False on error, too, after logging
244 the error at level 0. For generality, the printcap name may be passed - if
245 passed as NULL, the configuration will be queried for the name. pszPrintername
246 must be in DOS codepage.
247 The xxx_printername_ok functions need fixing to understand they are being
248 given a DOS codepage. FIXME !! JRA.
249 ***************************************************************************/
250 BOOL pcap_printername_ok(char *pszPrintername, char *pszPrintcapname)
257 if (pszPrintername == NULL || pszPrintername[0] == '\0')
259 DEBUG(0,( "Attempt to locate null printername! Internal error?\n"));
263 /* only go looking if no printcap name supplied */
264 if ((psz = pszPrintcapname) == NULL || psz[0] == '\0')
265 if (((psz = lp_printcapname()) == NULL) || (psz[0] == '\0'))
267 DEBUG(0,( "No printcap file name configured!\n"));
272 if (strequal(psz, "cups"))
273 return (cups_printername_ok(pszPrintername));
274 #endif /* HAVE_CUPS */
277 if (strequal(psz, "lpstat"))
278 return (sysv_printername_ok(pszPrintername));
282 if (strlocate(psz,"/qconfig"))
283 return(ScanQconfig(psz,pszPrintername));
286 if ((pfile = x_fopen(psz, O_RDONLY, 0)) == NULL)
288 DEBUG(0,( "Unable to open printcap file %s for read!\n", psz));
292 for (;(line = fgets_slash(NULL,sizeof(pstring),pfile)); free(line))
294 if (*line == '#' || *line == 0)
297 /* now we have a real printer line - cut it off at the first : */
298 p = strchr_m(line,':');
301 /* now just check if the name is in the list */
302 /* NOTE: I avoid strtok as the fn calling this one may be using it */
305 if ((q = strchr_m(p,'|'))) *q++ = 0;
307 if (strequal(p,pszPrintername))
309 /* normalise the case */
310 pstrcpy(pszPrintername,p);
324 /***************************************************************************
325 run a function on each printer name in the printcap file. The function is
326 passed the primary name and the comment (if possible). Note the fn() takes
327 strings in DOS codepage. This means the xxx_printer_fn() calls must be fixed
328 to return DOS codepage. FIXME !! JRA.
329 ***************************************************************************/
330 void pcap_printer_fn(void (*fn)(char *, char *))
332 pstring name,comment;
338 /* only go looking if no printcap name supplied */
339 if (((psz = lp_printcapname()) == NULL) || (psz[0] == '\0'))
341 DEBUG(0,( "No printcap file name configured!\n"));
346 if (strequal(psz, "cups")) {
350 #endif /* HAVE_CUPS */
353 if (strequal(psz, "lpstat")) {
360 if (strlocate(psz,"/qconfig"))
362 ScanQconfig_fn(psz,fn);
367 if ((pfile = x_fopen(psz, O_RDONLY, 0)) == NULL)
369 DEBUG(0,( "Unable to open printcap file %s for read!\n", psz));
373 for (;(line = fgets_slash(NULL,sizeof(pstring),pfile)); free(line))
375 if (*line == '#' || *line == 0)
378 /* now we have a real printer line - cut it off at the first : */
379 p = strchr_m(line,':');
382 /* now find the most likely printer name and comment
383 this is pure guesswork, but it's better than nothing */
388 BOOL has_punctuation;
389 if ((q = strchr_m(p,'|'))) *q++ = 0;
391 has_punctuation = (strchr_m(p,' ') || strchr_m(p,'\t') || strchr_m(p,'(') || strchr_m(p,')'));
393 if (strlen(p)>strlen(comment) && has_punctuation)
395 StrnCpy(comment,p,sizeof(comment)-1);
399 if (strlen(p) <= MAXPRINTERLEN && strlen(p)>strlen(name) && !has_punctuation)
401 if (!*comment) pstrcpy(comment,name);
406 if (!strchr_m(comment,' ') &&
407 strlen(p) > strlen(comment))
409 StrnCpy(comment,p,sizeof(comment)-1);
415 name[MAXPRINTERLEN] = 0;