/*
* "$Id$"
*
- * Line Printer Daemon backend for the Common UNIX Printing System (CUPS).
+ * Line Printer Daemon backend for CUPS.
*
+ * Copyright 2007-2010 by Apple Inc.
* Copyright 1997-2007 by Easy Software Products, all rights reserved.
*
* These coded instructions, statements, and computer programs are the
- * property of Easy Software Products and are protected by Federal
- * copyright law. Distribution and use rights are outlined in the file
+ * property of Apple Inc. and are protected by Federal copyright
+ * law. Distribution and use rights are outlined in the file "LICENSE.txt"
* "LICENSE" which should have been included with this file. If this
- * file is missing or damaged please contact Easy Software Products
- * at:
- *
- * Attn: CUPS Licensing Information
- * Easy Software Products
- * 44141 Airport View Drive, Suite 204
- * Hollywood, Maryland 20636 USA
- *
- * Voice: (301) 373-9600
- * EMail: cups-info@cups.org
- * WWW: http://www.cups.org
+ * file is missing or damaged, see the license at "http://www.cups.org/".
*
* This file is subject to the Apple OS-Developed Software exception.
*
* Include necessary headers.
*/
-#include <cups/backend.h>
#include <cups/http-private.h>
-#include <cups/cups.h>
-#include <stdio.h>
-#include <stdlib.h>
+#include "backend-private.h"
#include <stdarg.h>
-#include <ctype.h>
-#include <cups/string.h>
-#include <errno.h>
#include <sys/types.h>
#include <sys/stat.h>
-#include <signal.h>
+#include <stdio.h>
#ifdef WIN32
# include <winsock.h>
main(int argc, /* I - Number of command-line arguments (6 or 7) */
char *argv[]) /* I - Command-line arguments */
{
- char method[255], /* Method in URI */
- hostname[1024], /* Hostname */
- username[255], /* Username info */
- resource[1024], /* Resource info (printer name) */
- *options, /* Pointer to options */
- name[255], /* Name of option */
- value[255], /* Value of option */
- *ptr, /* Pointer into name or value */
- *filename, /* File to print */
- title[256]; /* Title string */
- int port; /* Port number */
- int fd; /* Print file */
- int status; /* Status of LPD job */
- int mode; /* Print mode */
- int banner; /* Print banner page? */
- int format; /* Print format */
- int order; /* Order of control/data files */
- int reserve; /* Reserve priviledged port? */
- int sanitize_title; /* Sanitize title string? */
- int manual_copies, /* Do manual copies? */
- timeout, /* Timeout */
- contimeout, /* Connection timeout */
- copies; /* Number of copies */
+ const char *device_uri; /* Device URI */
+ char scheme[255], /* Scheme in URI */
+ hostname[1024], /* Hostname */
+ username[255], /* Username info */
+ resource[1024], /* Resource info (printer name) */
+ *options, /* Pointer to options */
+ *name, /* Name of option */
+ *value, /* Value of option */
+ sep, /* Separator character */
+ *filename, /* File to print */
+ title[256]; /* Title string */
+ int port; /* Port number */
+ int fd; /* Print file */
+ int status; /* Status of LPD job */
+ int mode; /* Print mode */
+ int banner; /* Print banner page? */
+ int format; /* Print format */
+ int order; /* Order of control/data files */
+ int reserve; /* Reserve priviledged port? */
+ int sanitize_title; /* Sanitize title string? */
+ int manual_copies, /* Do manual copies? */
+ timeout, /* Timeout */
+ contimeout, /* Connection timeout */
+ copies; /* Number of copies */
#if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
- struct sigaction action; /* Actions for POSIX signals */
+ struct sigaction action; /* Actions for POSIX signals */
#endif /* HAVE_SIGACTION && !HAVE_SIGSET */
if (argc == 1)
{
- puts("network lpd \"Unknown\" \"LPD/LPR Host or Printer\"");
+ printf("network lpd \"Unknown\" \"%s\"\n",
+ _cupsLangString(cupsLangDefault(), _("LPD/LPR Host or Printer")));
return (CUPS_BACKEND_OK);
}
else if (argc < 6 || argc > 7)
{
- fprintf(stderr, "Usage: %s job-id user title copies options [file]\n",
- argv[0]);
+ _cupsLangPrintf(stderr,
+ _("Usage: %s job-id user title copies options [file]"),
+ argv[0]);
return (CUPS_BACKEND_FAILED);
}
* Extract the hostname and printer name from the URI...
*/
- httpSeparateURI(HTTP_URI_CODING_ALL, cupsBackendDeviceURI(argv),
- method, sizeof(method), username, sizeof(username),
- hostname, sizeof(hostname), &port,
+ if ((device_uri = cupsBackendDeviceURI(argv)) == NULL)
+ return (CUPS_BACKEND_FAILED);
+
+ httpSeparateURI(HTTP_URI_CODING_ALL, device_uri, scheme, sizeof(scheme),
+ username, sizeof(username), hostname, sizeof(hostname), &port,
resource, sizeof(resource));
+ if (!port)
+ port = 515; /* Default to port 515 */
+
if (!username[0])
{
/*
contimeout = 7 * 24 * 60 * 60;
#ifdef __APPLE__
- /* We want to pass utf-8 characters, not re-map them (3071945) */
+ /*
+ * We want to pass utf-8 characters, not re-map them (3071945)
+ */
+
sanitize_title = 0;
- /* Get the default timeout from a system preference... */
+ /*
+ * Get the default timeout from a system preference...
+ */
+
{
CFPropertyListRef pvalue; /* Preference value */
SInt32 toval; /* Timeout value */
* Get the name...
*/
- for (ptr = name; *options && *options != '=';)
- if (ptr < (name + sizeof(name) - 1))
- *ptr++ = *options++;
- *ptr = '\0';
+ name = options;
+
+ while (*options && *options != '=' && *options != '+' && *options != '&')
+ options ++;
+
+ if ((sep = *options) != '\0')
+ *options++ = '\0';
- if (*options == '=')
+ if (sep == '=')
{
/*
* Get the value...
*/
- options ++;
-
- for (ptr = value; *options && *options != '+' && *options != '&';)
- if (ptr < (value + sizeof(value) - 1))
- *ptr++ = *options++;
- *ptr = '\0';
+ value = options;
- if (*options == '+' || *options == '&')
+ while (*options && *options != '+' && *options != '&')
options ++;
+
+ if (*options)
+ *options++ = '\0';
}
else
- value[0] = '\0';
+ value = (char *)"";
/*
* Process the option...
if (strchr("cdfglnoprtv", value[0]))
format = value[0];
else
- fprintf(stderr, "ERROR: Unknown format character \"%c\"\n", value[0]);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Unknown format character: \"%c\"."),
+ value[0]);
}
else if (!strcasecmp(name, "mode") && value[0])
{
*/
if (!strcasecmp(value, "standard"))
- order = MODE_STANDARD;
+ mode = MODE_STANDARD;
else if (!strcasecmp(value, "stream"))
- order = MODE_STREAM;
+ mode = MODE_STREAM;
else
- fprintf(stderr, "ERROR: Unknown print mode \"%s\"\n", value);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Unknown print mode: \"%s\"."), value);
}
else if (!strcasecmp(name, "order") && value[0])
{
else if (!strcasecmp(value, "data,control"))
order = ORDER_DATA_CONTROL;
else
- fprintf(stderr, "ERROR: Unknown file order \"%s\"\n", value);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Unknown file order: \"%s\"."), value);
}
else if (!strcasecmp(name, "reserve"))
{
*/
sanitize_title = !value[0] || !strcasecmp(value, "on") ||
- !strcasecmp(value, "yes") || !strcasecmp(value, "true");
+ !strcasecmp(value, "yes") || !strcasecmp(value, "true");
}
else if (!strcasecmp(name, "timeout"))
{
else if (!strcasecmp(name, "contimeout"))
{
/*
- * Set the timeout...
+ * Set the connection timeout...
*/
if (atoi(value) > 0)
* Copy stdin to a temporary file...
*/
- char buffer[8192]; /* Buffer for copying */
- int bytes; /* Number of bytes read */
+ http_addrlist_t *addrlist; /* Address list */
+ int snmp_fd; /* SNMP socket */
+
+
+ fputs("STATE: +connecting-to-device\n", stderr);
+ fprintf(stderr, "DEBUG: Looking up \"%s\"...\n", hostname);
+
+ if ((addrlist = httpAddrGetList(hostname, AF_UNSPEC, "1")) == NULL)
+ {
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Unable to locate printer \"%s\"."), hostname);
+ return (CUPS_BACKEND_STOP);
+ }
+ snmp_fd = _cupsSNMPOpen(addrlist->addr.addr.sa_family);
if ((fd = cupsTempFd(tmpfilename, sizeof(tmpfilename))) < 0)
{
- perror("ERROR: unable to create temporary file");
+ perror("DEBUG: Unable to create temporary file");
return (CUPS_BACKEND_FAILED);
}
- while ((bytes = fread(buffer, 1, sizeof(buffer), stdin)) > 0)
- if (write(fd, buffer, bytes) < bytes)
- {
- perror("ERROR: unable to write to temporary file");
- close(fd);
- unlink(tmpfilename);
- return (CUPS_BACKEND_FAILED);
- }
+ _cupsLangPrintFilter(stderr, "INFO", _("Copying print data."));
- filename = tmpfilename;
+ backendRunLoop(-1, fd, snmp_fd, &(addrlist->addr), 0, 0,
+ backendNetworkSideCB);
+
+ if (snmp_fd >= 0)
+ _cupsSNMPClose(snmp_fd);
+
+ httpAddrFreeList(addrlist);
}
else if (argc == 6)
{
if (fd == -1)
{
- fprintf(stderr, "ERROR: Unable to open print file %s: %s\n",
- filename, strerror(errno));
+ _cupsLangPrintError("ERROR", _("Unable to open print file"));
return (CUPS_BACKEND_FAILED);
}
}
* the remote end...
*/
+ char *ptr;
+
for (ptr = title; *ptr; ptr ++)
if (!isalnum(*ptr & 255) && !isspace(*ptr & 255))
*ptr = '_';
if (lpd_write(fd, buf, bytes) < bytes)
{
- perror("ERROR: Unable to send LPD command");
+ perror("DEBUG: Unable to send LPD command");
return (-1);
}
* Read back the status from the command and return it...
*/
- fprintf(stderr, "DEBUG: Reading command status...\n");
+ fputs("DEBUG: Reading command status...\n", stderr);
alarm(timeout);
if (recv(fd, &status, 1, 0) < 1)
{
- fprintf(stderr, "WARNING: Remote host did not respond with command "
- "status byte after %d seconds!\n", timeout);
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Printer did not respond after %d seconds."),
+ timeout);
status = errno;
}
*cptr; /* Pointer into control file string */
char status; /* Status byte from command */
char portname[255]; /* Port name */
+ int delay; /* Delay for retries... */
char addrname[256]; /* Address name */
http_addrlist_t *addrlist, /* Address list */
*addr; /* Socket address */
+ int snmp_fd, /* SNMP socket */
+ have_supplies; /* Printer supports supply levels? */
int copy; /* Copies written */
time_t start_time; /* Time of first connect */
-#ifdef __APPLE__
- int recoverable; /* Recoverable error shown? */
-#endif /* __APPLE__ */
size_t nbytes; /* Number of bytes written */
off_t tbytes; /* Total bytes written */
char buffer[32768]; /* Output buffer */
sprintf(portname, "%d", port);
+ fputs("STATE: +connecting-to-device\n", stderr);
+ fprintf(stderr, "DEBUG: Looking up \"%s\"...\n", hostname);
+
if ((addrlist = httpAddrGetList(hostname, AF_UNSPEC, portname)) == NULL)
{
- fprintf(stderr, "ERROR: Unable to locate printer \'%s\'!\n",
- hostname);
+ _cupsLangPrintFilter(stderr, "ERROR", _("Unable to locate printer \"%s\"."),
+ hostname);
return (CUPS_BACKEND_STOP);
}
/*
- * Remember when we starting trying to connect to the printer...
+ * Remember when we started trying to connect to the printer...
*/
-#ifdef __APPLE__
- recoverable = 0;
-#endif /* __APPLE__ */
- start_time = time(NULL);
+ start_time = time(NULL);
/*
* Loop forever trying to print the file...
* First try to reserve a port for this connection...
*/
- fputs("STATE: +connecting-to-device\n", stderr);
- fprintf(stderr, "INFO: Attempting to connect to host %s for printer %s\n",
- hostname, printer);
+ fprintf(stderr, "DEBUG: Connecting to %s:%d for printer %s\n", hostname,
+ port, printer);
+ _cupsLangPrintFilter(stderr, "INFO", _("Connecting to printer."));
- for (lport = reserve == RESERVE_RFC1179 ? 732 : 1024, addr = addrlist;;
+ for (lport = reserve == RESERVE_RFC1179 ? 732 : 1024, addr = addrlist,
+ delay = 5;;
addr = addr->next)
{
/*
if ((fd = socket(addr->addr.addr.sa_family, SOCK_STREAM, 0)) < 0)
{
- perror("ERROR: Unable to create socket");
+ perror("DEBUG: Unable to create socket");
sleep(1);
continue;
if ((fd = rresvport_af(&lport, addr->addr.addr.sa_family)) < 0)
{
- perror("ERROR: Unable to reserve port");
+ perror("DEBUG: Unable to reserve port");
sleep(1);
continue;
error = errno;
close(fd);
- fd = -1;
if (addr->next)
continue;
* available printer in the class.
*/
- fprintf(stderr, "INFO: Unable to connect to %s, queuing on next printer in class...\n",
- hostname);
+ _cupsLangPrintFilter(stderr, "INFO",
+ _("Unable to contact printer, queuing on next "
+ "printer in class."));
httpAddrFreeList(addrlist);
return (CUPS_BACKEND_FAILED);
}
+ fprintf(stderr, "DEBUG: Connection error: %s\n", strerror(error));
+
if (error == ECONNREFUSED || error == EHOSTDOWN ||
error == EHOSTUNREACH)
{
if (contimeout && (time(NULL) - start_time) > contimeout)
{
- fputs("ERROR: Printer not responding!\n", stderr);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("The printer is not responding."));
return (CUPS_BACKEND_FAILED);
}
-#ifdef __APPLE__
- recoverable = 1;
- fprintf(stderr, "WARNING: recoverable: "
- "Network host \'%s\' is busy, down, or "
- "unreachable; will retry in 30 seconds...\n",
- hostname);
-#else
- fprintf(stderr, "WARNING: "
- "Network host \'%s\' is busy, down, or "
- "unreachable; will retry in 30 seconds...\n",
- hostname);
-#endif /* __APPLE__ */
- sleep(30);
+ switch (error)
+ {
+ case EHOSTDOWN :
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Network printer \"%s\" may not exist or "
+ "is unavailable at this time."),
+ hostname);
+ break;
+
+ case EHOSTUNREACH :
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Network printer \"%s\" is unreachable at "
+ "this time."), hostname);
+ break;
+
+ case ECONNREFUSED :
+ default :
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Network printer \"%s\" is busy."),
+ hostname);
+ break;
+ }
+
+ sleep(delay);
+
+ if (delay < 30)
+ delay += 5;
}
else if (error == EADDRINUSE)
{
}
else
{
-#ifdef __APPLE__
- recoverable = 1;
- perror("ERROR: recoverable: "
- "Unable to connect to printer; will retry in 30 seconds...");
-#else
- perror("ERROR: "
- "Unable to connect to printer; will retry in 30 seconds...");
-#endif /* __APPLE__ */
- sleep(30);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Network printer \"%s\" is not responding."),
+ hostname);
+ sleep(30);
}
}
-#ifdef __APPLE__
- if (recoverable)
- {
- /*
- * If we've shown a recoverable error make sure the printer proxies
- * have a chance to see the recovered message. Not pretty but
- * necessary for now...
- */
-
- fputs("INFO: recovered: \n", stderr);
- sleep(5);
- }
-#endif /* __APPLE__ */
-
fputs("STATE: -connecting-to-device\n", stderr);
- fprintf(stderr, "INFO: Connected to %s...\n", hostname);
+ _cupsLangPrintFilter(stderr, "INFO", _("Connected to printer."));
#ifdef AF_INET6
if (addr->addr.addr.sa_family == AF_INET6)
fprintf(stderr, "DEBUG: Connected to [%s]:%d (IPv6) (local port %d)...\n",
- httpAddrString(&addr->addr, addrname, sizeof(addrname)),
- ntohs(addr->addr.ipv6.sin6_port), lport);
+ httpAddrString(&addr->addr, addrname, sizeof(addrname)),
+ ntohs(addr->addr.ipv6.sin6_port), lport);
else
#endif /* AF_INET6 */
if (addr->addr.addr.sa_family == AF_INET)
fprintf(stderr, "DEBUG: Connected to %s:%d (IPv4) (local port %d)...\n",
- httpAddrString(&addr->addr, addrname, sizeof(addrname)),
- ntohs(addr->addr.ipv4.sin_port), lport);
+ httpAddrString(&addr->addr, addrname, sizeof(addrname)),
+ ntohs(addr->addr.ipv4.sin_port), lport);
+
+ /*
+ * See if the printer supports SNMP...
+ */
+
+ if ((snmp_fd = _cupsSNMPOpen(addr->addr.addr.sa_family)) >= 0)
+ have_supplies = !backendSNMPSupplies(snmp_fd, &(addr->addr), NULL, NULL);
+ else
+ have_supplies = 0;
+
+ /*
+ * Check for side-channel requests...
+ */
+
+ backendCheckSideChannel(snmp_fd, &(addr->addr));
/*
* Next, open the print file and figure out its size...
if (print_fd)
{
+ /*
+ * Use the size from the print file...
+ */
+
if (fstat(print_fd, &filestats))
{
httpAddrFreeList(addrlist);
close(fd);
- perror("ERROR: unable to stat print file");
+ perror("DEBUG: unable to stat print file");
return (CUPS_BACKEND_FAILED);
}
filestats.st_size *= manual_copies;
}
else
+ {
+ /*
+ * Use a "very large value" for the size so that the printer will
+ * keep printing until we close the connection...
+ */
+
#ifdef _LARGEFILE_SOURCE
filestats.st_size = (size_t)(999999999999.0);
#else
filestats.st_size = 2147483647;
#endif /* _LARGEFILE_SOURCE */
+ }
/*
* Send a job header to the printer, specifying no banner page and
if (order == ORDER_CONTROL_DATA)
{
+ /*
+ * Check for side-channel requests...
+ */
+
+ backendCheckSideChannel(snmp_fd, &(addr->addr));
+
+ /*
+ * Send the control file...
+ */
+
if (lpd_command(fd, timeout, "\002%d cfA%03.3d%.15s\n", strlen(control),
(int)getpid() % 1000, localhost))
{
return (CUPS_BACKEND_FAILED);
}
- fprintf(stderr, "INFO: Sending control file (%u bytes)\n",
- (unsigned)strlen(control));
+ fprintf(stderr, "DEBUG: Sending control file (%u bytes)\n",
+ (unsigned)strlen(control));
if (lpd_write(fd, control, strlen(control) + 1) < (strlen(control) + 1))
{
status = errno;
- perror("ERROR: Unable to write control file");
+ perror("DEBUG: Unable to write control file");
+
}
else
{
if (read(fd, &status, 1) < 1)
{
- fprintf(stderr, "WARNING: Remote host did not respond with control "
- "status byte after %d seconds!\n", timeout);
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Printer did not respond after %d seconds."),
+ timeout);
status = errno;
}
}
if (status != 0)
- fprintf(stderr, "ERROR: Remote host did not accept control file (%d)\n",
- status);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Remote host did not accept control file (%d)."),
+ status);
else
- fputs("INFO: Control file sent successfully\n", stderr);
+ _cupsLangPrintFilter(stderr, "INFO",
+ _("Control file sent successfully."));
}
else
status = 0;
if (status == 0)
{
+ /*
+ * Check for side-channel requests...
+ */
+
+ backendCheckSideChannel(snmp_fd, &(addr->addr));
+
/*
* Send the print file...
*/
return (CUPS_BACKEND_FAILED);
}
- fprintf(stderr, "INFO: Sending data file (" CUPS_LLFMT " bytes)\n",
- CUPS_LLCAST filestats.st_size);
+ fprintf(stderr, "DEBUG: Sending data file (" CUPS_LLFMT " bytes)\n",
+ CUPS_LLCAST filestats.st_size);
tbytes = 0;
for (copy = 0; copy < manual_copies; copy ++)
while ((nbytes = read(print_fd, buffer, sizeof(buffer))) > 0)
{
- fprintf(stderr, "INFO: Spooling LPR job, %.0f%% complete...\n",
- 100.0 * tbytes / filestats.st_size);
+ _cupsLangPrintFilter(stderr, "INFO",
+ _("Spooling job, %.0f%% complete."),
+ 100.0 * tbytes / filestats.st_size);
if (lpd_write(fd, buffer, nbytes) < nbytes)
{
- perror("ERROR: Unable to send print file to printer");
+ perror("DEBUG: Unable to send print file to printer");
break;
}
else
status = errno;
else if (lpd_write(fd, "", 1) < 1)
{
- perror("ERROR: Unable to send trailing nul to printer");
+ perror("DEBUG: Unable to send trailing nul to printer");
status = errno;
}
else
if (recv(fd, &status, 1, 0) < 1)
{
- fprintf(stderr, "WARNING: Remote host did not respond with data "
- "status byte after %d seconds!\n", timeout);
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Printer did not respond after %d seconds."),
+ timeout);
status = 0;
}
status = 0;
if (status != 0)
- fprintf(stderr, "ERROR: Remote host did not accept data file (%d)\n",
- status);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Remote host did not accept data file (%d)."),
+ status);
else
- fputs("INFO: Data file sent successfully\n", stderr);
+ _cupsLangPrintFilter(stderr, "INFO",
+ _("Data file sent successfully."));
}
if (status == 0 && order == ORDER_DATA_CONTROL)
{
+ /*
+ * Check for side-channel requests...
+ */
+
+ backendCheckSideChannel(snmp_fd, &(addr->addr));
+
+ /*
+ * Send control file...
+ */
+
if (lpd_command(fd, timeout, "\002%d cfA%03.3d%.15s\n", strlen(control),
(int)getpid() % 1000, localhost))
{
return (CUPS_BACKEND_FAILED);
}
- fprintf(stderr, "INFO: Sending control file (%lu bytes)\n",
- (unsigned long)strlen(control));
+ fprintf(stderr, "DEBUG: Sending control file (%lu bytes)\n",
+ (unsigned long)strlen(control));
if (lpd_write(fd, control, strlen(control) + 1) < (strlen(control) + 1))
{
status = errno;
- perror("ERROR: Unable to write control file");
+ perror("DEBUG: Unable to write control file");
}
else
{
if (read(fd, &status, 1) < 1)
{
- fprintf(stderr, "WARNING: Remote host did not respond with control "
- "status byte after %d seconds!\n", timeout);
+ _cupsLangPrintFilter(stderr, "WARNING",
+ _("Printer did not respond after %d seconds."),
+ timeout);
status = errno;
}
}
if (status != 0)
- fprintf(stderr, "ERROR: Remote host did not accept control file (%d)\n",
- status);
+ _cupsLangPrintFilter(stderr, "ERROR",
+ _("Remote host did not accept control file (%d)."),
+ status);
else
- fputs("INFO: Control file sent successfully\n", stderr);
+ _cupsLangPrintFilter(stderr, "INFO",
+ _("Control file sent successfully."));
}
+ /*
+ * Collect the final supply levels as needed...
+ */
+
+ if (have_supplies)
+ backendSNMPSupplies(snmp_fd, &(addr->addr), NULL, NULL);
+
/*
* Close the socket connection and input file...
*/