EFETCH

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT
FILES
EXAMPLES
AUTHOR
REPORTING BUGS
COPYRIGHT
SEE ALSO

NAME

efetch - stages pending email notifications from NOAH Database

SYNOPSIS

efetch [OPTIONS]

DESCRIPTION

efetch is an administration program that processes the NOAH Database pending email notifications and creates a staging area in the database where the companion program esend can then process and send messages at a more leisurely pace.

There may be a wrapper script in /usr/bin with noah- prefix that calls this program in the correct run directory.

efetch locks the database so there is no data corruption where as esend does not need to do this.

efetch also re-generates the user GROUP and WORLD email lists in the NOAH database to be used by esend if necessary.

Staging and sequencing
efetch
tests two files in the NOAH database.

if DATA_DIR/sendmail.tab does not exist, no action is taken and program aborts.

if DATA_DIR/email/sendmail.tab exists (note email directory) then again, nothing is done because esend will delete this file when finished ... so efetch will assume esend is still working on sending emails and abort to be called at a later time.

OPTIONS

efetch [-v] [-vv] [-q] [-h] [-help] [-database DATABASE] [-m n]

-m N set chmod to N (octal) when creating DATA_DIR/email directory. Defaults to 0750.

-database DATABASE

Defaults to default but if you want to change it to a different database name you can do so with this command.

-v Print more verbose messages to screen to tell you what it is thinking ...

-vv Print even more verbose messages to screen to tell you what it really is thinking ...

-q quiet - no messages to screen. -h short usage help

-help This help document.

ENVIRONMENT

This program is found in the admin directory and expects to be run from there.

In a Debian distribution, this program has a link to the wrapper program in the admin directory typically /usr/lib/noah/admin and the link name has a noah- prefix and is found in /usr/bin.

NOTE: In a typical installation, the email.bash or email.bat script is what calls this program along with the companion esend both of which are found in the admin directory.

FILES

/usr/bin/efetch

This is a link to wrapper

/usr/lib/noah/admin/wrapper

This is a generic bash shell wrapper to start the program in the admin directory.

/usr/lib/noah/admin/efetch

This is the actual executable called by the wrapper.

/usr/lib/noah/database.config

This is typically a link to /etc/noah/database.config in a Debian release.

DATA_DIR/sendmail.tab

Pending email messages created by NOAH Database user interaction.

DATA_DIR/email/sendmail.tab

Expanded (more fields) database file created by efetch and deleted by esend when finished.

EXAMPLES

efetch -v -n 0700
Process pending emails and prepare for esend to do the email sending!

Create email directory with 0700 permissions.

AUTHOR

Harold Blount - Nordicwind Inc. www.nordicwind.ca

REPORTING BUGS

http://noah.@nordicwind.ca

COPYRIGHT

NOAH - Copyright (c) 2004-2012 Nordicwind Inc. All rights reserved. <http://www.nordicwind.ca>

This is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 or later <http://gnu.org/licenses/gpl.html>.

This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

noah-esend noah-purge noah-gentext noah-help

Noah Document Management Server : http://noah.nordicwind.ca