Directory Setup

Since almost all components of the CAPS universe do run as regular users, permissions to access various directories and files are important. The rule of thumb is: gain read permissions for group 'lp' for all directories and files. Write access to all CAPS universe related files should be gained to user 'root' only.

There is one exception of this rule: the CAPS Document Storage Directory. It is used to temporarily store the documents to print and thus, write permissions for group 'lp' is required here.

For a quick check of your currently active directory setup, run the command capsinfo:

$ capsinfo
The 'CAPS Configuration Directory' is: '/etc/caps'
The 'CAPS Printer Driver Database Directory' is: '/usr/share/caps/drivers'
The 'CAPS Printer Driver Configuration Directory' is: '/etc/caps/drivers'
The 'CAPS Printer Driver Executables Directory' is: '/usr/libexec/caps'
The 'CAPS Printer Device Database Directory' is: '/var/lib/caps'
The 'CAPS Document Storage Directory' is: '/var/spool/caps'

This tool provides more info with the --verbose option:

$ capsinfo --verbose
The 'CAPS Configuration Directory' is: '/etc/caps'
 Contains the base configuration INI files for various CAPS universe components
 For testing purposes you can overwrite this path with the environment variable 'CAPS_CONFIG_DIR'
The 'CAPS Printer Driver Database Directory' is: '/usr/share/caps/drivers'
 Contains the descriptive INI files of installed printer drivers
 For testing purposes you can overwrite this path with the environment variable 'CAPS_PRINTER_DRIVER_DB_DIR'
The 'CAPS Printer Driver Configuration Directory' is: '/etc/caps/drivers'
 Contains the feature INI files of installed printer drivers
 For testing purposes you can overwrite this path with the environment variable 'CAPS_DRIVER_CONFIGURATION_DIR'
The 'CAPS Printer Driver Executables Directory' is: '/usr/libexec/caps'
 Contains the printer driver executables
 For testing purposes you can overwrite this path with the environment variable 'CAPS_DRIVER_DIR'
The 'CAPS Printer Device Database Directory' is: '/var/lib/caps'
 Contains the printer device INI database and INI files of known printer devices
 For testing purposes you can overwrite this path with the environment variable 'CAPS_PRINTER_DEVICE_DB_DIR'
The 'CAPS Document Storage Directory' is: '/var/spool/caps'
 Used to store all printing documents in a temporary manner
 For testing purposes you can overwrite this path with the environment variable 'DOCUMENT_STORAGE_DIR'

Note: The "For testing purposes…" sentences you can only see, if debugging was enabled when compiling the project.