aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSteph Enders <steph@senders.io>2025-12-13 12:20:22 -0500
committerSteph Enders <steph@senders.io>2025-12-13 12:20:22 -0500
commit265ef114cba60a814b543ee7e0fb37f518f62f64 (patch)
tree547335cac913fd887aee26a47d4efe06394585e3 /docs
parent0f27a01063eb0d08445a82ba5a9380b3c490ffd8 (diff)
Add license and move documentation to its own folder
Diffstat (limited to 'docs')
-rw-r--r--docs/ssync.132
-rw-r--r--docs/ssync.559
2 files changed, 91 insertions, 0 deletions
diff --git a/docs/ssync.1 b/docs/ssync.1
new file mode 100644
index 0000000..c6571c8
--- /dev/null
+++ b/docs/ssync.1
@@ -0,0 +1,32 @@
+.TH ssync 1 "December 2025" "2.0.0"
+.SH NAME
+ssync
+.SH SYNOPSIS
+.B ssync
+.RB [OPTION]...
+.IR CONFIG_FILE
+.YS
+.SH DESCRIPTION
+.B ssync
+\- simple suite of syncing scripts
+.SH OPTIONS
+.TP
+.BI \-b " backend"
+Fetching backend: sftp (default) / rsync
+.TP
+.BR \-v " verbose logging"
+.TP
+.BR \-h " print this message"
+.SH SEE ALSO
+.MR ssync 5
+.MR ssync-index 1
+.MR ssync-queue 1
+.MR ssync-fetch 1
+.SH REPOSITORY
+.UR https://git.senders.io/utils/ssync.git
+.UE
+.SH AUTHORS
+Steph Enders
+.MT steph@senders.io
+.ME
+ssync is open source licensed under the ISC license. See LICENSE.txt for full copyright information.
diff --git a/docs/ssync.5 b/docs/ssync.5
new file mode 100644
index 0000000..f12319b
--- /dev/null
+++ b/docs/ssync.5
@@ -0,0 +1,59 @@
+.TH ssync 5
+.SH NAME
+ssync - configuration file
+.SH DESCRIPTION
+.MR ssync 1
+takes a configuration file as its parameter to read in the primary valus for executing an ssync process
+.TP
+.BI backend " sftp / rsync"
+Backend used for fetching remote files. Can be
+.MR sftp 1
+or
+.MR rsync 1
+.TP
+.BI fetch_output_dir " directory"
+The directory to write the fetched files to.
+.TP
+.BI index_window_s " seconds"
+Window in seconds to look back for new files while indexing. This option will limit indexing to only files newer than N seconds ago. This can help speed up indexing. Typical recommened default is 86400 (1 Day).
+.TP
+.BI key_file " identity_file"
+The
+.BR optional
+identity file used when connecting to remote hosts. See
+.MR ssh 1
+.MR ssh_config 5
+for more information on identity files and configurations.
+.TP
+.BI output_files_dir " directory"
+Directory the index and queue outputs will be written to. The recommended value is
+.IR $XDG_SHARE_DIR/ssync/runs/
+which will retain the outputs of each run in a subdirectory. This directory must exist prior to
+.MR ssync-index 1
+.MR ssync-queue 1
+running.
+.TP
+.BI remote_host " hostname"
+Remote Hostname to connect to when indexing and fetching remote files. This should be in the format
+.IR user@hostname
+unless a host alias is set in the users
+.MR ssh_config 5
+.TP
+.BI remote_root_dir " directory"
+The root directory on the remote host to be indexed.
+.TP
+.BI ssync_dir " directory"
+Directory containing the
+.MR ssync-index 1
+.MR ssync-queue 1
+.MR ssync-fetch 1
+commands.
+.SH AUTHOR
+Written by Steph Enders
+.SH SEE ALSO
+.MR ssync 1
+.MR ssync-index 1
+.MR ssync-queue 1
+.MR ssync-fetch 1
+
+