diff --git a/cups/cupspm.md b/cups/cupspm.md index 9613ca35f..f339764ea 100644 --- a/cups/cupspm.md +++ b/cups/cupspm.md @@ -316,12 +316,14 @@ used to gather detailed information about the destination: ```c cups_dinfo_t * -cupsCopyDestInfo(http_t *http, cups_dest_t *dest); +cupsCopyDestInfo(http_t *http, cups_dest_t *dest, cups_dest_flags_t dflags); ``` The "http" argument specifies a connection to the CUPS scheduler and is typically the constant `CUPS_HTTP_DEFAULT`. The "dest" argument specifies the -destination to query. +destination to query. The "dflags" argument specifies whether to get the +information from the local spooler (`CUPS_DEST_FLAGS_NONE`) or from the printer +(`CUPS_DEST_FLAGS_DEVICE`). The `cups_dinfo_t` structure that is returned contains a snapshot of the supported options and their supported, ready, and default values. It also can @@ -396,7 +398,8 @@ For example, the following code prints the supported finishing processes for a destination, if any, to the standard output: ```c -cups_dinfo_t *info = cupsCopyDestInfo(CUPS_HTTP_DEFAULT, dest); +cups_dinfo_t *info = cupsCopyDestInfo(CUPS_HTTP_DEFAULT, dest, + CUPS_DEST_FLAGS_NONE); if (cupsCheckDestSupported(CUPS_HTTP_DEFAULT, dest, info, CUPS_FINISHINGS, NULL)) diff --git a/doc/cupspm.epub b/doc/cupspm.epub index d7e100473..d2357b955 100644 Binary files a/doc/cupspm.epub and b/doc/cupspm.epub differ diff --git a/doc/cupspm.html b/doc/cupspm.html index 29da58dae..143b74420 100644 --- a/doc/cupspm.html +++ b/doc/cupspm.html @@ -1155,9 +1155,9 @@
Once a destination has been chosen, the cupsCopyDestInfo
function can be used to gather detailed information about the destination:
cups_dinfo_t *
-cupsCopyDestInfo(http_t *http, cups_dest_t *dest);
+cupsCopyDestInfo(http_t *http, cups_dest_t *dest, cups_dest_flags_t dflags);
-The "http" argument specifies a connection to the CUPS scheduler and is typically the constant CUPS_HTTP_DEFAULT
. The "dest" argument specifies the destination to query.
The "http" argument specifies a connection to the CUPS scheduler and is typically the constant CUPS_HTTP_DEFAULT
. The "dest" argument specifies the destination to query. The "dflags" argument specifies whether to get the information from the local spooler (CUPS_DEST_FLAGS_NONE
) or from the printer (CUPS_DEST_FLAGS_DEVICE
).
The cups_dinfo_t
structure that is returned contains a snapshot of the supported options and their supported, ready, and default values. It also can report constraints between different options and values, and recommend changes to resolve those constraints.
The cupsCheckDestSupported
function can be used to test whether a particular option or option and value is supported:
For example, the following code prints the supported finishing processes for a destination, if any, to the standard output:
-cups_dinfo_t *info = cupsCopyDestInfo(CUPS_HTTP_DEFAULT, dest);
+cups_dinfo_t *info = cupsCopyDestInfo(CUPS_HTTP_DEFAULT, dest,
+ CUPS_DEST_FLAGS_NONE);
if (cupsCheckDestSupported(CUPS_HTTP_DEFAULT, dest, info,
CUPS_FINISHINGS, NULL))