-
Notifications
You must be signed in to change notification settings - Fork 7
/
README.configure
365 lines (365 loc) · 24.8 KB
/
README.configure
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
--enable-maintainer_log - This allows the maintainer to write
additional large amount of debug
log data to a log file. So this
is only useful for the maintainer.
[Default: disabled]
--enable-confirmation_log - If you want to log all files names
which need confirmation you have to
enable this feature.
[Default: disabled]
--enable-transfer_rate_log - This writes the transfer rate into a
separate log file TRANSFER_RATE_LOG.
[Default: disabled]
--enable-systemd - Enables managing AFD via systemd.
[Default: disabled]
--disable-input_log - If you want to log all files names
on input you have to enable these
features. But note that enabling this
will pose a performance penalty,
especially if the log files are
very large.
[Default: enabled]
--disable-distribution_log - If you want to log all files
distributed you have to enable
these features. Note without this
alda (AFD Log Data Analyzer) will
not function properly.
[Default: enabled]
--disable-production_log - When enabled, this will make AFD log
all files it renamed or where it
changed its content.
[Default: enabled]
--disable-output_log - If you want to log all files names on
output you have to enable this
feature. But note that enabling this
will pose a performance penalty,
especially if the log files are
very large.
[Default: enabled]
--disable-delete_log - If enabled, all files names that are
deleted by the AFD get logged. They
can then be viewed with show_dlog. But
note that enabling this will pose a
performance penalty, especially if
lots of files get
deleted.
[Default: enabled]
--disable-ncurses_ui - Disables ncurses interface to AFD.
[Default: enabled]
--disable-error_queue - If enabled, AFD will queue error jobs
so that this will not block jobs that
work fine to another host.
[Default: enabled]
--disable-loc_support - Support for sending files locally.
[Default: enabled]
--disable-ftp_support - Support for the FTP protocol.
[Default: enabled]
--disable-sftp_support - Support for the SFTP protocol.
[Default: enabled]
--disable-smtp_support - Support for the SMTP protocol.
[Default: enabled]
--disable-http_support - Support for the HTTP protocol.
[Default: enabled]
--disable-wmo_support - Support for the special protocol used
by the WMO to transport data via TCP.
[Default: enabled]
--disable-fd_exec_support - Support for using an external program
to transmit the data.
[Default: enabled]
--disable-ssl - Disable TLS/SSL support for the FTP and
HTTP protocol.
[Default: enabled]
--enable-atpd_support - Enable support for the ATP daemon.
ATP is AFD's own transfer protocol.
[Default: disabled]
--disable-dupcheck_support - When enabled AFD will be able to check
the input and output for duplicates.
[Default: enabled]
--disable-largefile - Large file support does not work
properly on some older systems (linux
2.2.x and earlier) and cause severe
problems. So disable this when AFD
does not start or you have very
strange problems.
[Default: enabled]
--disable-verify_fsa - When enabled, every time something is
written to the FSA, it is checked
whether it is correct. If not enabled
you might see some incorrect numbers
in the 'afd_ctrl' dialog. Though this
is very seldom and if it does happen
can be corrected with fsa_edit.
[Default: enabled]
--disable-ignore_duplicate_jobs - Duplicate jobs are ignored by AFD when
this job is set. I cannot think of a
good reason why one wants to disable
this.
[Default: enabled]
--disable-auto_create_config - When during start AFD does not find a
configuration it creates some default,
so AFD does start.
[Default: enabled]
--disable-afd_ctrl_proc_check - By default the afd_ctrl dialog
periodically checks if the process amg,
fd, archive_watch and afdd are running.
This check should be disabled on
systems with shared filesystems
and afd_ctrl being called from a node
where AFD is not active.
[Default: enabled]
--disable-fifo_rw_support - Some systems do not support opening a
FIFO for reading and writing. With
this option set AFD will use two file
descriptors one for reading and one
for writing.
--disable-sse42 - Disables SSE4.2 optimizations ie.
support for hardware CRC-32 checksum
calculation.
--disable-inotify - Disables inotify support.
--disable-new_motif_name - Openmotif has been renamed to motif.
To solve problems on distributions
that still use openmotif provide
this option to use the old name.
--enable-html_gui - Enable HTML GUI.
--enable-ip_database - Enable AFD's own internal IP database.
This is only used when it fails lookup
the IP from DNS.
--enable-ascii_only_subject - Up to version 1.4.8-0.9.beta AFD
accepted only 7 bit ASCII subjects
for mail. Newer versions of AFD will
encode the subject to base64 if it
encounters a non 7 bit ASCII in the
mail subject. So, setting this option
will disable the automatic conversion
and restore the original behaviour.
--enable-dfax_support - Enable support for Divas Fax API
for sending Fax. With the option
--with-dfax-libraries=DIR one can
specify the path and libraries.
--enable-map_support - Enable support for DWD's MAP weather
visualisation tool. With the option
--with-map-libraries=DIR one can
specify the path and libraries.
--enable-de_mail_support - Enables the special DE-mail support
that is used in Germany.
--enable-report_empty_dir_scan - Enables reporting of empty directory
scans.
[Default: disabled]
--enable-with_afdbench_settings - Enables settings for running afdbench.
[Default: disabled]
--enable-expand_path_in_message - Enables expanding local relative path
in message. Advantage of this option is
that it will make AFD faster when it
distributes files locally. Disadvantage
is if a users home directory is changed
it is not noticed by AFD, you then need
to restart it.
[Default: disabled]
--enable-statistics_in_fifodir - Statistics are stored in fifodir.
[Default: log directory]
--enable-with_archive_copy_info - Inform when files are being copied
instead of being moved in TRANSFER_LOG.
[Default: disabled]
--enable-error_offline_for_new_host - New host will have the flag
'error + warnings offline' set.
--enable-setuid_progs - Enables setting setuid flag for the
programs afdcmd, afd, init_afd, mafd,
afd_ctrl, dir_ctrl, mon_ctrl and
show_olog. The setuid flag is required
if other users want to monitor or
control the AFD, other then the user
starting it. See also
--enable-group_can_write.
[Default: disabled]
--enable-with_unlink_delay - Enable delay when unlinking a file and
we get the error that the file is still
busy. With this enabled it will make a
short delay and then retry. This can be
set when AFD is running on an NFS file-
system.
[Default: disabled]
--enable-multi_dir_scans - Enable scanning of directories multiple
times. This is needed on some systems
where the modification time of
directories scanned by AFD is not
updated correctly. Normally it is not
needed to set this.
[Default: disabled]
--enable-multi_fs_support - Enable AFD scanning multiple local
filesystems without internal copying
of data.
[Default: disabled]
--enable-dir_check_cap_chown - Linux by default does not allow a
process to hardlink a file with a
different UID then the UID under
which the process is running. AFD
by default detects this situation
and then copies the file instead
of doing a simple hardlink.
Unfortunately this increases disk IO
considerably if the system
administrator does not disable this
in the kernel by setting
/proc/sys/fs/protected_hardlinks to 0.
Doing this can put your system at
a security risk. Compiling it will
give process dir_check the
capability to change the owner of a
file. This too will put your system
at risk. Note that just compiling
it with this option is not enough.
If you do not install the binary
via RPM you need, as root, set the
capability of the binary with:
setcap "CAP_CHOWN+p" dir_check
--enable-ftp_reuse_data_port - Reuse the FTP data port when sending
multiple files. This reduces the
number of sockets in TIME_WAIT
considerably. However it is dangerous
to enable this since it can lead
to data being lost on systems with
broken TCP-stack. Note on some
systems (darwin) it can slowdown the
system considerably.
[Default: disabled]
--enable-ms_error_workaround - Enables workaround for a bug in M$
Internet Information Server (IIS) FTP
server when renaming files.
[Default: disabled]
--enable-no_auto_basic_auth - Since HTTPS digest authentication
is hardly used by servers, AFD does
by default do a preemptive basic
authentication which saves a
request/challenge cycle. With
this option the user can disable
this.
--enable-group_can_write - The permissions of the fifos will have
write access to the fifos. This can be
used to allow users of the same group
have access to the AFD of another user.
See also --enable-setuid_progs.
[Default: disabled]
--enable-lockdebug - All locks are logged to SYSTEM_LOG.
This is only for debugging, so do not
enable this.
[Default: disabled]
--enable-show_exec_times - Show exec times after rereading
DIR_CONFIG.
[Default: disabled]
--enable-sendfile_support - Enables sendfile() support. This is
more efficient then the usual
combination of read() and write(),
since copying is done within the
kernel and no data needs to be
copied from/to user space (zero copy).
It has currently only been tested for
linux.
[Default: disabled]
--enable-splice_support - Enables splice() support. When copying
files the splice() system call is being
used. splice() moves data between two
file descriptors without copying
between kernel address space and user
address space. splice() is only
available for linux as of kernel 2.6.17
(tested it only as of 2.6.23).
[Default: disabled]
--enable-readyfile - Enables support for FSS ready files.
Only used within the German Weather
Service (DWD).
[Default: disabled]
--enable-passwd_in_msg - Write password in message file. This
makes it a bit faster when you have
to make lots of connections, since it
does not need to always look into the
password database.
[Default: disabled]
--enable-eumetsat - Support to write EUMETSAT headers into
each file send via FTP.
[Default: disabled]
--enable-editres - This enables the dynamic resource editor
for X Toolkit applications. This can be
used to edit X resources if you do not
like the defaults.
[Default: disabled]
--enable-efence - Enables the electric fence debugger to
debug AFD. Do not enable, it will make
AFD very slow and eat lots of memory.
[Default: disabled]
--enable-compile_afd_mon_only - This will compile the AFD monitor only.
--enable-onetime_support - Enables support for onetime jobs.
--enable-afd_mon - If set this will also compile all
programms to monitor other AFD´s too.
[Default: disabled]
--enable-compiler-debug - Turns on debugging to debug AFD.
[Default: disabled]
--enable-compiler-warn - Turns on lots of warning when compiling.
[Default: disabled]
--enable-compiler-analyzer - Turns on gcc static analyzer.
--enable-compiler-optimizations - Enables some compiler optimizations.
[Default: disabled]
--enable-compiler-profiling - Turns on compiler profiling support.
[Default: disabled]
--enable-use_fortify - Turns on fortify option of glibc/gcc.
Note this does not work with
--enable-compiler-debug
[Default: disabled]
--enable-compiler-security - On gcc this will turn on the compiler
option -pie (position independent
executables) and -fstack-protector
(check for buffer overflows).
[Default: disabled]
--enable-compiler-address-sanitizer - On gcc this will turn on the address
sanitizer. Notice this will increase
memory usage considerably.
[Default: disabled]
--enable-compile-64-bit - This forces AFD be compiled as 64 bit
application on system that support both
32 and 64 bit applications. On most 64
bit systems it is not necessary to set
this. This should only be used on
systems that have both 32 and 64 bit
and defaults to 32 bit.
[Default: disabled]
--enable-with_ctrl_accelerator - Use Ctrl key as accelerator key for X
application.
--with-gui=motif|none - Compile AFD with a certain graphical
user interface.
[Default: motif]
--enable-distro-rpm - Enables distribution style RPMS.
[Default: disabled]
--with-initdir=INITDIR - Directory where to put init/rc script
to start/stop AFD. It is strongly
recommended to NOT change this when
using RPMS, since here we use
chkconfig.
--with-sysconfigdir=SYSCONFIGDIR - Directory where to put sysconfig files
for AFD and AFDMON.
--with-rpm-binary-owner=OWNER - Owner name of binaries in RPM.
[Default: root]
--with-rpm-binary-group=GROUP - Group name of binaries in RPM.
[Default: OWNER]
--with-max-no-of-parallel-jobs=N - Maximum number of parallel transfer per
host alias. [Default: 9]
--with-default-no-of-parallel-jobs=N - Default number of parallel transfers
per host alias. [Default: 3]
--with-default-archive-unit=N - The default archive unit in seconds.
[Default: 86400]
--with-max-hostname-length=N - The maximum length that the host
alias name may have in afd_ctrl
dialog. [Default: 8]
--with-max-dir-alias-length=N - The maximum length that the directory
alias name may have. [Default: 10]
--with-max-afdname-length=N - The maximum length that the AFD
alias name may have in mon_ctrl
dialog. [Default: 12]
--with-max-real-hostname-length=N - The maximum length that the real
hostname or IP may have. [Default: 70]
--with-max-recipient-length=N - The maximum length that one recipient
may have, including the directory
entry. [Default 256]
--with-xor-key=KEY - With compiled in xor key KEY. Where
KEY can be any ASCII string. If this
is not set one needs to set the key
in $AFD_WORK_DIR/etc/.xor.key.
[Default: not set]