libcapssi: API description

Implements the features of the capsprndir tool as a library for applications. More...

Features
	Base functions
	Retrieve a printer's CAPS Printer Device Parameter Directory.
	Error message handling
	How to deal with error messages.

Detailed Description

In order to change some settings for a specific printer device - like its visible name for example - its corresponding and specific CAPS Printer Device Parameter Directory must be known. This (unique) directory contains one or more INI files used only by this specific printer device.

Since all of these directories have an auto-generated unique name, one cannot guess the directory's name for a specific printer device. At least not, if more than one printer device is known to the system.

This library discovers the CAPS Printer Device Parameter Directory for a specified printer device. Based on its device node or its current name if the printer device is currently active.

Note

This library relies on the fact, the caller must be member of the group 'lp' to access the CAPS Printer Device Database Directory.

Since this library can be used by applications, helpful error messages can be caught by the caps_si_error_messages_catch() mechanism. Refer Error message handling for details.