# lpjfiles.1

         NAME
              lpjfiles - Prints list of input/output files of LPJmL

         SYNOPSIS
              lpjfiles [-h] [-noinput] [-pp cmd] [-outpath dir] [-inpath
              dir] [-restartpath dir] [[-Dmacro[=value]] [-Idir] ...]
              [filename]

         DESCRIPTION
              Program prints list of all input and output files of LPJmL
              configuration files. It can be used to get a list of files
              to be archived.

         OPTIONS
              -h   display a short help text

              -noinput
                   does not list input data files

              -pp cmd
                   Set preprocessor program to cmd. Default is cpp -P.

              -outpath dir
                   set the output directory path. The path is added to the
                   output filenames if they do not contain an absolute
                   path.

              -inpath dir
                   set the input directory path. The path is added to the
                   input filenames if they do not contain an absolute
                   path.

              -Dmacro[=value]
                   define macro for the preprocessor of the configuration
                   file

              -Idir
                   define include directory for the preprocessor of the
                   configuration file

              filename
                   name of configuration file, default is lpjml.conf.

         EXAMPLES
         located in the scratch file system
              Archive files for default configuration file with input files
                   lpjfiles -input /scratch/01/lpj | tail -n +2 | tar -cf
                   files.tar -T -

         ENVIRONMENT
              LPJCONFIG
                   default LPJmL configuration filename

              LPJPREP
                   defines preprocessor command for LPJmL configuration
                   file, default is cpp -P. Same as '-pp' option.

              LPJROOT
                   defines the root directory for LPJmL. This directory is
                   added to the include directories of the preprocessor

              LPJINPATH
                   Path appended to the input filenames. Only done for
                   filenames without absolute path.

              LPJOPTIONS
                   runtime options for the preprocessor of LPJmL
                   configuration files

              LPJOUTPATH
                   Path appended to the output filenames. Only done for
                   filenames without absolute path.

              LPJRESTARTPATH
                   Path appended to the restart filenames. Only done for
                   filenames without absolute path.

         EXIT STATUS
              lpjfiles returns a zero exit status if the configuration
              file has no syntax errors.  Non zero is returned in case of
              failure.

         AUTHOR
              Werner von Bloh (Werner.von.Bloh@pik-potsdam.de)

         SEE ALSO
              lpjml(1), lpjcheck(1), lpjsave(1), lpjml.conf(5)