/cups/cups-pdf.conf

  1#  cups-pdf.conf -- CUPS Backend Configuration (version 2.5.0, 2009-01-26)
  2#  18.09.2005, Volker C. Behr
  3#  Experimentelle Physik V, Universitaet Wuerzburg 
  4#  behr@physik.uni-wuerzburg.de
  5#  http://www.cups-pdf.de
  6#
  7#
  8#  This code may be freely distributed as long as this header 
  9#  is preserved. Changes to the code should be clearly indicated.   
 10#
 11#  This code is distributed under the GPL.
 12#  (http://www.gnu.org/copyleft/gpl.html)
 13#
 14#  For more detailed licensing information see cups-pdf.c in the 
 15#  corresponding version number.			             
 16
 17###########################################################################
 18#									  #
 19# This is the configuration file for CUPS-PDF. Values that are not set in #
 20# here will use the defaults. Changes take effect immediately without the #
 21# need for restarting any services.					  #
 22#									  #
 23# Take care not to add whitespaces at the end of a line!		  #
 24#									  #
 25###########################################################################
 26
 27
 28###########################################################################
 29#									  #
 30# Path Settings								  #
 31#									  #
 32###########################################################################
 33
 34### Key: Out
 35##  CUPS-PDF output directory 
 36##  special qualifiers: 
 37##     ${HOME} will be expanded to the user's home directory
 38##     ${USER} will be expanded to the user name
 39##  in case it is an NFS export make sure it is exported without
 40##  root_squash! 
 41### Default: /var/spool/cups-pdf/${USER}
 42
 43Out ${HOME}/PDF
 44
 45### Key: AnonDirName
 46##  ABSOLUTE path for anonymously created PDF files
 47##  if anonymous access is disabled this setting has no effect
 48### Default: /var/spool/cups-pdf/ANONYMOUS
 49
 50#AnonDirName /var/spool/cups-pdf/ANONYMOUS
 51
 52### Key: Spool
 53##  CUPS-PDF spool directory - make sure there is no user 'SPOOL' on your
 54##  system or change the path	
 55### Default: /var/spool/cups-pdf/SPOOL
 56
 57#Spool /var/spool/cups-pdf/SPOOL
 58
 59
 60###########################################################################
 61#									  #
 62# Filename Settings							  #
 63#									  #
 64###########################################################################
 65
 66### Key: Truncate
 67##  truncate long filenames to a maximum of <Truncate> characters
 68##  this does not consider the full path to the output but only the filename
 69##  without the .pdf-extension or a job-id prefix (see 'Label')
 70##  the minimal value is 8
 71### Default: 64
 72
 73#Truncate 64
 74
 75### Key: Cut
 76##  removing file name extensions before appending .pdf to output
 77##  extensions will only be removed if _both_ the following criteria are met:
 78##   - the extension (w/o the dot) is not longer than <Cut> characters
 79##   - the remaining filename has a minimal length of 1 character
 80##  set Cut to -1 in order to disable cutting
 81##  recommended values: pure UNIX environment : -1
 82##                      mixed environments    :  3
 83### Default: 3
 84
 85#Cut 3
 86
 87### Key: Label
 88##  label all jobs with a unique job-id in order to avoid overwriting old
 89##  files in case new ones with identical names are created; always true for
 90##  untitled documents
 91##  0: label untitled documents only, 1: label all documents
 92### Default: 0
 93
 94Label 0
 95
 96### Key: TitlePref
 97##  where to look first for a title when creating the output filename
 98##  (title in PS file or title on commandline):
 99##  0: prefer title from %Title statement in the PS file
100##  1: prefer title passed via commandline 
101### Default: 0
102
103#TitlePref 0
104
105
106###########################################################################
107#									  #
108# User Settings								  #
109#									  #
110###########################################################################
111
112### Key: AnonUser
113##  uid for anonymous PDF creation (this might be a security issue)
114##  this setting has no influence on AnonDirName (see there)
115##  set this to an empty value to disable anonymous
116### Default: nobody
117
118#AnonUser nobody
119
120### Key: LowerCase
121##  This options allows to check user names given to CUPS-PDF additionally 
122##  against their lower case variants. This is necessary since in some 
123##  Windows environments only upper case user names are passed. Usually UNIX
124##  user names are all lower case and it is save to use this option  
125##  but be aware that it can lead to mis-identifications in case
126##  you have user names that differ only in upper/lower case.
127##     check only against user name as passed to CUPS  : 0
128##     check additionally against lower case user name : 1
129### Default: 1
130
131#LowerCase 1
132
133### Key: UserPrefix
134##  some installations require a domain prefix added to the user name
135##  leave empty for no prefix 
136### Default: <empty>
137
138#UserPrefix
139
140### Key: DirPrefix
141##  if a prefix was defined above this switch toggels whether to include
142##  the prefix in the output directory's name (if not $HOME) or not
143##  0: do not include, 1: include
144### Default: 0
145
146#DirPrefix 0
147
148### Key: RemovePrefix
149##  some installation pass usernames with a prefix (usually a domain name)
150##  if you do not want this prefix to be used by the ${USER} variable for
151##  output directories put the part which is to be cut here
152### Default: <empty>
153
154#RemovePrefix
155
156
157###########################################################################
158#									  #
159# Security Settings							  #
160#									  #
161###########################################################################
162
163### Key: AnonUMask
164##  umask for anonymous output
165##  these are the _inverse_ permissions to be granted
166### Default: 0000
167
168#AnonUMask 0000
169
170### Key: UserUMask
171##  umask for user output of known users
172##  changing this can introduce security leaks if confidential
173##  information is processed!
174### Default: 0077
175
176#UserUMask 0077
177
178### Key: Grp
179##  group cups-pdf is supposed to run as - this will also be the gid for all
180##  created directories and log files
181### Default: lp
182
183Grp lpadmin
184
185###########################################################################
186#									  #
187# Log Settings								  #
188#									  #
189###########################################################################
190
191### Key: Log
192##  CUPS-PDF log directory 
193##  set this to an empty value to disable all logging
194### Default: /var/log/cups
195
196#Log /var/log/cups
197
198### Key: LogType
199##  log-mode 
200##  1: errors
201##  2: status (i.e. activity)
202##  4: debug - this will generate a lot of log-output!
203##  add up values to combine options, i.e. 7 is full logging
204##  if logging is disabled these setting have no effect
205### Default: 3
206
207LogType 1
208
209
210###########################################################################
211#									  #
212# PDF Conversion Settings						  #
213#									  #
214###########################################################################
215
216### Key: GhostScript
217##  location of GhostScript binary (gs) 
218##  MacOSX: for using pstopdf (recommended) set this to /usr/bin/pstopdf
219##          or its proper location on your system
220### Default: /usr/bin/gs
221
222#GhostScript /usr/bin/gs
223
224### Key: GSTmp
225##  location of temporary files during GhostScript operation 
226##  this must be user-writable like /var/tmp or /tmp ! 
227### Default: /var/tmp
228
229#GSTmp /var/tmp
230
231### Key: GSCall
232## command line for calling GhostScript (!!! DO NOT USE NEWLINES !!!)
233## MacOSX: for using pstopdf set this to %s %s -o %s %s
234### Default: %s -q -dCompatibilityLevel=%s -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s
235
236#GSCall %s -q -dCompatibilityLevel=%s -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s
237
238### Key: PDFVer
239##  PDF version to be created - can be "1.5", "1.4", "1.3" or "1.2" 
240##  MacOSX: for using pstopdf set this to an empty value
241### Default: 1.4
242
243#PDFVer 1.4
244
245### Key: PostProcessing
246##  postprocessing script that will be called after the creation of the PDF
247##  as arguments the filename of the PDF, the username as determined by 
248##  CUPS-PDF and the one as given to CUPS-PDF will be passed
249##  the script will be called with user privileges
250##  set this to an empty value to use no postprocessing
251### Default: <empty>
252
253#PostProcessing 
254
255
256###########################################################################
257#                                                                         #
258# Experimental Settings                                                   #
259#   These settings activate experimental options. If you decide to use    #
260#   them I would appreciate any feedback - including an 'ok' if they      #
261#   work as expected - so I can eventually put them into the non-         #
262#   experimental sections.						  #
263#                                                                         #
264###########################################################################
265
266### Key: DecodeHexStrings
267##  this option will try to decode hex strings in the title to allow 
268##  internationalized titles
269##  (have a look at contrib/pstitleconv for a suitable filter for data
270##   from Windows clients)
271##  0: disable, 1: enable
272### Default: 0
273
274#DecodeHexStrings 0