smd-pull

Langue: en

Autres versions - même langue

Version: 20 June 2010 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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>