]>
git.ipfire.org Git - thirdparty/cups.git/blob - cups/backend.c
4 * Backend functions for CUPS.
6 * Copyright 2007-2012 by Apple Inc.
7 * Copyright 2006 by Easy Software Products.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
19 * cupsBackendDeviceURI() - Get the device URI for a backend.
20 * cupsBackendReport() - Write a device line from a backend.
21 * quote_string() - Write a quoted string to stdout, escaping \ and ".
25 * Include necessary headers...
28 #include "cups-private.h"
36 static void quote_string(const char *s
);
40 * 'cupsBackendDeviceURI()' - Get the device URI for a backend.
42 * The "argv" argument is the argv argument passed to main(). This
43 * function returns the device URI passed in the DEVICE_URI environment
44 * variable or the device URI passed in argv[0], whichever is found
47 * @since CUPS 1.2/OS X 10.5@
50 const char * /* O - Device URI or @code NULL@ */
51 cupsBackendDeviceURI(char **argv
) /* I - Command-line arguments */
53 const char *device_uri
, /* Device URI */
54 *auth_info_required
; /* AUTH_INFO_REQUIRED env var */
55 _cups_globals_t
*cg
= _cupsGlobals(); /* Global info */
56 int options
; /* Resolve options */
57 ppd_file_t
*ppd
; /* PPD file */
58 ppd_attr_t
*ppdattr
; /* PPD attribute */
61 if ((device_uri
= getenv("DEVICE_URI")) == NULL
)
63 if (!argv
|| !argv
[0] || !strchr(argv
[0], ':'))
69 options
= _HTTP_RESOLVE_STDERR
;
70 if ((auth_info_required
= getenv("AUTH_INFO_REQUIRED")) != NULL
&&
71 !strcmp(auth_info_required
, "negotiate"))
72 options
|= _HTTP_RESOLVE_FQDN
;
74 if ((ppd
= ppdOpenFile(getenv("PPD"))) != NULL
)
76 if ((ppdattr
= ppdFindAttr(ppd
, "cupsIPPFaxOut", NULL
)) != NULL
&&
77 !_cups_strcasecmp(ppdattr
->value
, "true"))
78 options
|= _HTTP_RESOLVE_FAXOUT
;
83 return (_httpResolveURI(device_uri
, cg
->resolved_uri
,
84 sizeof(cg
->resolved_uri
), options
, NULL
, NULL
));
89 * 'cupsBackendReport()' - Write a device line from a backend.
91 * This function writes a single device line to stdout for a backend.
92 * It handles quoting of special characters in the device-make-and-model,
93 * device-info, device-id, and device-location strings.
95 * @since CUPS 1.4/OS X 10.6@
100 const char *device_scheme
, /* I - device-scheme string */
101 const char *device_uri
, /* I - device-uri string */
102 const char *device_make_and_model
, /* I - device-make-and-model string or @code NULL@ */
103 const char *device_info
, /* I - device-info string or @code NULL@ */
104 const char *device_id
, /* I - device-id string or @code NULL@ */
105 const char *device_location
) /* I - device-location string or @code NULL@ */
107 if (!device_scheme
|| !device_uri
)
110 printf("%s %s", device_scheme
, device_uri
);
111 if (device_make_and_model
&& *device_make_and_model
)
112 quote_string(device_make_and_model
);
114 quote_string("unknown");
115 quote_string(device_info
);
116 quote_string(device_id
);
117 quote_string(device_location
);
124 * 'quote_string()' - Write a quoted string to stdout, escaping \ and ".
128 quote_string(const char *s
) /* I - String to write */
130 fputs(" \"", stdout
);
136 if (*s
== '\\' || *s
== '\"')
139 if (((*s
& 255) < ' ' && *s
!= '\t') || *s
== 0x7f)