summaryrefslogtreecommitdiff
path: root/cups/cupspm.md
diff options
context:
space:
mode:
authorMichael Sweet <michael.r.sweet@gmail.com>2017-05-31 11:21:29 -0400
committerMichael Sweet <michael.r.sweet@gmail.com>2017-05-31 11:21:29 -0400
commitf50db552c566e2525bada17e5c50606701a1a0d7 (patch)
tree4fecaabac2495e3d9fe87f32cd111d48ee30d925 /cups/cupspm.md
parent4cfbd5f897d652cc1c788e7acc65cba3c73ee8e8 (diff)
downloadcups-f50db552c566e2525bada17e5c50606701a1a0d7.tar.gz
Revive CUPS_PRINTER_DISCOVERED for cupsEnumDests.
Diffstat (limited to 'cups/cupspm.md')
-rw-r--r--cups/cupspm.md12
1 files changed, 8 insertions, 4 deletions
diff --git a/cups/cupspm.md b/cups/cupspm.md
index 12bfdbd34..97f2049d6 100644
--- a/cups/cupspm.md
+++ b/cups/cupspm.md
@@ -153,15 +153,17 @@ the destinations based on categories and/or capabilities. The destination's
"printer-type" value is masked by the `mask` value and compared to the `type`
value when filtering. For example, to only enumerate destinations that are
hosted on the local system, pass `CUPS_PRINTER_LOCAL` for the `type` argument
-and `CUPS_PRINTER_REMOTE` for the `mask` argument. The following constants can
-be used for filtering:
+and `CUPS_PRINTER_DISCOVERED` for the `mask` argument. The following constants
+can be used for filtering:
- `CUPS_PRINTER_CLASS`: A collection of destinations.
- `CUPS_PRINTER_FAX`: A facsimile device.
- `CUPS_PRINTER_LOCAL`: A local printer or class. This constant has the value 0
(no bits set) and is only used for the `type` argument and is paired with the
- `CUPS_PRINTER_REMOTE` constant passed in the `mask` argument.
-- `CUPS_PRINTER_REMOTE`: A remote printer or class.
+ `CUPS_PRINTER_REMOTE` or `CUPS_PRINTER_DISCOVERED` constant passed in the
+ `mask` argument.
+- `CUPS_PRINTER_REMOTE`: A remote (shared) printer or class.
+- `CUPS_PRINTER_DISCOVERED`: An available network printer or class.
- `CUPS_PRINTER_BW`: Can do B&W printing.
- `CUPS_PRINTER_COLOR`: Can do color printing.
- `CUPS_PRINTER_DUPLEX`: Can do two-sided printing.
@@ -292,6 +294,8 @@ destination attributes:
- "printer-state-reasons": Additional comma-delimited state keywords for the
destination such as "media-tray-empty-error" and "toner-low-warning".
- "printer-type": The `cups_ptype_t` value associated with the destination.
+- "printer-uri": The URI associated with the destination; if not set, this
+ destination was discovered but is not yet setup as a local printer.
Use the `cupsGetOption` function to retrieve the value. For example, the
following code gets the make and model of a destination: