Provided by: gnumed-client_1.8.7+dfsg-1_all bug

NAME

       gm-import_incoming - a script to import a file into the INCOMING area of a GNUmed database.

SYNOPSIS

       gm-import_incoming  [-h|?]   [--help]  [--local-import]  --file2import=FILE  --data-type=TYPE --user=USER
       [--host=HOST] [--port=PORT]

DESCRIPTION

       gm-import_incoming is a script for importing a file into the GNUmed database area  where  incoming  files
       are  stored  which  have  not  been  linked to any patient. A type is associated with the data for easier
       recognition.

       This script can be used to import for later processing  fax  images,  lab  data,  referral  letters,  and
       similar data which electronically arrives on your system.

OPTIONS

       --help, -h, -?
              Show a help screen.

       --local-import
              At  startup  adjust  the  PYTHONPATH  such  that the GNUmed client is run from a local copy of the
              source tree (say, an unpacked tarball) rather than from a proper system-wide installation.

       --file2import=FILE
              This is the file to be imported into GNUmed.

              Successfully imported files are renamed to  FILE.imported  within  the  directory  in  which  FILE
              resides.

       --data-type=TYPE
              A  short  moniker,  say,  a word or two, used to describe the data in FILE to the user when viewed
              inside GNUmed.

              The actual content of TYPE is only limited by the execution environment (locale, encoding, ...) of
              gm-import_incoming.  GNUmed does not need to understand what TYPE means to the user.

       --user=USER
              The PostgreSQL user to be used for connecting to the database.

              Note  that  this  must  currently  be  a  GNUmed staff account. It will also work with the cluster
              superuser (usually "postgres") or the GNUmed database owner (typically "gm-dbo") but  using  these
              in production is strongly discouraged for data security reasons.

       --host=HOST
              The hostname of the machine PostgreSQL is running on, if required.

              If  this  option  is  not used (or set to an empty string) it will default to connecting over UNIX
              domain sockets.

       --port=PORT
              The port PostgreSQL is listening on. Default PostgreSQL installations listen on port 5432.

       There are no options for database name or password.

       The script uses the default database name of the GNUmed version  the  script  is  released  with  thereby
       assuring data does not get imported into an older database following an upgrade.

       If  a  password  is  needed  (that  is, if TRUST, IDENT, or PEER authentication is not in use) it must be
       supplied by either setting the $PGPASSFILE environment variable or using a standard ~/.pgpass file.

ENVIRONMENT

       PGPASSFILE

            http://www.postgresql.org/docs/devel/static/libpq-pgpass.html

FILES

       ~/.pgpass

            http://www.postgresql.org/docs/devel/static/libpq-pgpass.html

SEE ALSO

       http://wiki.gnumed.de
              Detailed Wiki-style documentation

       /usr/share/doc/gnumed/
              Local documentation

       man -k gm-*
              List man pages on gm-* commands.