.\" This is man page contains an extract from unison \-doc all to give .\" the user a hint, where documentation can be find without duplicating it .\" here too much (done by Jens Elkner ). .\" .TH "UNISON" "1" "03/11/2015" "" "" .SH NAME unison \- File Synchronizer .SH SYNOPSIS .nh .na .HP \fBunison\fR [\-h] [options] .HP \fBunison\fR \fIroot1\fR \fIroot2\fR [options] .HP \fBunison\fR \fIprofilename\fR [options] .ad .hy .SH DESCRIPTION Unison is a file\-synchronization tool for Unix, Linux, BSD derived operating systems like MaxOSX and Windows. It allows two replicas of a collection of files and directories to be stored on different hosts (or different disks on the same host), modified separately, and then brought up to date by propagating the changes in each replica to the other. .SH OPTIONS To get detailed information about available options and how to run unison only, add an unknown option like \fB\-h\fR or type: .RS 5 .nf unison \-doc running | less .fi .RE .SH USAGE The detailed tutorial as well as documentation for the various features of Unison can be obtained either by typing the following command at the command line, or by selecting the Help menu in the graphical user interface if available: .RS 5 .nf unison \-doc all .fi .RE .P The full documentation in HTML, PostScript or PDF of unison as well as its source code can also be downloaded via http://www.cis.upenn.edu/~bcpierce/unison/download/releases/\ . .SH EXIT STATUS When running in the textual mode, Unison returns an exit status, which describes whether, and at which level, the synchronization was successful. The exit status could be useful when Unison is invoked from a script. Currently, there are four possible values for the exit status: .TP 3 .B 0 successful synchronization; everything is up\-to\-date now. .TP .B 1 some files were skipped, but all file transfers were successful. .TP .B 2 non\-fatal failures occurred during file transfer. .TP .B 3 a fatal error occurred, or the execution was interrupted. .P The graphical interface does not return any useful information through the exit status. .SH "NOTES" The source code for unison is available at http://www.cis.upenn.edu/~bcpierce/unison/ . .P The Solaris package contains the version \fB2.48\fR as well as the \fB2.40\fR unison binaries for backward compatibility. Thus a remote client gets per default connected to the most recent version aka .nh .BR unison . .hy However, if the client version is \fB!=\ 2.48\fR, the client will disconnect with a more or less meaningful message. In this case you may append the option .nh .B \-servercmd\ unison\-2.40 at the command line or add .B servercmd\ =\ unison\-2.40 .hy to the used profile and try again. Finally, adding an \fBunison\fR symlink to \fBunison\-2.40\fR in a directory comming before the one in your \fBPATH\fR environment variable, which contains the symlink to the most recent version may also work for you.