cupsAddDest

Name

cupsAddDest -- Add a destination to the list of destinations.

Synopsis

#include <cups/cups.h>

int cupsAddDest(const char * name, const char * instance, int num_dests, cups_dest_t ** dests);

Description

Add a destination to the list of destinations.

This function cannot be used to add a new class or printer queue, it only adds a new container of saved options for the named destination or instance.

If the named destination already exists, the destination list is returned unchanged. Adding a new instance of a destination creates a copy of that destination's options.

Use the cupsSaveDests() function to save the updated list of destinations to the user's lpoptions file.

Return Value

New number of destinations