#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: cups 1.4b2\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2009-01-10 21:21-0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Translate Toolkit 1.2.1\n"

#: ./api-filter.html:1
msgid "Filter and Backend Programming"
msgstr ""

#: ./api-filter.html:2
msgid "Programming"
msgstr ""

#: ./api-filter.html:3
msgid "Mini-XML v2.6"
msgstr ""

#: ./api-filter.html:4
msgid "General Information"
msgstr ""

#: ./api-filter.html:5
msgid "Headers"
msgstr ""

#: ./api-filter.html:6
msgid "cups/backend.h<br> \tcups/sidechannel.h"
msgstr ""

#: ./api-filter.html:7
msgid "Library"
msgstr ""

#: ./api-filter.html:8
msgid "-lcups"
msgstr ""

#: ./api-filter.html:9
msgid "See Also"
msgstr ""

#: ./api-filter.html:10
msgid ""
"Programming: <a href='api-overview.html' target='_top'>Introduction to CUPS "
"Programming</a><br> \tProgramming: <a href='api-cups.html' target='_top'>CUPS "
"API</a><br> \tProgramming: <a href='api-ppd.html' target='_top'>PPD "
"API</a><br> \tProgramming: <a href='api-raster.html' target='_top'>Raster "
"API</a><br> \tSpecifications: <a href='spec-design' target='_top'>CUPS Design "
"Description</a>"
msgstr ""

#: ./api-filter.html:11
msgid "Contents"
msgstr ""

#: ./api-filter.html:12
msgctxt "./api-filter.html:12"
msgid "Overview"
msgstr ""

#: ./api-filter.html:13
msgctxt "./api-filter.html:13"
msgid "Security Considerations"
msgstr ""

#: ./api-filter.html:14
msgctxt "./api-filter.html:14"
msgid "Temporary Files"
msgstr ""

#: ./api-filter.html:15
msgctxt "./api-filter.html:15"
msgid "Copy Generation"
msgstr ""

#: ./api-filter.html:16
msgctxt "./api-filter.html:16"
msgid "Exit Codes"
msgstr ""

#: ./api-filter.html:17
msgctxt "./api-filter.html:17"
msgid "Environment Variables"
msgstr ""

#: ./api-filter.html:18
msgctxt "./api-filter.html:18"
msgid "Communicating with the Scheduler"
msgstr ""

#: ./api-filter.html:19
msgctxt "./api-filter.html:19"
msgid "Communicating with the Backend"
msgstr ""

#: ./api-filter.html:20
msgctxt "./api-filter.html:20"
msgid "Communicating with Filters"
msgstr ""

#: ./api-filter.html:21
msgctxt "./api-filter.html:21"
msgid "Doing SNMP Queries with Network Printers"
msgstr ""

#: ./api-filter.html:22
msgctxt "./api-filter.html:22"
msgid "Functions"
msgstr ""

#: ./api-filter.html:23
msgid "cupsBackChannelRead"
msgstr ""

#: ./api-filter.html:24
msgid "cupsBackChannelWrite"
msgstr ""

#: ./api-filter.html:25
msgid "cupsBackendDeviceURI"
msgstr ""

#: ./api-filter.html:26
msgid "cupsBackendReport"
msgstr ""

#: ./api-filter.html:27
msgid "cupsSideChannelDoRequest"
msgstr ""

#: ./api-filter.html:28
msgid "cupsSideChannelRead"
msgstr ""

#: ./api-filter.html:29
msgid "cupsSideChannelSNMPGet"
msgstr ""

#: ./api-filter.html:30
msgid "cupsSideChannelSNMPWalk"
msgstr ""

#: ./api-filter.html:31
msgid "cupsSideChannelWrite"
msgstr ""

#: ./api-filter.html:32
msgctxt "./api-filter.html:32"
msgid "Data Types"
msgstr ""

#: ./api-filter.html:33
msgctxt "./api-filter.html:33"
msgid "cups_backend_t"
msgstr ""

#: ./api-filter.html:34
msgctxt "./api-filter.html:34"
msgid "cups_sc_bidi_t"
msgstr ""

#: ./api-filter.html:35
msgctxt "./api-filter.html:35"
msgid "cups_sc_command_t"
msgstr ""

#: ./api-filter.html:36
msgctxt "./api-filter.html:36"
msgid "cups_sc_state_t"
msgstr ""

#: ./api-filter.html:37
msgctxt "./api-filter.html:37"
msgid "cups_sc_status_t"
msgstr ""

#: ./api-filter.html:38
msgctxt "./api-filter.html:38"
msgid "cups_sc_walk_func_t"
msgstr ""

#: ./api-filter.html:39
msgctxt "./api-filter.html:39"
msgid "Constants"
msgstr ""

#: ./api-filter.html:40
msgctxt "./api-filter.html:40"
msgid "cups_backend_e"
msgstr ""

#: ./api-filter.html:41
msgctxt "./api-filter.html:41"
msgid "cups_sc_bidi_e"
msgstr ""

#: ./api-filter.html:42
msgctxt "./api-filter.html:42"
msgid "cups_sc_command_e"
msgstr ""

#: ./api-filter.html:43
msgctxt "./api-filter.html:43"
msgid "cups_sc_state_e"
msgstr ""

#: ./api-filter.html:44
msgctxt "./api-filter.html:44"
msgid "cups_sc_status_e"
msgstr ""

#: ./api-filter.html:45
msgctxt "./api-filter.html:45"
msgid "Overview"
msgstr ""

#: ./api-filter.html:46
msgid ""
"Filters (which include printer drivers and port monitors) and backends are "
"used to convert job files to a printable format and send that data to the "
"printer itself. All of these programs use a common interface for processing "
"print jobs and communicating status information to the scheduler. Each is "
"run with a standard set of command-line arguments:"
msgstr ""

#: ./api-filter.html:47
msgid "argv[1]"
msgstr ""

#: ./api-filter.html:48
msgid "The job ID"
msgstr ""

#: ./api-filter.html:49
msgid "argv[2]"
msgstr ""

#: ./api-filter.html:50
msgid "The user printing the job"
msgstr ""

#: ./api-filter.html:51
msgid "argv[3]"
msgstr ""

#: ./api-filter.html:52
msgid "The job name/title"
msgstr ""

#: ./api-filter.html:53
msgid "argv[4]"
msgstr ""

#: ./api-filter.html:54
msgid "The number of copies to print"
msgstr ""

#: ./api-filter.html:55
msgid "argv[5]"
msgstr ""

#: ./api-filter.html:56
msgid "The options that were provided when the job was submitted"
msgstr ""

#: ./api-filter.html:57
msgid "argv[6]"
msgstr ""

#: ./api-filter.html:58
msgid "The file to print (first program only)"
msgstr ""

#: ./api-filter.html:59
msgid ""
"The scheduler runs one or more of these programs to print any given job. The "
"first filter reads from the print file and writes to the standard output, "
"while the remaining filters read from the standard input and write to the "
"standard output. The backend is the last filter in the chain and writes to "
"the device."
msgstr ""

#: ./api-filter.html:60
msgctxt "./api-filter.html:60"
msgid "Security Considerations"
msgstr ""

#: ./api-filter.html:61
msgid ""
"It is always important to use security programming practices. Filters and "
"most backends are run as a non-priviledged user, so the major security "
"consideration is resource utilization - filters should not depend on "
"unlimited amounts of CPU, memory, or disk space, and should protect against "
"conditions that could lead to excess usage of any resource like infinite "
"loops and unbounded recursion. In addition, filters must <em>never</em> "
"allow the user to specify an arbitrary file path to a separator page, "
"template, or other file used by the filter since that can lead to an "
"unauthorized disclosure of information. <em>Always</em> treat input as "
"suspect and validate it!"
msgstr ""

#: ./api-filter.html:62
msgid ""
"If you are developing a backend that runs as root, make sure to check for "
"potential buffer overflows, integer under/overflow conditions, and file "
"accesses since these can lead to privilege escalations. When writing files, "
"always validate the file path and <em>never</em> allow a user to determine "
"where to store a file."
msgstr ""

#: ./api-filter.html:63
msgid ""
"<em>Never</em> write files to a user's home directory. Aside from the "
"security implications, CUPS is a network print service and as such the "
"network user may not be the same as the local user and/or there may not be a "
"local home directory to write to."
msgstr ""

#: ./api-filter.html:64
msgid ""
"In addition, some operating systems provide additional security mechanisms "
"that further limit file system access, even for backends running as root.  "
"On Mac OS X, for example, no backend may write to a user's home directory."
msgstr ""

#: ./api-filter.html:65
msgctxt "./api-filter.html:65"
msgid "Temporary Files"
msgstr ""

#: ./api-filter.html:66
msgid ""
"Temporary files should be created in the directory specified by the \"TMPDIR\" "
"environment variable. The <a "
"href=\"#cupsTempFile2\"><code>cupsTempFile2</code></a> function can be used to "
"safely create temporary files in this directory."
msgstr ""

#: ./api-filter.html:67
msgctxt "./api-filter.html:67"
msgid "Copy Generation"
msgstr ""

#: ./api-filter.html:68
msgid ""
"The <code>argv[4]</code> argument specifies the number of copies to produce "
"of the input file. In general, you should only generate copies if the "
"<em>filename</em> argument is supplied. The only exception to this are "
"filters that produce device-independent PostScript output, since the "
"PostScript filter <var>pstops</var> is responsible for generating copies of "
"PostScript files."
msgstr ""

#: ./api-filter.html:69
msgctxt "./api-filter.html:69"
msgid "Exit Codes"
msgstr ""

#: ./api-filter.html:70
msgid ""
"Filters must exit with status 0 when they successfully generate print data "
"or 1 when they encounter an error. Backends can return any of the <a "
"href=\"#cups_backend_t\"><code>cups_backend_t</code></a> constants."
msgstr ""

#: ./api-filter.html:71
msgctxt "./api-filter.html:71"
msgid "Environment Variables"
msgstr ""

#: ./api-filter.html:72
msgid ""
"The following environment variables are defined by the printing system when "
"running print filters and backends:"
msgstr ""

#: ./api-filter.html:73
msgid "APPLE_LANGUAGES"
msgstr ""

#: ./api-filter.html:74
msgid "The Apple language identifier associated with the job \t(Mac OS X only)."
msgstr ""

#: ./api-filter.html:75
msgid "CHARSET"
msgstr ""

#: ./api-filter.html:76
msgid "The job character set, typically \"utf-8\"."
msgstr ""

#: ./api-filter.html:77
msgid "CLASS"
msgstr ""

#: ./api-filter.html:78
msgid ""
"When a job is submitted to a printer class, contains the name of \tthe "
"destination printer class. Otherwise this environment \tvariable will not be "
"set."
msgstr ""

#: ./api-filter.html:79
msgid "CONTENT_TYPE"
msgstr ""

#: ./api-filter.html:80
msgid "The MIME type associated with the file (e.g. \tapplication/postscript)."
msgstr ""

#: ./api-filter.html:81
msgid "CUPS_CACHEDIR"
msgstr ""

#: ./api-filter.html:82
msgid ""
"The directory where cache files can be stored. Cache files can be \tused to "
"retain information between jobs or files in a job."
msgstr ""

#: ./api-filter.html:83
msgid "CUPS_DATADIR"
msgstr ""

#: ./api-filter.html:84
msgid "The directory where (read-only) CUPS data files can be found."
msgstr ""

#: ./api-filter.html:85
msgid "CUPS_FILETYPE"
msgstr ""

#: ./api-filter.html:86
msgid ""
"The type of file being printed: \"job-sheet\" for a banner page and \t"
"\"document\" for a regular print file."
msgstr ""

#: ./api-filter.html:87
msgid "CUPS_SERVERROOT"
msgstr ""

#: ./api-filter.html:88
msgid "The root directory of the server."
msgstr ""

#: ./api-filter.html:89
msgid "DEVICE_URI"
msgstr ""

#: ./api-filter.html:90
msgid "The device-uri associated with the printer."
msgstr ""

#: ./api-filter.html:91
msgid "FINAL_CONTENT_TYPE"
msgstr ""

#: ./api-filter.html:92
msgid ""
"The MIME type associated with the printer (e.g. \tapplication/vnd.cups-"
"postscript)."
msgstr ""

#: ./api-filter.html:93
msgid "LANG"
msgstr ""

#: ./api-filter.html:94
msgid "The language locale associated with the job."
msgstr ""

#: ./api-filter.html:95
msgid "PPD"
msgstr ""

#: ./api-filter.html:96
msgid ""
"The full pathname of the PostScript Printer Description (PPD) \tfile for this "
"printer."
msgstr ""

#: ./api-filter.html:97
msgid "PRINTER"
msgstr ""

#: ./api-filter.html:98
msgid "The queue name of the class or printer."
msgstr ""

#: ./api-filter.html:99
msgid "RIP_CACHE"
msgstr ""

#: ./api-filter.html:100
msgid ""
"The recommended amount of memory to use for Raster Image \tProcessors (RIPs)."
msgstr ""

#: ./api-filter.html:101
msgid "TMPDIR"
msgstr ""

#: ./api-filter.html:102
msgid "The directory where temporary files should be created."
msgstr ""

#: ./api-filter.html:103
msgctxt "./api-filter.html:103"
msgid "Communicating with the Scheduler"
msgstr ""

#: ./api-filter.html:104
msgid ""
"Filters and backends communicate with the scheduler by writing messages to "
"the standard error file. The scheduler reads messages from all filters in a "
"job and processes the message based on its prefix. For example, the "
"following code sets the current printer state message to \"Printing page 5\":"
msgstr ""

#: ./api-filter.html:105
msgid ""
"Each message is a single line of text starting with one of the following "
"prefix strings:"
msgstr ""

#: ./api-filter.html:106
msgid "ALERT: message"
msgstr ""

#: ./api-filter.html:107
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"alert\" log level."
msgstr ""

#: ./api-filter.html:108
msgid "ATTR: attribute=value [attribute=value]"
msgstr ""

#: ./api-filter.html:109
msgid ""
"Sets the named printer or job attribute(s). Typically this is used \tto set "
"the <code>marker-colors</code>, <code>marker-levels</code>, \t<code>marker-"
"message</code>, <code>marker-names</code>, \t<code>marker-types</code>, <code"
">printer-alert</code>, and \t<code>printer-alert-description</code> printer "
"attributes. Standard \t<code>marker-types</code> values are listed in <a "
"href='#TABLE1'>Table \t1</a>."
msgstr ""

#: ./api-filter.html:110
msgid "CRIT: message"
msgstr ""

#: ./api-filter.html:111
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"critical\" log \tlevel."
msgstr ""

#: ./api-filter.html:112
msgid "DEBUG: message"
msgstr ""

#: ./api-filter.html:113
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"debug\" log level."
msgstr ""

#: ./api-filter.html:114
msgid "DEBUG2: message"
msgstr ""

#: ./api-filter.html:115
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"debug2\" log level."
msgstr ""

#: ./api-filter.html:116
msgid "EMERG: message"
msgstr ""

#: ./api-filter.html:117
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"emergency\" log \tlevel."
msgstr ""

#: ./api-filter.html:118
msgid "ERROR: message"
msgstr ""

#: ./api-filter.html:119
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"error\" log level. \tUse \"ERROR:\" "
"messages for non-persistent processing errors."
msgstr ""

#: ./api-filter.html:120
msgid "INFO: message"
msgstr ""

#: ./api-filter.html:121
msgid ""
"Sets the printer-state-message attribute. If the current log level \tis set "
"to \"debug2\", also adds the specified message to the current error \tlog file "
"using the \"info\" log level."
msgstr ""

#: ./api-filter.html:122
msgid "NOTICE: message"
msgstr ""

#: ./api-filter.html:123
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"notice\" log level."
msgstr ""

#: ./api-filter.html:124
msgid "PAGE: page-number #-copies"
msgstr ""

#: ./api-filter.html:125
msgid "PAGE: total #-pages"
msgstr ""

#: ./api-filter.html:126
msgid ""
"Adds an entry to the current page log file. The first form adds \t#-copies to "
"the job-media-sheets-completed attribute. The second \tform sets the job-"
"media-sheets-completed attribute to #-pages."
msgstr ""

#: ./api-filter.html:127
msgid "PPD: keyword=value [keyword=value ...]"
msgstr ""

#: ./api-filter.html:128
msgid ""
"Changes or adds keywords to the printer's PPD file. Typically \tthis is used "
"to update installable options or default media settings \tbased on the "
"printer configuration."
msgstr ""

#: ./api-filter.html:129
msgid "STATE: printer-state-reason [printer-state-reason ...]"
msgstr ""

#: ./api-filter.html:130
msgid "STATE: + printer-state-reason [printer-state-reason ...]"
msgstr ""

#: ./api-filter.html:131
msgid "STATE: - printer-state-reason [printer-state-reason ...]"
msgstr ""

#: ./api-filter.html:132
msgid ""
"Sets, adds, or removes printer-state-reason keywords to the \tcurrent queue. "
"Typically this is used to indicate persistent media, \tink, toner, and "
"configuration conditions or errors on a printer. \t<a href='#TABLE2'>Table "
"2</a> lists the standard state keywords - \tuse vendor-prefixed "
"(\"com.acme.foo\") keywords for custom states."
msgstr ""

#: ./api-filter.html:133
msgid "WARNING: message"
msgstr ""

#: ./api-filter.html:134
msgid ""
"Sets the printer-state-message attribute and adds the specified \tmessage to "
"the current error log file using the \"warning\" log \tlevel."
msgstr ""

#: ./api-filter.html:135
msgid ""
"Messages without one of these prefixes are treated as if they began with the "
"\"DEBUG:\" prefix string."
msgstr ""

#: ./api-filter.html:136
msgid "Table 1: Standard marker-types Values"
msgstr ""

#: ./api-filter.html:137
msgid "Table 1: <a name='TABLE1'>Standard marker-types Values</a>"
msgstr ""

#: ./api-filter.html:138
msgid "marker-type"
msgstr ""

#: ./api-filter.html:139
msgctxt "./api-filter.html:139"
msgid "Description"
msgstr ""

#: ./api-filter.html:140
msgid "developer"
msgstr ""

#: ./api-filter.html:141
msgid "Developer unit"
msgstr ""

#: ./api-filter.html:142
msgid "fuser"
msgstr ""

#: ./api-filter.html:143
msgid "Fuser unit"
msgstr ""

#: ./api-filter.html:144
msgid "fuserCleaningPad"
msgstr ""

#: ./api-filter.html:145
msgid "Fuser cleaning pad"
msgstr ""

#: ./api-filter.html:146
msgid "fuserOil"
msgstr ""

#: ./api-filter.html:147
msgid "Fuser oil"
msgstr ""

#: ./api-filter.html:148
msgid "ink"
msgstr ""

#: ./api-filter.html:149
msgid "Ink supply"
msgstr ""

#: ./api-filter.html:150
msgid "opc"
msgstr ""

#: ./api-filter.html:151
msgid "Photo conductor"
msgstr ""

#: ./api-filter.html:152
msgid "solidWax"
msgstr ""

#: ./api-filter.html:153
msgid "Wax supply"
msgstr ""

#: ./api-filter.html:154
msgid "staples"
msgstr ""

#: ./api-filter.html:155
msgid "Staple supply"
msgstr ""

#: ./api-filter.html:156
msgid "toner"
msgstr ""

#: ./api-filter.html:157
msgid "Toner supply"
msgstr ""

#: ./api-filter.html:158
msgid "transferUnit"
msgstr ""

#: ./api-filter.html:159
msgid "Transfer unit"
msgstr ""

#: ./api-filter.html:160
msgid "wasteInk"
msgstr ""

#: ./api-filter.html:161
msgid "Waste ink tank"
msgstr ""

#: ./api-filter.html:162
msgid "wasteToner"
msgstr ""

#: ./api-filter.html:163
msgid "Waste toner tank"
msgstr ""

#: ./api-filter.html:164
msgid "wasteWax"
msgstr ""

#: ./api-filter.html:165
msgid "Waste wax tank"
msgstr ""

#: ./api-filter.html:166
msgid "Table 2: Standard State Keywords"
msgstr ""

#: ./api-filter.html:167
msgid "Table 2: <a name='TABLE2'>Standard State Keywords</a>"
msgstr ""

#: ./api-filter.html:168
msgid "Keyword"
msgstr ""

#: ./api-filter.html:169
msgctxt "./api-filter.html:169"
msgid "Description"
msgstr ""

#: ./api-filter.html:170
msgid "connecting-to-device"
msgstr ""

#: ./api-filter.html:171
msgid "Connecting to printer but not printing yet"
msgstr ""

#: ./api-filter.html:172
msgid "cover-open"
msgstr ""

#: ./api-filter.html:173
msgid "A cover is open on the printer"
msgstr ""

#: ./api-filter.html:174
msgid "input-tray-missing"
msgstr ""

#: ./api-filter.html:175
msgid "An input tray is missing from the printer"
msgstr ""

#: ./api-filter.html:176
msgid "marker-supply-empty"
msgstr ""

#: ./api-filter.html:177
msgid "Out of ink"
msgstr ""

#: ./api-filter.html:178
msgid "marker-supply-low"
msgstr ""

#: ./api-filter.html:179
msgid "Low on ink"
msgstr ""

#: ./api-filter.html:180
msgid "marker-waste-almost-full"
msgstr ""

#: ./api-filter.html:181
msgid "Waste tank almost full"
msgstr ""

#: ./api-filter.html:182
msgid "marker-waste-full"
msgstr ""

#: ./api-filter.html:183
msgid "Waste tank full"
msgstr ""

#: ./api-filter.html:184
msgid "media-empty"
msgstr ""

#: ./api-filter.html:185
msgid "Out of media"
msgstr ""

#: ./api-filter.html:186
msgid "media-jam"
msgstr ""

#: ./api-filter.html:187
msgid "Media is jammed in the printer"
msgstr ""

#: ./api-filter.html:188
msgid "media-low"
msgstr ""

#: ./api-filter.html:189
msgid "Low on media"
msgstr ""

#: ./api-filter.html:190
msgid "paused"
msgstr ""

#: ./api-filter.html:191
msgid "Stop the printer"
msgstr ""

#: ./api-filter.html:192
msgid "timed-out"
msgstr ""

#: ./api-filter.html:193
msgid "Unable to connect to printer"
msgstr ""

#: ./api-filter.html:194
msgid "toner-empty"
msgstr ""

#: ./api-filter.html:195
msgid "Out of toner"
msgstr ""

#: ./api-filter.html:196
msgid "toner-low"
msgstr ""

#: ./api-filter.html:197
msgid "Low on toner"
msgstr ""

#: ./api-filter.html:198
msgctxt "./api-filter.html:198"
msgid "Communicating with the Backend"
msgstr ""

#: ./api-filter.html:199
msgid ""
"Filters can communicate with the backend via the <a "
"href=\"#cupsBackChannelRead\"><code>cupsBackChannelRead</code></a> and <a "
"href=\"#cupsSideChannelDoRequest\"><code>cupsSideChannelDoRequest</code></a> "
"functions. The  <a "
"href=\"#cupsBackChannelRead\"><code>cupsBackChannelRead</code></a> function "
"reads data that has been sent back from the device and is typically used to "
"obtain status and configuration information. For example, the following code "
"polls the backend for back-channel data:"
msgstr ""

#: ./api-filter.html:200
msgid ""
"Filters can also use <code>select()</code> or <code>poll()</code> on the "
"back-channel file descriptor (3 or <code>CUPS_BC_FD</code>) to read data "
"only when it is available."
msgstr ""

#: ./api-filter.html:201
msgid ""
"The <a "
"href=\"#cupsSideChannelDoRequest\"><code>cupsSideChannelDoRequest</code></a> "
"function allows you to get out-of-band status information and do "
"synchronization with the device. For example, the following code gets the "
"current IEEE-1284 device ID string from the backend:"
msgstr ""

#: ./api-filter.html:202
msgctxt "./api-filter.html:202"
msgid "Communicating with Filters"
msgstr ""

#: ./api-filter.html:203
msgid ""
"Backends communicate with filters using the reciprocal functions <a "
"href=\"#cupsBackChannelWrite\"><code>cupsBackChannelWrite</code></a>, <a "
"href=\"#cupsSideChannelRead\"><code>cupsSideChannelRead</code></a>, and <a "
"href=\"#cupsSideChannelWrite\"><code>cupsSideChannelWrite</code></a>. We "
"recommend writing back-channel data using a timeout of 1.0 seconds:"
msgstr ""

#: ./api-filter.html:204
msgid ""
"The <a href=\"#cupsSideChannelRead\"><code>cupsSideChannelRead</code></a> "
"function reads a side-channel command from a filter, driver, or port "
"monitor. Backends can either poll for commands using a <code>timeout</code> "
"of 0.0, wait indefinitely for commands using a <code>timeout</code> of -1.0 "
"(probably in a separate thread for that purpose), or use <code>select</code> "
"or <code>poll</code> on the <code>CUPS_SC_FD</code> file descriptor (4) to "
"handle input and output on several file descriptors at the same time."
msgstr ""

#: ./api-filter.html:205
msgid ""
"Once a command is processed, the backend uses the <a "
"href=\"#cupsSideChannelWrite\"><code>cupsSideChannelWrite</code></a> function "
"to send its response. For example, the following code shows how to poll for "
"a side-channel command and respond to it:"
msgstr ""

#: ./api-filter.html:206
msgctxt "./api-filter.html:206"
msgid "Doing SNMP Queries with Network Printers"
msgstr ""

#: ./api-filter.html:207
msgid ""
"The Simple Network Management Protocol (SNMP) allows you to get the current "
"status, page counter, and supply levels from most network printers. Every "
"piece of information is associated with an Object Identifier (OID), and "
"every printer has a <em>community</em> name associated with it. OIDs can be "
"queried directly or by \"walking\" over a range of OIDs with a common prefix."
msgstr ""

#: ./api-filter.html:208
msgid ""
"The two CUPS SNMP functions provide a simple API for querying network "
"printers through the side-channel interface. Each accepts a string "
"containing an OID like \".1.3.6.1.2.1.43.10.2.1.4.1.1\" (the standard page "
"counter OID) along with a timeout for the query."
msgstr ""

#: ./api-filter.html:209
msgid ""
"The <a "
"href=\"#cupsSideChannelSNMPGet\"><code>cupsSideChannelSNMPGet</code></a> "
"function queries a single OID and returns the value as a string in a buffer "
"you supply:"
msgstr ""

#: ./api-filter.html:210
msgid ""
"The <a "
"href=\"#cupsSideChannelSNMPWalk\"><code>cupsSideChannelSNMPWalk</code></a> "
"function allows you to query a whole group of OIDs, calling a function of "
"your choice for each OID that is found:"
msgstr ""

#: ./api-filter.html:211
msgctxt "./api-filter.html:211"
msgid "Functions"
msgstr ""

#: ./api-filter.html:212
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsBackChannelRead\">cupsBackChannelRead"
msgstr ""

#: ./api-filter.html:213
msgid "Read data from the backchannel."
msgstr ""

#: ./api-filter.html:214
msgid ""
"ssize_t cupsBackChannelRead (<br> &nbsp;&nbsp;&nbsp;&nbsp;char *buffer,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;size_t bytes,<br> &nbsp;&nbsp;&nbsp;&nbsp;double "
"timeout<br> );"
msgstr ""

#: ./api-filter.html:215
msgctxt "./api-filter.html:215"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:216
msgctxt "./api-filter.html:216"
msgid "buffer"
msgstr ""

#: ./api-filter.html:217
msgid "Buffer to read into"
msgstr ""

#: ./api-filter.html:218
msgctxt "./api-filter.html:218"
msgid "bytes"
msgstr ""

#: ./api-filter.html:219
msgid "Bytes to read"
msgstr ""

#: ./api-filter.html:220
msgctxt "./api-filter.html:220"
msgid "timeout"
msgstr ""

#: ./api-filter.html:221
msgid "Timeout in seconds, typically 0.0 to poll"
msgstr ""

#: ./api-filter.html:222
msgctxt "./api-filter.html:222"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:223
msgid "Bytes read or -1 on error"
msgstr ""

#: ./api-filter.html:224
msgctxt "./api-filter.html:224"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:225
msgid ""
"Reads up to &quot;bytes&quot; bytes from the backchannel/backend. The "
"&quot;timeout&quot; parameter controls how many seconds to wait for the data "
"- use 0.0 to return immediately if there is no data, -1.0 to wait for data "
"indefinitely."
msgstr ""

#: ./api-filter.html:226
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsBackChannelWrite\">cupsBackChannelWrite"
msgstr ""

#: ./api-filter.html:227
msgid "Write data to the backchannel."
msgstr ""

#: ./api-filter.html:228
msgid ""
"ssize_t cupsBackChannelWrite (<br> &nbsp;&nbsp;&nbsp;&nbsp;const char "
"*buffer,<br> &nbsp;&nbsp;&nbsp;&nbsp;size_t bytes,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;double timeout<br> );"
msgstr ""

#: ./api-filter.html:229
msgctxt "./api-filter.html:229"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:230
msgctxt "./api-filter.html:230"
msgid "buffer"
msgstr ""

#: ./api-filter.html:231
msgid "Buffer to write"
msgstr ""

#: ./api-filter.html:232
msgctxt "./api-filter.html:232"
msgid "bytes"
msgstr ""

#: ./api-filter.html:233
msgid "Bytes to write"
msgstr ""

#: ./api-filter.html:234
msgctxt "./api-filter.html:234"
msgid "timeout"
msgstr ""

#: ./api-filter.html:235
msgid "Timeout in seconds, typically 1.0"
msgstr ""

#: ./api-filter.html:236
msgctxt "./api-filter.html:236"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:237
msgid "Bytes written or -1 on error"
msgstr ""

#: ./api-filter.html:238
msgctxt "./api-filter.html:238"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:239
msgid ""
"Writes &quot;bytes&quot; bytes to the backchannel/filter. The "
"&quot;timeout&quot; parameter controls how many seconds to wait for the data "
"to be written - use 0.0 to return immediately if the data cannot be "
"written, -1.0 to wait indefinitely."
msgstr ""

#: ./api-filter.html:240
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsBackendDeviceURI\">cupsBackendDeviceURI"
msgstr ""

#: ./api-filter.html:241
msgid "Get the device URI for a backend."
msgstr ""

#: ./api-filter.html:242
msgid ""
"const char *cupsBackendDeviceURI (<br> &nbsp;&nbsp;&nbsp;&nbsp;char "
"**argv<br> );"
msgstr ""

#: ./api-filter.html:243
msgctxt "./api-filter.html:243"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:244
msgid "argv"
msgstr ""

#: ./api-filter.html:245
msgid "Command-line arguments"
msgstr ""

#: ./api-filter.html:246
msgctxt "./api-filter.html:246"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:247
msgid "Device URI or <code>NULL</code>"
msgstr ""

#: ./api-filter.html:248
msgctxt "./api-filter.html:248"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:249
msgid ""
"The &quot;argv&quot; argument is the argv argument passed to main(). This "
"function returns the device URI passed in the DEVICE_URI environment "
"variable or the device URI passed in argv[0], whichever is found first."
msgstr ""

#: ./api-filter.html:250
msgid ""
"&nbsp;CUPS 1.4&nbsp;</span><a name=\"cupsBackendReport\">cupsBackendReport"
msgstr ""

#: ./api-filter.html:251
msgid "Write a device line from a backend."
msgstr ""

#: ./api-filter.html:252
msgid ""
"void cupsBackendReport (<br> &nbsp;&nbsp;&nbsp;&nbsp;const char "
"*device_scheme,<br> &nbsp;&nbsp;&nbsp;&nbsp;const char *device_uri,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;const char *device_make_and_model,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;const char *device_info,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;const char *device_id,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;const char *device_location<br> );"
msgstr ""

#: ./api-filter.html:253
msgctxt "./api-filter.html:253"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:254
msgid "device_scheme"
msgstr ""

#: ./api-filter.html:255
msgid "device-scheme string"
msgstr ""

#: ./api-filter.html:256
msgid "device_uri"
msgstr ""

#: ./api-filter.html:257
msgid "device-uri string"
msgstr ""

#: ./api-filter.html:258
msgid "device_make_and_model"
msgstr ""

#: ./api-filter.html:259
msgid "device-make-and-model string or <code>NULL</code>"
msgstr ""

#: ./api-filter.html:260
msgid "device_info"
msgstr ""

#: ./api-filter.html:261
msgid "device-info string or <code>NULL</code>"
msgstr ""

#: ./api-filter.html:262
msgid "device_id"
msgstr ""

#: ./api-filter.html:263
msgid "device-id string or <code>NULL</code>"
msgstr ""

#: ./api-filter.html:264
msgid "device_location"
msgstr ""

#: ./api-filter.html:265
msgid "device-location string or <code>NULL</code>"
msgstr ""

#: ./api-filter.html:266
msgctxt "./api-filter.html:266"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:267
msgid ""
"This function writes a single device line to stdout for a backend. It "
"handles quoting of special characters in the device-make-and-model, device-"
"info, device-id, and device-location strings."
msgstr ""

#: ./api-filter.html:268
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsSideChannelDoRequest\">cupsSideChannelDoRequest"
msgstr ""

#: ./api-filter.html:269
msgid "Send a side-channel command to a backend and wait for a response."
msgstr ""

#: ./api-filter.html:270
msgid ""
"<a href=\"#cups_sc_status_t\">cups_sc_status_t</a> cupsSideChannelDoRequest "
"(<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_sc_command_t\">cups_sc_command_t</a> command,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;char *data,<br> &nbsp;&nbsp;&nbsp;&nbsp;int "
"*datalen,<br> &nbsp;&nbsp;&nbsp;&nbsp;double timeout<br> );"
msgstr ""

#: ./api-filter.html:271
msgctxt "./api-filter.html:271"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:272
msgctxt "./api-filter.html:272"
msgid "command"
msgstr ""

#: ./api-filter.html:273
msgid "Command to send"
msgstr ""

#: ./api-filter.html:274
msgctxt "./api-filter.html:274"
msgid "data"
msgstr ""

#: ./api-filter.html:275
msgid "Response data buffer pointer"
msgstr ""

#: ./api-filter.html:276
msgctxt "./api-filter.html:276"
msgid "datalen"
msgstr ""

#: ./api-filter.html:277
msgctxt "./api-filter.html:277"
msgid "Size of data buffer on entry, number of bytes in buffer on return"
msgstr ""

#: ./api-filter.html:278
msgctxt "./api-filter.html:278"
msgid "timeout"
msgstr ""

#: ./api-filter.html:279
msgctxt "./api-filter.html:279"
msgid "Timeout in seconds"
msgstr ""

#: ./api-filter.html:280
msgctxt "./api-filter.html:280"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:281
msgid "Status of command"
msgstr ""

#: ./api-filter.html:282
msgctxt "./api-filter.html:282"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:283
msgid ""
"This function is normally only called by filters, drivers, or port monitors "
"in order to communicate with the backend used by the current printer.  "
"Programs must be prepared to handle timeout or &quot;not implemented&quot; "
"status codes, which indicate that the backend or device do not support the "
"specified side-channel command.<br> <br> The &quot;datalen&quot; parameter "
"must be initialized to the size of the buffer pointed to by the "
"&quot;data&quot; parameter.  cupsSideChannelDoRequest() will update the "
"value to contain the number of data bytes in the buffer."
msgstr ""

#: ./api-filter.html:284
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsSideChannelRead\">cupsSideChannelRead"
msgstr ""

#: ./api-filter.html:285
msgid "Read a side-channel message."
msgstr ""

#: ./api-filter.html:286
msgid ""
"int cupsSideChannelRead (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_sc_command_t\">cups_sc_command_t</a> *command,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;<a href=\"#cups_sc_status_t\">cups_sc_status_t</a> "
"*status,<br> &nbsp;&nbsp;&nbsp;&nbsp;char *data,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;int *datalen,<br> &nbsp;&nbsp;&nbsp;&nbsp;double "
"timeout<br> );"
msgstr ""

#: ./api-filter.html:287
msgctxt "./api-filter.html:287"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:288
msgctxt "./api-filter.html:288"
msgid "command"
msgstr ""

#: ./api-filter.html:289
msgctxt "./api-filter.html:289"
msgid "Command code"
msgstr ""

#: ./api-filter.html:290
msgctxt "./api-filter.html:290"
msgid "status"
msgstr ""

#: ./api-filter.html:291
msgctxt "./api-filter.html:291"
msgid "Status code"
msgstr ""

#: ./api-filter.html:292
msgctxt "./api-filter.html:292"
msgid "data"
msgstr ""

#: ./api-filter.html:293
msgctxt "./api-filter.html:293"
msgid "Data buffer pointer"
msgstr ""

#: ./api-filter.html:294
msgctxt "./api-filter.html:294"
msgid "datalen"
msgstr ""

#: ./api-filter.html:295
msgctxt "./api-filter.html:295"
msgid "Size of data buffer on entry, number of bytes in buffer on return"
msgstr ""

#: ./api-filter.html:296
msgctxt "./api-filter.html:296"
msgid "timeout"
msgstr ""

#: ./api-filter.html:297
msgctxt "./api-filter.html:297"
msgid "Timeout in seconds"
msgstr ""

#: ./api-filter.html:298
msgctxt "./api-filter.html:298"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:299
msgctxt "./api-filter.html:299"
msgid "0 on success, -1 on error"
msgstr ""

#: ./api-filter.html:300
msgctxt "./api-filter.html:300"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:301
msgid ""
"This function is normally only called by backend programs to read commands "
"from a filter, driver, or port monitor program.  The caller must be prepared "
"to handle incomplete or invalid messages and return the corresponding "
"status codes.<br> <br> The &quot;datalen&quot; parameter must be initialized "
"to the size of the buffer pointed to by the &quot;data&quot; parameter.  "
"cupsSideChannelDoRequest() will update the value to contain the number of "
"data bytes in the buffer."
msgstr ""

#: ./api-filter.html:302
msgid ""
"&nbsp;CUPS 1.4&nbsp;</span><a "
"name=\"cupsSideChannelSNMPGet\">cupsSideChannelSNMPGet"
msgstr ""

#: ./api-filter.html:303
msgid "Query a SNMP OID's value."
msgstr ""

#: ./api-filter.html:304
msgid ""
"<a href=\"#cups_sc_status_t\">cups_sc_status_t</a> cupsSideChannelSNMPGet "
"(<br> &nbsp;&nbsp;&nbsp;&nbsp;const char *oid,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;char *data,<br> &nbsp;&nbsp;&nbsp;&nbsp;int "
"*datalen,<br> &nbsp;&nbsp;&nbsp;&nbsp;double timeout<br> );"
msgstr ""

#: ./api-filter.html:305
msgctxt "./api-filter.html:305"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:306
msgctxt "./api-filter.html:306"
msgid "oid"
msgstr ""

#: ./api-filter.html:307
msgid "OID to query"
msgstr ""

#: ./api-filter.html:308
msgctxt "./api-filter.html:308"
msgid "data"
msgstr ""

#: ./api-filter.html:309
msgid "Buffer for OID value"
msgstr ""

#: ./api-filter.html:310
msgctxt "./api-filter.html:310"
msgid "datalen"
msgstr ""

#: ./api-filter.html:311
msgid "Size of OID buffer on entry, size of value on return"
msgstr ""

#: ./api-filter.html:312
msgctxt "./api-filter.html:312"
msgid "timeout"
msgstr ""

#: ./api-filter.html:313
msgctxt "./api-filter.html:313"
msgid "Timeout in seconds"
msgstr ""

#: ./api-filter.html:314
msgctxt "./api-filter.html:314"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:315
msgid "Query status"
msgstr ""

#: ./api-filter.html:316
msgctxt "./api-filter.html:316"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:317
msgid ""
"This function asks the backend to do a SNMP OID query on behalf of the "
"filter, port monitor, or backend using the default community name.<br> <br> "
"&quot;oid&quot; contains a numeric OID consisting of integers separated by "
"periods, for example &quot;.1.3.6.1.2.1.43&quot;.  Symbolic names from SNMP "
"MIBs are not supported and must be converted to their numeric forms.<br> "
"<br> On input, &quot;data&quot; and &quot;datalen&quot; provide the location "
"and size of the buffer to hold the OID value as a string. HEX-String "
"(binary) values are converted to hexadecimal strings representing the binary "
"data, while NULL-Value and unknown OID types are returned as the empty "
"string. The returned &quot;datalen&quot; does not include the trailing nul. "
" <code>CUPS_SC_STATUS_NOT_IMPLEMENTED</code> is returned by backends that "
"do not support SNMP queries.  <code>CUPS_SC_STATUS_NO_RESPONSE</code> is "
"returned when the printer does not respond to the SNMP query."
msgstr ""

#: ./api-filter.html:318
msgid ""
"&nbsp;CUPS 1.4&nbsp;</span><a "
"name=\"cupsSideChannelSNMPWalk\">cupsSideChannelSNMPWalk"
msgstr ""

#: ./api-filter.html:319
msgid "Query multiple SNMP OID values."
msgstr ""

#: ./api-filter.html:320
msgid ""
"<a href=\"#cups_sc_status_t\">cups_sc_status_t</a> cupsSideChannelSNMPWalk "
"(<br> &nbsp;&nbsp;&nbsp;&nbsp;const char *oid,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;double timeout,<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_sc_walk_func_t\">cups_sc_walk_func_t</a> cb,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;void *context<br> );"
msgstr ""

#: ./api-filter.html:321
msgctxt "./api-filter.html:321"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:322
msgctxt "./api-filter.html:322"
msgid "oid"
msgstr ""

#: ./api-filter.html:323
msgid "First numeric OID to query"
msgstr ""

#: ./api-filter.html:324
msgctxt "./api-filter.html:324"
msgid "timeout"
msgstr ""

#: ./api-filter.html:325
msgid "Timeout for each query in seconds"
msgstr ""

#: ./api-filter.html:326
msgid "cb"
msgstr ""

#: ./api-filter.html:327
msgid "Function to call with each value"
msgstr ""

#: ./api-filter.html:328
msgid "context"
msgstr ""

#: ./api-filter.html:329
msgid "Application-defined pointer to send to callback"
msgstr ""

#: ./api-filter.html:330
msgctxt "./api-filter.html:330"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:331
msgid "Status of first query of <code>CUPS_SC_STATUS_OK</code> on success"
msgstr ""

#: ./api-filter.html:332
msgctxt "./api-filter.html:332"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:333
msgid ""
"This function asks the backend to do multiple SNMP OID queries on behalf of "
"the filter, port monitor, or backend using the default community name. All "
"OIDs under the &quot;parent&quot; OID are queried and the results are sent "
"to the callback function you provide.<br> <br> &quot;oid&quot; contains a "
"numeric OID consisting of integers separated by periods, for example "
"&quot;.1.3.6.1.2.1.43&quot;.  Symbolic names from SNMP MIBs are not "
"supported and must be converted to their numeric forms.<br> <br> "
"&quot;timeout&quot; specifies the timeout for each OID query. The total "
"amount of time will depend on the number of OID values found and the time "
"required for each query.<br> <br> &quot;cb&quot; provides a function to call "
"for every value that is found. &quot;context&quot; is an application-"
"defined pointer that is sent to the callback function along with the OID and "
"current data. The data passed to the callback is the same as returned by <a "
"href=\"#cupsSideChannelSNMPGet\"><code>cupsSideChannelSNMPGet</code></a>.  "
"<code>CUPS_SC_STATUS_NOT_IMPLEMENTED</code> is returned by backends that do "
"not support SNMP queries.  <code>CUPS_SC_STATUS_NO_RESPONSE</code> is "
"returned when the printer does not respond to the first SNMP query."
msgstr ""

#: ./api-filter.html:334
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsSideChannelWrite\">cupsSideChannelWrite"
msgstr ""

#: ./api-filter.html:335
msgid "Write a side-channel message."
msgstr ""

#: ./api-filter.html:336
msgid ""
"int cupsSideChannelWrite (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_sc_command_t\">cups_sc_command_t</a> command,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;<a href=\"#cups_sc_status_t\">cups_sc_status_t</a> "
"status,<br> &nbsp;&nbsp;&nbsp;&nbsp;const char *data,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;int datalen,<br> &nbsp;&nbsp;&nbsp;&nbsp;double "
"timeout<br> );"
msgstr ""

#: ./api-filter.html:337
msgctxt "./api-filter.html:337"
msgid "Parameters"
msgstr ""

#: ./api-filter.html:338
msgctxt "./api-filter.html:338"
msgid "command"
msgstr ""

#: ./api-filter.html:339
msgctxt "./api-filter.html:339"
msgid "Command code"
msgstr ""

#: ./api-filter.html:340
msgctxt "./api-filter.html:340"
msgid "status"
msgstr ""

#: ./api-filter.html:341
msgctxt "./api-filter.html:341"
msgid "Status code"
msgstr ""

#: ./api-filter.html:342
msgctxt "./api-filter.html:342"
msgid "data"
msgstr ""

#: ./api-filter.html:343
msgctxt "./api-filter.html:343"
msgid "Data buffer pointer"
msgstr ""

#: ./api-filter.html:344
msgctxt "./api-filter.html:344"
msgid "datalen"
msgstr ""

#: ./api-filter.html:345
msgid "Number of bytes of data"
msgstr ""

#: ./api-filter.html:346
msgctxt "./api-filter.html:346"
msgid "timeout"
msgstr ""

#: ./api-filter.html:347
msgctxt "./api-filter.html:347"
msgid "Timeout in seconds"
msgstr ""

#: ./api-filter.html:348
msgctxt "./api-filter.html:348"
msgid "Return Value"
msgstr ""

#: ./api-filter.html:349
msgctxt "./api-filter.html:349"
msgid "0 on success, -1 on error"
msgstr ""

#: ./api-filter.html:350
msgctxt "./api-filter.html:350"
msgid "Discussion"
msgstr ""

#: ./api-filter.html:351
msgid ""
"This function is normally only called by backend programs to send responses "
"to a filter, driver, or port monitor program."
msgstr ""

#: ./api-filter.html:352
msgctxt "./api-filter.html:352"
msgid "Data Types"
msgstr ""

#: ./api-filter.html:353
msgctxt "./api-filter.html:353"
msgid "cups_backend_t"
msgstr ""

#: ./api-filter.html:354
msgctxt "./api-filter.html:354"
msgid "Backend exit codes"
msgstr ""

#: ./api-filter.html:355
msgid ""
"typedef enum <a href=\"#cups_backend_e\">cups_backend_e</a> cups_backend_t;"
msgstr ""

#: ./api-filter.html:356
msgctxt "./api-filter.html:356"
msgid "cups_sc_bidi_t"
msgstr ""

#: ./api-filter.html:357
msgid "Bidirectional capabilities"
msgstr ""

#: ./api-filter.html:358
msgid ""
"typedef enum <a href=\"#cups_sc_bidi_e\">cups_sc_bidi_e</a> cups_sc_bidi_t;"
msgstr ""

#: ./api-filter.html:359
msgctxt "./api-filter.html:359"
msgid "cups_sc_command_t"
msgstr ""

#: ./api-filter.html:360
msgctxt "./api-filter.html:360"
msgid "Request command codes"
msgstr ""

#: ./api-filter.html:361
msgid ""
"typedef enum <a href=\"#cups_sc_command_e\">cups_sc_command_e</a> "
"cups_sc_command_t;"
msgstr ""

#: ./api-filter.html:362
msgctxt "./api-filter.html:362"
msgid "cups_sc_state_t"
msgstr ""

#: ./api-filter.html:363
msgctxt "./api-filter.html:363"
msgid "Printer state bits"
msgstr ""

#: ./api-filter.html:364
msgid ""
"typedef enum <a href=\"#cups_sc_state_e\">cups_sc_state_e</a> cups_sc_state_t;"
msgstr ""

#: ./api-filter.html:365
msgctxt "./api-filter.html:365"
msgid "cups_sc_status_t"
msgstr ""

#: ./api-filter.html:366
msgctxt "./api-filter.html:366"
msgid "Response status codes"
msgstr ""

#: ./api-filter.html:367
msgid ""
"typedef enum <a href=\"#cups_sc_status_e\">cups_sc_status_e</a> "
"cups_sc_status_t;"
msgstr ""

#: ./api-filter.html:368
msgctxt "./api-filter.html:368"
msgid "cups_sc_walk_func_t"
msgstr ""

#: ./api-filter.html:369
msgid "SNMP walk callback"
msgstr ""

#: ./api-filter.html:370
msgid ""
"typedef void (*cups_sc_walk_func_t)(const char *oid, const char *data, int "
"datalen, void *context);"
msgstr ""

#: ./api-filter.html:371
msgctxt "./api-filter.html:371"
msgid "Constants"
msgstr ""

#: ./api-filter.html:372
msgctxt "./api-filter.html:372"
msgid "cups_backend_e"
msgstr ""

#: ./api-filter.html:373
msgctxt "./api-filter.html:373"
msgid "Backend exit codes"
msgstr ""

#: ./api-filter.html:374
msgctxt "./api-filter.html:374"
msgid "Constants"
msgstr ""

#: ./api-filter.html:375
msgid "CUPS_BACKEND_AUTH_REQUIRED"
msgstr ""

#: ./api-filter.html:376
msgid "Job failed, authentication required"
msgstr ""

#: ./api-filter.html:377
msgid "CUPS_BACKEND_CANCEL"
msgstr ""

#: ./api-filter.html:378
msgid "Job failed, cancel job"
msgstr ""

#: ./api-filter.html:379
msgid "CUPS_BACKEND_FAILED"
msgstr ""

#: ./api-filter.html:380
msgid "Job failed, use error-policy"
msgstr ""

#: ./api-filter.html:381
msgid "CUPS_BACKEND_HOLD"
msgstr ""

#: ./api-filter.html:382
msgid "Job failed, hold job"
msgstr ""

#: ./api-filter.html:383
msgid "CUPS_BACKEND_OK"
msgstr ""

#: ./api-filter.html:384
msgid "Job completed successfully"
msgstr ""

#: ./api-filter.html:385
msgid "CUPS_BACKEND_STOP"
msgstr ""

#: ./api-filter.html:386
msgid "Job failed, stop queue"
msgstr ""

#: ./api-filter.html:387
msgctxt "./api-filter.html:387"
msgid "cups_sc_bidi_e"
msgstr ""

#: ./api-filter.html:388
msgid "Bidirectional capability values"
msgstr ""

#: ./api-filter.html:389
msgctxt "./api-filter.html:389"
msgid "Constants"
msgstr ""

#: ./api-filter.html:390
msgid "CUPS_SC_BIDI_NOT_SUPPORTED"
msgstr ""

#: ./api-filter.html:391
msgid "Bidirectional I/O is not supported"
msgstr ""

#: ./api-filter.html:392
msgid "CUPS_SC_BIDI_SUPPORTED"
msgstr ""

#: ./api-filter.html:393
msgid "Bidirectional I/O is supported"
msgstr ""

#: ./api-filter.html:394
msgctxt "./api-filter.html:394"
msgid "cups_sc_command_e"
msgstr ""

#: ./api-filter.html:395
msgctxt "./api-filter.html:395"
msgid "Request command codes"
msgstr ""

#: ./api-filter.html:396
msgctxt "./api-filter.html:396"
msgid "Constants"
msgstr ""

#: ./api-filter.html:397
msgid "CUPS_SC_CMD_DRAIN_OUTPUT"
msgstr ""

#: ./api-filter.html:398
msgid "Drain all pending output"
msgstr ""

#: ./api-filter.html:399
msgid "CUPS_SC_CMD_GET_BIDI"
msgstr ""

#: ./api-filter.html:400
msgid "Return bidirectional capabilities"
msgstr ""

#: ./api-filter.html:401
msgid "CUPS_SC_CMD_GET_DEVICE_ID"
msgstr ""

#: ./api-filter.html:402
msgid "Return the IEEE-1284 device ID"
msgstr ""

#: ./api-filter.html:403
msgid "CUPS_SC_CMD_GET_STATE"
msgstr ""

#: ./api-filter.html:404
msgid "Return the device state"
msgstr ""

#: ./api-filter.html:405
msgid "CUPS_SC_CMD_SNMP_GET <span class=\"info\">&nbsp;CUPS 1.4&nbsp;</span>"
msgstr ""

#: ./api-filter.html:406
msgid "Query an SNMP OID"
msgstr ""

#: ./api-filter.html:407
msgid ""
"CUPS_SC_CMD_SNMP_GET_NEXT <span class=\"info\">&nbsp;CUPS 1.4&nbsp;</span>"
msgstr ""

#: ./api-filter.html:408
msgid "Query the next SNMP OID"
msgstr ""

#: ./api-filter.html:409
msgid "CUPS_SC_CMD_SOFT_RESET"
msgstr ""

#: ./api-filter.html:410
msgid "Do a soft reset"
msgstr ""

#: ./api-filter.html:411
msgctxt "./api-filter.html:411"
msgid "cups_sc_state_e"
msgstr ""

#: ./api-filter.html:412
msgctxt "./api-filter.html:412"
msgid "Printer state bits"
msgstr ""

#: ./api-filter.html:413
msgctxt "./api-filter.html:413"
msgid "Constants"
msgstr ""

#: ./api-filter.html:414
msgid "CUPS_SC_STATE_BUSY"
msgstr ""

#: ./api-filter.html:415
msgid "Device is busy"
msgstr ""

#: ./api-filter.html:416
msgid "CUPS_SC_STATE_ERROR"
msgstr ""

#: ./api-filter.html:417
msgid "Other error condition"
msgstr ""

#: ./api-filter.html:418
msgid "CUPS_SC_STATE_MARKER_EMPTY"
msgstr ""

#: ./api-filter.html:419
msgid "Toner/ink out condition"
msgstr ""

#: ./api-filter.html:420
msgid "CUPS_SC_STATE_MARKER_LOW"
msgstr ""

#: ./api-filter.html:421
msgid "Toner/ink low condition"
msgstr ""

#: ./api-filter.html:422
msgid "CUPS_SC_STATE_MEDIA_EMPTY"
msgstr ""

#: ./api-filter.html:423
msgid "Paper out condition"
msgstr ""

#: ./api-filter.html:424
msgid "CUPS_SC_STATE_MEDIA_LOW"
msgstr ""

#: ./api-filter.html:425
msgid "Paper low condition"
msgstr ""

#: ./api-filter.html:426
msgid "CUPS_SC_STATE_OFFLINE"
msgstr ""

#: ./api-filter.html:427
msgid "Device is offline"
msgstr ""

#: ./api-filter.html:428
msgid "CUPS_SC_STATE_ONLINE"
msgstr ""

#: ./api-filter.html:429
msgid "Device is online"
msgstr ""

#: ./api-filter.html:430
msgctxt "./api-filter.html:430"
msgid "cups_sc_status_e"
msgstr ""

#: ./api-filter.html:431
msgctxt "./api-filter.html:431"
msgid "Response status codes"
msgstr ""

#: ./api-filter.html:432
msgctxt "./api-filter.html:432"
msgid "Constants"
msgstr ""

#: ./api-filter.html:433
msgid "CUPS_SC_STATUS_BAD_MESSAGE"
msgstr ""

#: ./api-filter.html:434
msgid "The command/response message was invalid"
msgstr ""

#: ./api-filter.html:435
msgid "CUPS_SC_STATUS_IO_ERROR"
msgstr ""

#: ./api-filter.html:436
msgid "An I/O error occurred"
msgstr ""

#: ./api-filter.html:437
msgid "CUPS_SC_STATUS_NONE"
msgstr ""

#: ./api-filter.html:438
msgid "No status"
msgstr ""

#: ./api-filter.html:439
msgid "CUPS_SC_STATUS_NOT_IMPLEMENTED"
msgstr ""

#: ./api-filter.html:440
msgid "Command not implemented"
msgstr ""

#: ./api-filter.html:441
msgid "CUPS_SC_STATUS_NO_RESPONSE"
msgstr ""

#: ./api-filter.html:442
msgid "The device did not respond"
msgstr ""

#: ./api-filter.html:443
msgid "CUPS_SC_STATUS_OK"
msgstr ""

#: ./api-filter.html:444
msgid "Operation succeeded"
msgstr ""

#: ./api-filter.html:445
msgid "CUPS_SC_STATUS_TIMEOUT"
msgstr ""

#: ./api-filter.html:446
msgid "The backend did not respond"
msgstr ""

#: ./api-filter.html:447
msgid "CUPS_SC_STATUS_TOO_BIG"
msgstr ""

#: ./api-filter.html:448
msgid "Response too big"
msgstr ""