.TH "datalad create-sibling" "1" "2019\-02\-08" ""datalad create-sibling 0.11.2"" .SH NAME \fBdatalad create-sibling\fR \- create a dataset sibling on a UNIX-like SSH-accessible machine .SH SYNOPSIS .nh .HP \fBdatalad create\-sibling\fR [-h] [-s [NAME]] [--target-dir\~PATH] [--target-url\~URL] [--target-pushurl\~URL] [--dataset\~DATASET] [-r] [--recursion-limit\~LEVELS] [--existing\~MODE] [--shared\~false|true|umask|group|all|world|everybody|0xxx] [--group\~GROUP] [--ui\~false|true|html_filename] [--as-common-datasrc\~NAME] [--publish-by-default\~REFSPEC] [--publish-depends\~SIBLINGNAME] [--annex-wanted\~EXPR] [--annex-group\~EXPR] [--annex-groupwanted\~EXPR] [--inherit] [--since\~SINCE] [SSHURL] .hy .SH DESCRIPTION Given a local dataset, and SSH login information this command creates a remote dataset repository and configures it as a dataset sibling to be used as a publication target (see PUBLISH command). .PP Various properties of the remote sibling can be configured (e.g. name location on the server, read and write access URLs, and access permissions. .PP Optionally, a basic web\-viewer for DataLad datasets can be installed at the remote location. .PP This command supports recursive processing of dataset hierarchies, creating a remote sibling for each dataset in the hierarchy. By default, remote siblings are created in hierarchical structure that reflects the organization on the local file system. However, a simple templating mechanism is provided to produce a flat list of datasets (see \-\-target\-dir). .SH OPTIONS .TP SSHURL Login information for the target server. This can be given as a URL (ssh://host/path) or SSH-style (user@host:path). Unless overridden, this also serves the future dataset's access URL and path on the server. Constraints: value must be a string .TP \fB-h\fR, \fB--help\fR, \fB--help-np\fR show this help message. --help-np forcefully disables the use of a pager for displaying the help message .TP \fB-s\fR [NAME], \fB--name\fR [NAME] sibling name to create for this publication target. If RECURSIVE is set, the same name will be used to label all the subdatasets' siblings. When creating a target dataset fails, no sibling is added. Constraints: value must be a string [Default: None] .TP \fB--target-dir\fR PATH path to the directory *on the server* where the dataset shall be created. By default the SSH access URL is used to identify this directory. If a relative path is provided here, it is interpreted as being relative to the user's home directory on the server. Additional features are relevant for recursive processing of datasets with subdatasets. By default, the local dataset structure is replicated on the server. However, it is possible to provide a template for generating different target directory names for all (sub)datasets. Templates can contain certain placeholder that are substituted for each (sub)dataset. For example: "/mydirectory/dataset%RELNAME". Supported placeholders: %RELNAME - the name of the datasets, with any slashes replaced by dashes. Constraints: value must be a string [Default: None] .TP \fB--target-url\fR URL "public" access URL of the to-be-created target dataset(s) (default: SSHURL). Accessibility of this URL determines the access permissions of potential consumers of the dataset. As with TARGET_DIR, templates (same set of placeholders) are supported. Also, if specified, it is provided as the annex description. Constraints: value must be a string [Default: None] .TP \fB--target-pushurl\fR URL In case the TARGET_URL cannot be used to publish to the dataset, this option specifies an alternative URL for this purpose. As with TARGET_URL, templates (same set of placeholders) are supported. Constraints: value must be a string [Default: None] .TP \fB--dataset\fR \fI\s-1DATASET\s0\fR, \fB-d\fR \fI\s-1DATASET\s0\fR specify the dataset to create the publication target for. If no dataset is given, an attempt is made to identify the dataset based on the current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None] .TP \fB-r\fR, \fB--recursive\fR if set, recurse into potential subdataset. [Default: False] .TP \fB--recursion-limit\fR LEVELS limit recursion into subdataset to the given number of levels. Constraints: value must be convertible to type 'int' [Default: None] .TP \fB--existing\fR MODE action to perform, if a sibling is already configured under the given name and/or a target directory already exists. In this case, a dataset can be skipped ('skip'), an existing target directory be forcefully re-initialized, and the sibling (re-)configured ('replace', implies 'reconfigure'), the sibling configuration be updated only ('reconfigure'), or to error ('error'). Constraints: value must be one of ('skip', 'replace', 'error', 'reconfigure') [Default: 'error'] .TP \fB--shared\fR false|true|umask|group|all|world|everybody|0xxx if given, configures the access permissions on the server for multi-users (this could include access by a webserver!). Possible values for this option are identical to those of `git init --shared` and are described in its documentation. Constraints: value must be a string, or value must be convertible to type bool [Default: None] .TP \fB--group\fR GROUP Filesystem group for the repository. Specifying the group is particularly important when --shared=group. Constraints: value must be a string [Default: None] .TP \fB--ui\fR false|true|html_filename publish a web interface for the dataset with an optional user-specified name for the html at publication target. defaults to INDEX.HTML at dataset root. Constraints: value must be convertible to type bool, or value must be a string [Default: False] .TP \fB--as-common-datasrc\fR NAME configure the created sibling as a common data source of the dataset that can be automatically used by all consumers of the dataset (technical: git-annex auto-enabled special remote). [Default: None] .TP \fB--publish-by-default\fR REFSPEC add a refspec to be published to this sibling by default if nothing specified. Constraints: value must be a string [Default: None] .TP \fB--publish-depends\fR SIBLINGNAME add a dependency such that the given existing sibling is always published prior to the new sibling. This equals setting a configuration item 'remote.SIBLINGNAME.datalad-publish-depends'. This option can be given more than once to configure multiple dependencies. Constraints: value must be a string [Default: None] .TP \fB--annex-wanted\fR EXPR expression to specify 'wanted' content for the repository/sibling. See https://git-annex.branchable.com/git-annex-wanted/ for more information. Constraints: value must be a string [Default: None] .TP \fB--annex-group\fR EXPR expression to specify a group for the repository. See https://git-annex.branchable.com/git-annex-group/ for more information. Constraints: value must be a string [Default: None] .TP \fB--annex-groupwanted\fR EXPR expression for the groupwanted. Makes sense only if --annex-wanted="groupwanted" and annex-group is given too. See https://git-annex.branchable.com/git-annex-groupwanted/ for more information. Constraints: value must be a string [Default: None] .TP \fB--inherit\fR if sibling is missing, inherit settings (git config, git annex wanted/group/groupwanted) from its super-dataset. [Default: False] .TP \fB--since\fR \fI\s-1SINCE\s0\fR limit processing to datasets that have been changed since a given state (by tag, branch, commit, etc). This can be used to create siblings for recently added subdatasets. Constraints: value must be a string [Default: None] .SH AUTHORS datalad is developed by The DataLad Team and Contributors .