First AFD git commit based on 1.4.7-10

Author: holger24

ABOUT-NLS

@@ -0,0 +1,47 @@
+This is the credit-file of people that have contributed to the AFD project.
+It is sorted by name and formating is done as the CREDIT file for the linux
+kernel: N - name
+        E - email
+        W - web-address
+        P - PGP key ID and fingerprint
+        D - description
+        S - snail-mail address
+
+N: Tobias Freyberg 
+E:
+D: Helped designing AFD and author of the renaming stuff.
+S:
+S: Germany
+
+N: Holger Kiehl
+E: [email protected]
+D: Author and current maintainer of the AFD.
+S: Sossenheimer Weg 17
+S: 65843 Sulzbach
+S: Germany
+
+N: Herbert Lepper
+E: [email protected]
+D: Numerous bug fixes.
+S: Germany
+
+N: Jose Mauro/Leonardo Marra
+E: [email protected]/[email protected]
+D: Designed and made AFD logo.
+S: Brazil
+
+N: Sven Knudsen
+D: Bug fix and other improvements.
+S: Germany
+
+N: Bill Welch
+D: Improvement to SSH code and documentation.
+
+N: Alexander Maul
+D: Bug fix and other improvements.
+S: Germany
+
+
+Many thanks also to the Deutscher Wetterdienst (German Weather Service) at
+Offenbach, who have permitted me to make this work available under the
+GPL.

COPYING

@@ -0,0 +1 @@
+doc/Changelog

CREDITS

@@ -0,0 +1 @@
+doc/FAQ

Changelog

@@ -0,0 +1,18 @@
+
+
+AFD source code style:
+
+  - 3 level indent
+
+  - no tabs, spaces only
+
+  - braces for if/for/while statement on separate line:
+
+       if (foo)
+       {
+          bla();
+       }
+
+   - use braces even for single-statement blocks
+
+   - try to keep source lines shorter than 80 columns

FAQ

@@ -0,0 +1,94 @@
+
+
+1.) Run   ./configure   to generate config.h and the various Makefiles.
+    ./configure --help   gives a list of possible options with slightly
+    longer descriptions in README.configure.
+
+    Some systems require unusual options for compilation or linking that
+    the `configure' script does not know about.  You can give `configure'
+    initial values for variables by setting them in the environment.
+
+    You can do that on the command line like this:
+
+         ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
+
+2.) Set any other main preferences in:
+
+         src/afdsetup.h
+         src/init_afd/afddefs.h
+
+    But the defaults should be okay.
+
+3.) Build it:
+
+          make
+
+4.) After everything is compiled, install everything:
+
+          make install
+
+    Here are some more make options, mostly usfull if you are a
+    developer:
+
+    clean            : Removes all binaries, library, object files
+                       generated by a build.
+    distclean        : Same as above, but additionally delete all
+                       files created by configure.
+    maintainer-clean : Similar to the above only that it also removes
+                       all files generated by autoconfig and automake.
+    rpm              : Create a RPM.
+
+
+5.) Setting up AFD
+
+    The AFD can be configured in two files, DIR_CONFIG and HOST_CONFIG,
+    these can be found in the directory etc. Of these only the DIR_CONFIG
+    file is absolutely necessary, otherwise the AFD will not start up.
+
+    The following is an example entry in the DIR_CONFIG:
+
+    [directory]
+    /home/afd/data
+
+            [files]
+            *
+
+                    [destination]
+
+                            [recipient]
+                            ftp://user:passwd@test1//dir1/dir2
+
+                            [options]
+                            archive 3
+                            lock DOT
+                            priority 0
+
+    This tells the AFD to send any files (*) via FTP in the directory
+    /home/afd/data to the user 'user' at host test1 with the password
+    'passwd' into the directory '/dir1/dir2'. It also tells the AFD to
+    archive these files for three days and to send them with the priority
+    0 (very high). The option 'lock DOT' tells to send the files in dot
+    notation, i.e. the file name is first written with a dot at the beg-
+    ining. When the file has been transmitted it is renamed to its original
+    name.
+
+
+6.) Starting the AFD
+
+    To run the AFD ensure that the path of the binaries is in the
+    environment variable PATH. Set the environment variable AFD_WORK_DIR
+    to where you want the AFD to be running (ie. where it put its log files,
+    statistics, fifos, etc).  Make certain that you have valid entries in the
+    DIR_CONFIG, otherwise it will not run.
+
+    There are two possible ways to start the AFD. If you are running X you
+    just need to enter 'afd'. This will start all process needed to run the
+    AFD and the 'afd_ctrl' window. If you do not want to have the 'afd_ctrl'
+    window you can start the AFD only by entering 'afd -a'.
+
+
+7.) Stopping the AFD
+
+    Stopping the AFD is always done by entering 'afd -s'. This will stop
+    all process and remove all shared memory areas. Even when the AFD
+    fails to start properly, always use this command to stop it again.

HACKING

@@ -0,0 +1,15 @@
+
+
+Problem : If the LOCKFILE option is set and two or more process have finished
+          transfering their files, which process will remove the LOCKFILE?
+
+Problem : When starting AFD via mon_ctrl dialog the process do not get the
+          environment variables set in .profile (.bashrc, .kshrc, etc) when
+          using SSH.
+
+Problem : After a system crash and the system comes back and AFD is started
+          via /etc/init.d/afd, it can happen that it AFD does not start.
+Reason  : Since the command 'afd -a' starts init_afd and this puts itself
+          in the background it can happen that the process afd is terminated
+          before init_afd has put itself as daemon in the background.
+Solution: Process afd must wait for init_afd to initialize.

INSTALL

@@ -0,0 +1,62 @@
+## Makefile.am
+
+MAINTAINERCLEANFILES = Makefile.in aclocal.m4 configure ac-tools/config.guess\
+                       ac-tools/config.h.in ac-tools/config.h.in~\
+                       ac-tools/config.sub ac-tools/depcomp\
+                       ac-tools/install-sh ac-tools/missing\
+                       ac-tools/mkinstalldirs ac-tools/compile\
+                       $(PACKAGE)-$(VERSION).tar.gz\
+                       $(PACKAGE)-$(VERSION).tar.bz2\
+                       afd.spec\
+                       errors
+CLEANFILES           = core core.* typescript configmake.h configmake.h-t\
+                       po/$(PACKAGE).pot afd.spec\
+                       $(PACKAGE)-$(VERSION).tar.gz\
+                       $(PACKAGE)-$(VERSION).tar.bz2
+BUILT_SOURCES        = configmake.h
+SUBDIRS              = po src scripts doc
+DISTDOCS             = COPYING CREDITS INSTALL KNOWN-BUGS README.configure\
+                       THANKS TODO changes-1.2.x-1.3.x
+EXTRA_DIST           = ac-tools scripts afd.spec.in $(DISTDOCS)
+doc_DATA             = $(DISTDOCS)
+
+configmake.h:	Makefile
+	rm -f $@-t $@
+	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
+	  echo '#define PREFIX "$(prefix)"'; \
+	  echo '#define EXEC_PREFIX "$(exec_prefix)"'; \
+	  echo '#define BINDIR "$(bindir)"'; \
+	  echo '#define SBINDIR "$(sbindir)"'; \
+	  echo '#define LIBEXECDIR "$(libexecdir)"'; \
+	  echo '#define DATAROOTDIR "$(datarootdir)"'; \
+	  echo '#define DATADIR "$(datadir)"'; \
+	  echo '#define SYSCONFDIR "$(sysconfdir)"'; \
+	  echo '#define SHAREDSTATEDIR "$(sharedstatedir)"'; \
+	  echo '#define LOCALSTATEDIR "$(localstatedir)"'; \
+	  echo '#define INCLUDEDIR "$(includedir)"'; \
+	  echo '#define OLDINCLUDEDIR "$(oldincludedir)"'; \
+	  echo '#define DOCDIR "$(docdir)"'; \
+	  echo '#define INFODIR "$(infodir)"'; \
+	  echo '#define HTMLDIR "$(htmldir)"'; \
+	  echo '#define DVIDIR "$(dvidir)"'; \
+	  echo '#define PDFDIR "$(pdfdir)"'; \
+	  echo '#define PSDIR "$(psdir)"'; \
+	  echo '#define LIBDIR "$(libdir)"'; \
+	  echo '#define LISPDIR "$(lispdir)"'; \
+	  echo '#define LOCALEDIR "$(localedir)"'; \
+	  echo '#define MANDIR "$(mandir)"'; \
+	  echo '#define MANEXT "$(manext)"'; \
+	  echo '#define PKGDATADIR "$(pkgdatadir)"'; \
+	  echo '#define PKGINCLUDEDIR "$(pkgincludedir)"'; \
+	  echo '#define PKGLIBDIR "$(pkglibdir)"'; \
+	  echo '#define PKGLIBEXECDIR "$(pkglibexecdir)"'; \
+	} | sed '/""/d' > $@-t
+	mv $@-t $@
+
+rpm:	dist
+	$(RPM) -ta $(PACKAGE)-$(VERSION).tar.bz2 </dev/null;
+
+dist-hook:
+	cp afd.spec $(distdir)
+
+.PHONY: rpm