doc/config.example

   1 #
   2 # Example PWMD configuration file. Edit and save to ~/.pwmd/config or
   3 # specify with the -f command line option. See the pwmd(1) manual page for
   4 # complete details of the options.
   5 #
   6 # The global section is for non-file related settings and defaults for data
   7 # files without a file section.
   8 [global]
   9
  10 # Location of the listening socket.
  11 #socket_path=~/.pwmd/socket
  12
  13 # Socket permissions. This will override any umask setting.
  14 #socket_perms=0600
  15
  16 # Where data files will be read and stored.
  17 #data_directory=~/.pwmd/data
  18
  19 # If false, disable keeping backups for data files.
  20 #backup=true
  21
  22 # Log file location.
  23 #log_path=~/.pwmd/log
  24
  25 # Set to true to enable logging to log_path.
  26 #enable_logging=false
  27
  28 # Set to true to enable logging to syslog.
  29 #syslog=false
  30
  31 # Set to false to call mlockall(2) after a client connects. Uses alot more
  32 # memory but is also more secure. Most will probably find it overkill since
  33 # the contents of all memory is cleared before being freed. Note that this
  34 # doesn't affect the file cache which is always stored in RAM (if possible).
  35 #disable_mlockall=true
  36
  37 # Disable the XPATH, LIST and DUMP commands. When "true" and a client sends
  38 # these commands the error GPG_ERR_NOT_IMPLEMENTED will be returned.
  39 #disable_list_and_dump=false
  40
  41 # The number of encryption iterations for new files. This is the number of
  42 # times the data will be encrypted. Setting this to a high value (10000 or
  43 # more, depending on the size of the data file) will slow down dictionary
  44 # attacks. Setting to 0 will disable encryption.
  45 #iterations=1
  46
  47 # After the set number of encryption or decryption iterations have been
  48 # processed, a status message with the keyword ENCRYPT or DECRYPT will be
  49 # sent to the client. Set to 0 to disable.
  50 #iteration_progress=0
  51
  52 # When sending data to the client an XFER status message will be sent after
  53 # N bytes. N is rounded to ASSUAN_LINELENGTH (1002) bytes.
  54 #xfer_progress=8196
  55
  56 # A list of filenames separated by commas to add to the file cache upon
  57 # startup. You will be prompted for the key for each file if required. The
  58 # files are looked for in data_directory.
  59 #cache_push=somefile, anotherfile
  60
  61 # The number of seconds to keep a file in the cache. If -1, the file will be
  62 # kept forever. If 0, then every OPEN and SAVE command will require a key.
  63 #cache_timeout=-1
  64
  65 # Set to false to disable use of pinentry to retrieve keys.
  66 #enable_pinentry=true
  67
  68 # The full path to the pinentry binary. The default is specified at compile
  69 # time.
  70 #pinentry_path=/usr/bin/pinentry
  71
  72 # Seconds until the pinentry dialog times out. Set to 0 to wait for input
  73 # forever.
  74 #pinentry_timeout=20
  75
  76 # The default compression level for data files from 1 to 9, 1 being the
  77 # fastest but least compression and 9 being the slowest but best compression.
  78 # To disable compression entirely, set to 0.
  79 #compression_level=6
  80
  81 # The input and output buffer size when compressing and decompressing. This
  82 # affects how often the COMPRESS and DECOMPRESS status messages are sent and
  83 # also affects compression quality. Set to a higher value for larger files.
  84 #zlib_bufsize=65536
  85
  86 # The maximum recursion depth when resolving elements that contain a "target"
  87 # attribute. When this value is exceeded an error will be returned.
  88 #recursion_depth=20
  89
  90 # Sends a KEEPALIVE status message every N seconds. Set to 0 to disable (not
  91 # recommended).
  92 #keepalive=30
  93
  94 # The priority or nice value of the server process. The default is inherited
  95 # from the parent process.
  96 #priority=10
  97
  98 # END GLOBAL SETTINGS
  99
 100 # File specific settings are allowed by placing the filename in braces. Each
 101 # file can have it's own configuration settings from those listed below.
 102 #[somefile]
 103 #cache_timeout=300
 104 #iteration_progress=0
 105 #key=password
 106 #key_file=/path/to/file.key
 107 #compression_level=0
 108 #enable_pinentry=true
 109 #pinentry_timeout=20
 110 #backup=true