NAME
smd-pull - syncs the local mail dir letting the remote one untouched
SYNOPSIS
smd-pull [-v|--verbose] [-t|--template-only] [endpoint]
DESCRIPTION
smd-pull performs in the local maildir all the changes that were
performed on remote one.
No changes are made on the remote maildir. Use smd-push(1) for that.
The first time this program is run a new config file is created and the
user is asked to edit it. If no endpoint is specified, the
configuration file is named ~/.smd/config.default, otherwise it is
named ~/.smd/config.endpoint. That file is composed by the following
fields
CLIENTNAME
name of the client host
SERVERNAME
name of the server host
MAILBOX
list of directories, separated by space
The field SERVERNAME must be a valid name for ssh, thus can be an alias
like
smd-server-foo.
The default config file contains an example of how to set up an
alias for ssh.
The field CLIENTNAME is just an ID for the local host. If you plan to
sync the same host with multiple remote hosts, you MUST use different
values for CLIENTNAME for every configuration file.
The config file is a regular shell script, refer to bash(1) for its
syntax.
The content of the directories ~/.smd/hooks/{pre,post}-pull.d/ is
executed respectively before and after smd-pull does it’s job. They
receive four arguments: "pre" or "post", "pull", the endpoint name and
the status. The status is always 0 (meaning success) for pre hooks,
while can be 1 (for failure) for post hooks. Hooks should not fail, if
they do so then smd-pull will fail too.
OPTIONS
-v --verbose
Verbose, machine readable, output
-t --template-only
Just create a template configuration file if none
endpoint
Is the suffix for the name of the configuration file to use. If
it is omitted, the configuration file ~/.smd/config.default is
used.
FILES
~/.smd/config.* ~/.smd/hooks/pre-pull.d/ ~/.smd/hooks/post-pull.d/
SEE ALSO
mddiff(1), smd-server(1), smd-client(1), smd-push(1), smd-loop(1)
AUTHOR
Enrico Tassi <gares@fettunta.org>
20 June 2010 smd-pull(1)