cups-pdf.conf

#  cups-pdf.conf -- CUPS Backend Configuration (version 3.0.1, 2017-02-24)
#  18.09.2005, Volker C. Behr
#  volker@cups-pdf.de
#  http://www.cups-pdf.de
#
#
#  This code may be freely distributed as long as this header 
#  is preserved. Changes to the code should be clearly indicated.   
#
#  This code is distributed under the GPL.
#  (http://www.gnu.org/copyleft/gpl.html)
#
#  For more detailed licensing information see cups-pdf.c in the 
#  corresponding version number.			             

###########################################################################
#									  #
# This is the configuration file for CUPS-PDF. Values that are not set in #
# here will use the defaults. Changes take effect immediately without the #
# need for restarting any services.					  #
#									  #
# Take care not to add whitespaces at the end of a line!		  #
#									  #
# Options are marked where they can be set (setting via PPD requires the  #
# PPD file that comes with CUPS-PDF to be used!).                         #
# Options passed via lpoptions that are not named for lpoptions here are  #
# ignored.                                                                #
# Options precedence is as follows:                                       #
# 1st: lpoptions                                                          #
# 2nd: PPD settings                                                       #
# 3rd: config file (this file)                                            #
# 4th: default values                                                     #
###########################################################################


###########################################################################
#									  #
# Path Settings								  #
#									  #
###########################################################################

### Key: Out (config)
##  CUPS-PDF output directory 
##  special qualifiers: 
##     ${HOME} will be expanded to the user's home directory
##     ${USER} will be expanded to the user name
##  in case it is an NFS export make sure it is exported without
##  root_squash! 
### Default: /var/spool/cups-pdf/${USER}

#Out /var/spool/cups-pdf/${USER}

### Key: AnonDirName (config)
##  ABSOLUTE path for anonymously created PDF files
##  if anonymous access is disabled this setting has no effect
### Default: /var/spool/cups-pdf/ANONYMOUS

#AnonDirName /var/spool/cups-pdf/ANONYMOUS

### Key: Spool (config)
##  CUPS-PDF spool directory - make sure there is no user 'SPOOL' on your
##  system or change the path	
### Default: /var/spool/cups-pdf/SPOOL

#Spool /var/spool/cups-pdf/SPOOL


###########################################################################
#									  #
# Filename Settings							  #
#									  #
###########################################################################

### Key: Truncate (config, ppd, lpoptions)
##  truncate long filenames to a maximum of <Truncate> characters
##  this does not consider the full path to the output but only the filename
##  without the .pdf-extension or a job-id prefix (see 'Label')
##  the minimal value is 8
### Default: 64

#Truncate 64

### Key: Cut (config, lpoptions)
##  removing file name extensions before appending .pdf to output
##  extensions will only be removed if _both_ the following criteria are met:
##   - the extension (w/o the dot) is not longer than <Cut> characters
##   - the remaining filename has a minimal length of 1 character
##  set Cut to -1 in order to disable cutting
##  recommended values: pure UNIX environment : -1
##                      mixed environments    :  3
### Default: 3

#Cut 3

### Key: Label (config, ppd, lpoptions)
##  label all jobs with a unique job-id in order to avoid overwriting old
##  files in case new ones with identical names are created; always true for
##  untitled documents
##  0: label untitled documents only
##  1: label all documents with a preceeding "job_#-"
##  2: label all documents with a tailing "-job_#"
### Default: 0

#Label 0

### Key: TitlePref (config, ppd, lpoptions)
##  where to look first for a title when creating the output filename
##  (title in PS file or title on commandline):
##  0: prefer title from %Title statement in the PS file
##  1: prefer title passed via commandline 
### Default: 0

#TitlePref 0


###########################################################################
#									  #
# User Settings								  #
#									  #
###########################################################################

### Key: AnonUser (config)
##  uid for anonymous PDF creation (this might be a security issue)
##  this setting has no influence on AnonDirName (see there)
##  set this to an empty value to disable anonymous
### Default: nobody

#AnonUser nobody

### Key: LowerCase (config)
##  This options allows to check user names given to CUPS-PDF additionally 
##  against their lower case variants. This is necessary since in some 
##  Windows environments only upper case user names are passed. Usually UNIX
##  user names are all lower case and it is save to use this option  
##  but be aware that it can lead to mis-identifications in case
##  you have user names that differ only in upper/lower case.
##     check only against user name as passed to CUPS  : 0
##     check additionally against lower case user name : 1
### Default: 1

#LowerCase 1

### Key: UserPrefix (config)
##  some installations require a domain prefix added to the user name
##  leave empty for no prefix 
### Default: <empty>

#UserPrefix

### Key: DirPrefix (config)
##  if a prefix was defined above this switch toggels whether to include
##  the prefix in the output directory's name (if not $HOME) or not
##  0: do not include, 1: include
### Default: 0

#DirPrefix 0

### Key: RemovePrefix (config)
##  some installation pass usernames with a prefix (usually a domain name)
##  if you do not want this prefix to be used by the ${USER} variable for
##  output directories put the part which is to be cut here
### Default: <empty>

#RemovePrefix


###########################################################################
#									  #
# Security Settings							  #
#									  #
###########################################################################

### Key: AnonUMask (config)
##  umask for anonymous output
##  these are the _inverse_ permissions to be granted
### Default: 0000

#AnonUMask 0000

### Key: UserUMask (config, lptoptions)
##  umask for user output of known users
##  changing this can introduce security leaks if confidential
##  information is processed!
### Default: 0077

#UserUMask 0077

### Key: Grp (config)
##  group cups-pdf is supposed to run as - this will also be the gid for all
##  created directories and log files
### Default: lp

#Grp lp

### Key: AllowUnsafeOptions (config)
##  DON'T CHANGE THIS SETTING UNLESS YOU ABSOLUTELY KNOW WHAT YOU ARE DOING
##  set to 1 in order to allow users to override any option - including 
##  those that pose SEVERE SECURITY RISKS, set to 0 for full security
### Default: 0

#AllowUnsafeOptions 0


###########################################################################
#									  #
# Log Settings								  #
#									  #
###########################################################################

### Key: Log (config)
##  CUPS-PDF log directory 
##  set this to an empty value to disable all logging
### Default: /var/log/cups

#Log /var/log/cups

### Key: LogType (config, ppd)
##  log-mode 
##  1: errors
##  2: status (i.e. activity)
##  4: debug - this will generate a lot of log-output!
##  add up values to combine options, i.e. 7 is full logging
##  if logging is disabled these setting have no effect
### Default: 3

#LogType 3


###########################################################################
#									  #
# PDF Conversion Settings						  #
#									  #
###########################################################################

### Key: GhostScript (config)
##  location of GhostScript binary (gs) 
##  MacOSX: for using pstopdf (recommended) set this to /usr/bin/pstopdf
##          or its proper location on your system
### Default: /usr/bin/gs

#GhostScript /usr/bin/gs

### Key: GSTmp (config)
##  location of temporary files during GhostScript operation 
##  this must be user-writable like /var/tmp or /tmp ! 
### Default: /var/tmp

#GSTmp /var/tmp

### Key: GSCall (config)
## command line for calling GhostScript (!!! DO NOT USE NEWLINES !!!)
## MacOSX: for using pstopdf set this to %s %s -o %s %s
### Default: %s -q -dCompatibilityLevel=%s -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s

#GSCall %s -q -dCompatibilityLevel=%s -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s

### Key: PDFVer (config, ppd, lptopions)
##  PDF version to be created - can be "1.5", "1.4", "1.3" or "1.2" 
##  MacOSX: for using pstopdf set this to an empty value
### Default: 1.4

#PDFVer 1.4

### Key: PostProcessing (config, lptoptions)
##  postprocessing script that will be called after the creation of the PDF
##  as arguments the filename of the PDF, the username as determined by 
##  CUPS-PDF and the one as given to CUPS-PDF will be passed
##  the script will be called with user privileges
##  set this to an empty value to use no postprocessing
### Default: <empty>

#PostProcessing 


###########################################################################
#                                                                         #
# Experimental Settings                                                   #
#   These settings activate experimental options. If you decide to use    #
#   them I would appreciate any feedback - including an 'ok' if they      #
#   work as expected - so I can eventually put them into the non-         #
#   experimental sections.						  #
#                                                                         #
###########################################################################

### Key: DecodeHexStrings (config)
##  this option will try to decode hex strings in the title to allow
##  internationalized titles
##  (have a look at pstitleconv on www.cups-pdf.de for a suitable filter 
##   for data from Windows clients)
##  0: disable, 1: enable
### Default: 0

#DecodeHexStrings 0

### Key: FixNewlines (config)
##  this option will try to fix various unusal line delimiters (e.g.
##  form feeds)
##  especially useful when using non-Linux-generated files
##  0: disable, 1: enable
### Default: 0

#FixNewlines 0