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 @@

Basic Destination Informati

Detailed Destination Information

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.

Getting Supported Options and Values

The cupsCheckDestSupported function can be used to test whether a particular option or option and value is supported:

@@ -1198,7 +1198,8 @@

Getting Supported Options and Valu const char *option);

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))