.TH "monotone" 1 "2016-07-11" "monotone 1.1" .SH "NAME" monotone \- a distributed version control system .SH "SYNOPSIS" \fBmtn\fP \fI[options...] command [arguments...]\fP .SH "DESCRIPTION" monotone is a highly reliable, very customizable distributed version control system that provides lightweight branches, history-sensitive merging and a flexible trust setup. monotone has an easy-to-learn command set and comes with a rich interface for scripting purposes and thorough documentation. For more information on monotone, visit \fBhttp://www.monotone.ca\fP. The complete documentation, including a tutorial for a quick start with the system, can be found online on \fBhttp://www.monotone.ca/docs\fP. .SH "GLOBAL OPTIONS" .IP "\-\-confdir " 25 set location of configuration directory .IP "\-\-date\-format " 25 strftime(3) format specification for printing dates .IP "\-\-db [ \-d ] " 25 set name of database .IP "\-\-dump " 25 file to dump debugging log to, on failure .IP "\-\-help [ \-h ]" 25 display help message .IP "\-\-ignore\-suspend\-certs / \-\-no\-ignore\-suspend\-certs" 25 do not ignore revisions marked as suspended .IP "\-\-key [ \-k ] / \-\-use\-default\-key" 25 sets the key for signatures, using either the key name or the key hash .IP "\-\-keydir " 25 set location of key store .IP "\-\-log " 25 file to write the log to .IP "\-\-no\-builtin\-rcfile / \-\-builtin\-rcfile" 25 do not load the built\-in lua file with the default hooks .IP "\-\-no\-default\-confdir / \-\-allow\-default\-confdir" 25 forbid use of the default confdir .IP "\-\-no\-format\-dates" 25 print date certs exactly as stored in the database .IP "\-\-no\-standard\-rcfiles / \-\-standard\-rcfiles" 25 do not load '~/.monotone/monotonerc' or '_MTN/monotonerc' lua files .IP "\-\-no\-workspace / \-\-allow\-workspace" 25 don't look for a workspace .IP "\-\-non\-interactive / \-\-interactive" 25 do not prompt the user for input .IP "\-\-quiet [ \-q ]" 25 decrease verbosity (undo previous '\-v', then disable informational output, then disable warnings) .IP "\-\-rcfile / \-\-clear\-rcfiles" 25 load extra lua file .IP "\-\-root " 25 limit search for workspace to specified root .IP "\-\-ssh\-sign " 25 controls use of ssh\-agent. valid arguments are: 'yes' to use ssh\-agent to make signatures if possible, 'no' to force use of monotone's internal code, 'only' to force use of ssh\-agent, 'check' to sign with both and compare .IP "\-\-ticker " 25 set ticker style (count|dot|none) .IP "\-\-timestamps" 25 show timestamps in front of errors, warnings and progress messages .IP "\-\-verbose [ \-v ]" 25 increase verbosity (undo previous '\-q', and then enable debug output) .IP "\-\-version" 25 print version number, then exit .IP "\-\-xargs [ \-@ ] " 25 insert command line arguments taken from the given file .SH "COMMANDS" .SS "command group 'automation'" Commands that aid in scripted execution. .IP "\fBautomate ancestors \fP REV1 [REV2 [REV3 [...]]]" 4 Prints the ancestors of the given revisions. .IP "\fBautomate ancestry_difference \fP NEW_REV [OLD_REV1 [OLD_REV2 [...]]]" 4 Lists the ancestors of the first revision given, not in the others. .IP "\fBautomate branches \fP" 4 Prints all branch certs in the revision graph. .IP "\fBautomate cert \fP REVISION\-ID NAME VALUE" 4 Adds a revision certificate. .IP "\fBautomate certs \fP REV" 4 Prints all certificates attached to a revision. .IP "\fBautomate checkout \fP [DIRECTORY]" 4 Checks out a revision from the database into a directory. If a revision is given, that's the one that will be checked out. Otherwise, it will be the head of the branch (given or implicit). If no directory is given, the branch name will be used as directory. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBautomate children \fP REV" 4 Prints the children of a revision. .IP "\fBautomate common_ancestors \fP REV1 [REV2 [REV3 [...]]]" 4 Prints revisions that are common ancestors of a list of revisions. .IP "\fBautomate content_diff \fP [FILE [...]]" 4 Calculates diffs of files. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-reverse" 4 reverse order of diff .IP "\-\-revision [ \-r ] " 4 select revision id for operation .IP "\-\-with\-header / \-\-without\-header" 4 show the matching cset in the diff header .RE .IP "\fBautomate descendents \fP REV1 [REV2 [REV3 [...]]]" 4 Prints the descendents of the given revisions. .IP "\fBautomate drop_attribute \fP PATH [KEY]" 4 Drops an attribute or all of them from a certain path. .IP "\fBautomate drop_db_variables \fP DOMAIN [NAME]" 4 Drops a database variable. .IP "\fBautomate drop_public_key \fP KEY_NAME_OR_HASH" 4 Drops a public key. .IP "\fBautomate erase_ancestors \fP [REV1 [REV2 [REV3 [...]]]]" 4 Erases the ancestors in a list of revisions. .IP "\fBautomate erase_descendants \fP [REV1 [REV2 [REV3 [...]]]]" 4 Erases the descendants in a list of revisions. .IP "\fBautomate file_merge \fP LEFT_REVID LEFT_FILENAME RIGHT_REVID RIGHT_FILENAME" 4 Prints the results of the internal line merger, given two child revisions and file names. .IP "\fBautomate generate_key \fP KEY_NAME PASSPHRASE" 4 Generates an RSA key\-pair. .RS .IP "\-\-force\-duplicate\-key" 4 force genkey to not error out when the named key already exists .RE .IP "\fBautomate get_attributes \fP PATH" 4 Prints all attributes for the specified path. If an explicit revision is given, the file's attributes at this specific revision are returned. .RS .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBautomate get_base_revision_id \fP" 4 Shows the revision on which the workspace is based. .IP "\fBautomate get_content_changed \fP REV FILE" 4 Lists the revisions that changed the content relative to another revision. .IP "\fBautomate get_corresponding_path \fP REV1 FILE REV2" 4 Prints the name of a file in a target revision relative to a given revision. .IP "\fBautomate get_current_revision \fP [PATHS ...]" 4 Shows change information for a workspace. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBautomate get_current_revision_id \fP" 4 Shows the revision of the current workspace. .IP "\fBautomate get_db_variables \fP [DOMAIN]" 4 Retrieve database variables. .IP "\fBautomate get_extended_manifest_of \fP REVISION" 4 Prints the extended manifest for the given identifier. .IP "\fBautomate get_file \fP FILEID" 4 Prints the contents of a file (given an identifier). .IP "\fBautomate get_file_of \fP FILENAME" 4 Prints the contents of a file (given a name). .RS .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBautomate get_file_size \fP FILEID" 4 Prints the size of a file (given an identifier). .IP "\fBautomate get_manifest_of \fP [REVID]" 4 Shows the manifest associated with a revision. .IP "\fBautomate get_option \fP OPTION" 4 Shows the value of an option. .IP "\fBautomate get_public_key \fP KEY_NAME_OR_HASH" 4 Prints a public key packet. .IP "\fBautomate get_revision \fP REVID" 4 Shows change information for a revision. .IP "\fBautomate get_workspace_root \fP" 4 Prints the workspace root for the current directory. .IP "\fBautomate graph \fP" 4 Prints the complete ancestry graph. .IP "\fBautomate heads \fP [BRANCH]" 4 Prints the heads of the given branch. .IP "\fBautomate identify \fP PATH" 4 Prints the file identifier of a file. .IP "\fBautomate interface_version \fP" 4 Prints the automation interface's version. .IP "\fBautomate inventory \fP [PATH]..." 4 Prints a summary of files found in the workspace. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-no\-corresponding\-renames / \-\-corresponding\-renames" 4 don't output corresponding renames if restricted on such nodes .IP "\-\-no\-ignored / \-\-ignored" 4 don't output ignored files .IP "\-\-no\-unchanged / \-\-unchanged" 4 don't output unchanged files .IP "\-\-no\-unknown / \-\-unknown" 4 don't output unknown files .RE .IP "\fBautomate keys \fP" 4 Lists all keys in the keystore. .IP "\fBautomate leaves \fP" 4 Lists the leaves of the revision graph. .IP "\fBautomate log \fP [PATH] ..." 4 Lists the selected revision history. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-from / \-\-clear\-from" 4 revision(s) to start logging at .IP "\-\-last " 4 limit log output to the last number of entries .IP "\-\-next " 4 limit log output to the next number of entries .IP "\-\-no\-merges / \-\-merges" 4 exclude merges when printing logs .IP "\-\-to / \-\-clear\-to" 4 revision(s) to stop logging at .RE .IP "\fBautomate lua \fP LUA_FUNCTION [ARG1 [ARG2 [...]]]" 4 Executes the given lua function and returns the result. .IP "\fBautomate packet_for_fdata \fP FILEID" 4 Prints the file data in packet format. .IP "\fBautomate packet_for_fdelta \fP OLD_FILE NEW_FILE" 4 Prints the file delta in packet format. .IP "\fBautomate packet_for_rdata \fP REVID" 4 Prints the revision data in packet format. .IP "\fBautomate packets_for_certs \fP REVID" 4 Prints the certs associated with a revision in packet format. .IP "\fBautomate parents \fP REV" 4 Prints the parents of a revision. .IP "\fBautomate pull \fP [URI]" 4 .PD 0 .IP "\fBautomate pull \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Pulls branches from a netsync server. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBautomate push \fP [URI]" 4 .PD 0 .IP "\fBautomate push \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Pushes branches to a netsync server. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-key\-to\-push " 4 push the specified key even if it hasn't signed anything .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBautomate put_file \fP [FILEID] CONTENTS" 4 Stores a file in the database. .IP "\fBautomate put_public_key \fP KEY\-PACKET\-DATA" 4 Store the public key in the database. .IP "\fBautomate put_revision \fP REVISION\-DATA" 4 Stores a revision into the database. .IP "\fBautomate read_packets \fP PACKET\-DATA" 4 Load the given packets into the database. .IP "\fBautomate remote \fP COMMAND [ARGS]" 4 Executes COMMAND on a remote server. .RS .IP "\-\-remote\-stdio\-host " 4 sets the host (and optionally the port) for a remote netsync action .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBautomate remote_stdio \fP [URI]" 4 .PD 0 .IP "\fBautomate remote_stdio \fP [ADDRESS[:PORTNUMBER]]" .PD Opens an 'automate stdio' connection to a remote server. .RS .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBautomate roots \fP" 4 Lists the roots of the revision graph. .IP "\fBautomate select \fP SELECTOR" 4 Lists the revisions that match a selector. .IP "\fBautomate set_attribute \fP PATH KEY VALUE" 4 Sets an attribute on a certain path. .IP "\fBautomate set_db_variable \fP DOMAIN NAME VALUE" 4 Sets a database variable. .IP "\fBautomate show_conflicts \fP [LEFT_REVID RIGHT_REVID]" 4 Shows the conflicts between two revisions. If no arguments are given, LEFT_REVID and RIGHT_REVID default to the first two heads that would be chosen by the 'merge' command. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-ignore\-suspend\-certs / \-\-no\-ignore\-suspend\-certs" 4 do not ignore revisions marked as suspended .RE .IP "\fBautomate stdio \fP" 4 Automates several commands in one run. .RS .IP "\-\-automate\-stdio\-size " 4 block size in bytes for 'automate stdio' output .RE .IP "\fBautomate sync \fP [URI]" 4 .PD 0 .IP "\fBautomate sync \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Synchronizes branches with a netsync server. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-key\-to\-push " 4 push the specified key even if it hasn't signed anything .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBautomate tags \fP [BRANCH_PATTERN]" 4 Prints all tags attached to a set of branches. .IP "\fBautomate toposort \fP [REV1 [REV2 [REV3 [...]]]]" 4 Topologically sorts a list of revisions. .IP "\fBautomate update \fP" 4 Updates the workspace. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .SS "command group 'database'" Commands that manipulate the database. .IP "\fBdb changesetify \fP" 4 Converts the database to the changeset format. .IP "\fBdb check \fP" 4 Does some sanity checks on the database. Ensures that the database is consistent by issuing multiple checks. .IP "\fBdb dump \fP" 4 Dumps the contents of the database. Generates a list of SQL instructions that represent the whole contents of the database. The resulting output is useful to later restore the database from a text file that serves as a backup. .IP "\fBdb execute \fP" 4 Executes an SQL command on the database. Directly executes the given SQL command on the database .IP "\fBdb fix_certs \fP" 4 Attempt to fix bad certs. Older monotone versions could sometimes associate certs with the wrong key. This fixes such certs if you have the correct key, and can optionally drop any certs that you don't have the correct key for. This should only be needed if you had such certs in your db when upgrading from 0.44 or earlier, or if you loaded such certs with 'mtn read'. .RS .IP "\-\-drop\-bad\-certs" 4 drop certs signed by keys we don't know about .RE .IP "\fBdb info \fP" 4 Shows information about the database. .RS .IP "\-\-full / \-\-concise" 4 print detailed information .RE .IP "\fBdb init \fP" 4 Initializes a database. Creates a new database file and initializes it. .IP "\fBdb load \fP" 4 Loads the contents of the database. Reads a list of SQL instructions that regenerate the contents of the database. This is supposed to be used in conjunction with the output generated by the 'dump' command. .IP "\fBdb migrate \fP" 4 Migrates the database to a newer schema. Updates the database's internal schema to the most recent one. Needed to automatically resolve incompatibilities that may be introduced in newer versions of monotone. .IP "\fBdb regenerate_caches \fP" 4 Regenerates the caches stored in the database. .IP "\fBdb rosterify \fP" 4 Converts the database to the rosters format. .RS .IP "\-\-drop\-attr " 4 when rosterifying, drop attrs entries with the given key .RE .IP "\fBdb set_epoch \fP BRANCH EPOCH" 4 Sets the branch's epoch. .IP "\fBdb version \fP" 4 Shows the database's version. .IP "\fBlocal kill_certs \fP SELECTOR CERTNAME [CERTVAL]" 4 Deletes the specified certs from the local database. Deletes all certs which are on the given revision(s) and have the given name and if a value is specified then also the given value. .IP "\fBlocal kill_revision \fP REVID" 4 Kills a revision from the local database. .SS "command group 'debug'" Commands that aid in program debugging. .IP "\fBasciik \fP SELECTOR" 4 Prints an ASCII representation of the revisions' graph. .IP "\fBfdiff \fP SRCNAME DESTNAME SRCID DESTID" 4 Differences 2 files and outputs the result. .RS .IP "\-\-context" 4 use context diff format .IP "\-\-diff\-args " 4 argument to pass external diff hook .IP "\-\-external" 4 use external diff hook for generating diffs .IP "\-\-no\-show\-encloser / \-\-show\-encloser" 4 do not show the function containing each block of changes .IP "\-\-reverse" 4 reverse order of diff .IP "\-\-unified" 4 use unified diff format .IP "\-\-with\-header / \-\-without\-header" 4 show the matching cset in the diff header .RE .IP "\fBfload \fP" 4 Loads a file's contents into the database. .IP "\fBfmerge \fP PARENT_FILEID LEFT_FILEID RIGHT_FILEID" 4 Merges 3 files and outputs the result. .IP "\fBget_roster \fP [REVID]" 4 Dumps the roster associated with a given identifier. If no REVID is given, the workspace is used. .IP "\fBidentify \fP [PATH]" 4 Calculates the identity of a file or stdin. If any PATH is given, calculates their identity; otherwise, the one from the standard input is calculated. .IP "\fBrcs_import \fP RCSFILE..." 4 Parses versions in RCS files. This command doesn't reconstruct or import revisions. You probably want to use cvs_import. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .RE .SS "command group 'informative'" Commands for information retrieval. .IP "\fBannotate \fP PATH" 4 Prints an annotated copy of a file. Calculates and prints an annotated copy of the given file from the specified REVISION. .RS .IP "\-\-revision [ \-r ] " 4 select revision id for operation .IP "\-\-revs\-only" 4 annotate using full revision ids only .RE .IP "\fBbisect bad \fP" 4 Marks the current revision or specified revisions as bad. Known bad revisions are removed from the set being searched. .RS .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBbisect good \fP" 4 Marks the current revision or specified revisions as good. Known good revisions are removed from the set being searched. .RS .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBbisect reset \fP" 4 Reset the current bisection search. Update the workspace back to the revision from which the bisection was started and remove all current search information, allowing a new search to be started. .IP "\fBbisect skip \fP" 4 Excludes the current revision or specified revisions from the search. Skipped revisions are removed from the set being searched. Revisions that cannot be tested for some reason should be skipped. .RS .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBbisect status \fP" 4 Reports on the current status of the bisection search. Lists the total number of revisions in the search set, the number of revisions that have been determined to be good or bad, the number of revisions that have been skipped and the number of revisions remaining to be tested. .IP "\fBbisect update \fP" 4 Updates the workspace to the next revision to be tested by bisection. This command can be used if updates by good, bad or skip commands fail due to blocked paths or other problems. .RS .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .RE .IP "\fBcat \fP FILENAME" 4 Prints a file from the database. Fetches the given file FILENAME from the database and prints it to the standard output. .RS .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBcomplete \fP (revision|file|key) PARTIAL\-ID" 4 Completes a partial identifier. .IP "\fBdi \fP [PATH]..." 4 .PD 0 .IP "\fBdiff \fP [PATH]..." .PD Shows current differences. Compares the current tree with the files in the repository and prints the differences on the standard output. If one revision is given, the diff between the workspace and that revision is shown. If two revisions are given, the diff between them is given. If no format is specified, unified is used by default. .RS .IP "\-\-context" 4 use context diff format .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-diff\-args " 4 argument to pass external diff hook .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-external" 4 use external diff hook for generating diffs .IP "\-\-no\-show\-encloser / \-\-show\-encloser" 4 do not show the function containing each block of changes .IP "\-\-reverse" 4 reverse order of diff .IP "\-\-revision [ \-r ] " 4 select revision id for operation .IP "\-\-unified" 4 use unified diff format .IP "\-\-with\-header / \-\-without\-header" 4 show the matching cset in the diff header .RE .IP "\fBhelp \fP command [ARGS...]" 4 Displays help about commands and options. .RS .IP "\-\-hidden / \-\-no\-hidden" 4 show hidden commands and options .RE .IP "\fBlist branches \fP [PATTERN]" 4 Lists branches in the database that match a pattern. .RS .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBlist certs \fP REVID" 4 Lists certificates attached to a revision. .IP "\fBlist changed \fP [PATH...]" 4 Lists files that have changed with respect to the current revision. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBlist databases \fP" 4 .PD 0 .IP "\fBlist dbs \fP" .PD Lists managed databases and their known workspaces. .IP "\fBlist duplicates \fP" 4 Lists duplicate files in the specified revision. If no revision is specified, use the workspace. .RS .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBlist epochs \fP [BRANCH [...]]" 4 Lists the current epoch of branches that match a pattern. .IP "\fBlist ignored \fP [PATH]" 4 Lists workspace files that are ignored in the current branch. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-recursive [ \-R ] / \-\-no\-recursive" 4 also operate on the contents of any listed directories .RE .IP "\fBlist keys \fP [PATTERN]" 4 Lists keys that match a pattern. .IP "\fBlist known \fP" 4 Lists workspace files that belong to the current branch. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBlist missing \fP" 4 Lists files that belong to the branch but are not in the workspace. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBlist tags \fP [PATTERN]" 4 Lists all tags in the database. .RS .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBlist unknown \fP [PATH]" 4 Lists workspace files that are unknown in the current branch. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-recursive [ \-R ] / \-\-no\-recursive" 4 also operate on the contents of any listed directories .RE .IP "\fBlist vars \fP [DOMAIN]" 4 Lists variables in the whole database or a domain. .IP "\fBlist workspaces \fP" 4 Lists known workspaces of a specified database. .IP "\fBlog \fP [PATH] ..." 4 Prints selected history in forward or reverse order. This command prints selected history in forward or reverse order, filtering it by PATH if given. .RS .IP "\-\-brief / \-\-no\-brief" 4 print a brief version of the normal output .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-diffs / \-\-no\-diffs" 4 print diffs along with logs .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-from / \-\-clear\-from" 4 revision(s) to start logging at .IP "\-\-last " 4 limit log output to the last number of entries .IP "\-\-next " 4 limit log output to the next number of entries .IP "\-\-no\-files / \-\-files" 4 exclude files when printing logs .IP "\-\-no\-graph / \-\-graph" 4 do not use ASCII graph to display ancestry .IP "\-\-no\-merges / \-\-merges" 4 exclude merges when printing logs .IP "\-\-revision [ \-r ] " 4 select revision id for operation .IP "\-\-to / \-\-clear\-to" 4 revision(s) to stop logging at .RE .IP "\fBmanpage \fP" 4 Generate a manual page from monotone's command help. .RS .IP "\-\-formatted / \-\-plain" 4 automatically run the output through nroff (default if the output is a terminal) .IP "\-\-hidden / \-\-no\-hidden" 4 show hidden commands and options .RE .IP "\fBshow_conflicts \fP REV REV" 4 Shows what conflicts need resolution between two revisions. The conflicts are calculated based on the two revisions given in the REV parameters. .IP "\fBstatus \fP [PATH]..." 4 Shows workspace's status information. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .RE .IP "\fBversion \fP" 4 Shows the program version. .RS .IP "\-\-full / \-\-concise" 4 print detailed information .RE .SS "command group 'key_and_cert'" Commands to manage keys and certificates. .IP "\fBcert \fP SELECTOR CERTNAME [CERTVAL]" 4 Creates a certificate for a revision or set of revisions. Creates a certificate with the given name and value on each revision that matches the given selector .IP "\fBdropkey \fP KEY_NAME_OR_HASH" 4 Drops a public and/or private key. .IP "\fBgenkey \fP KEY_NAME" 4 Generates an RSA key\-pair. .RS .IP "\-\-force\-duplicate\-key" 4 force genkey to not error out when the named key already exists .RE .IP "\fBpassphrase \fP KEY_NAME_OR_HASH" 4 Changes the passphrase of a private RSA key. .IP "\fBssh_agent_add \fP" 4 Adds a private key to ssh\-agent. .IP "\fBssh_agent_export \fP [FILENAME]" 4 Exports a private key for use with ssh\-agent. .IP "\fBtrusted \fP REVISION NAME VALUE SIGNER1 [SIGNER2 [...]]" 4 Tests whether a hypothetical certificate would be trusted. The current settings are used to run the test. .SS "command group 'network'" Commands that access the network. .IP "\fBclone \fP URI [DIRECTORY]" 4 .PD 0 .IP "\fBclone \fP HOST[:PORTNUMBER] BRANCH [DIRECTORY]" .PD Checks out a revision from a remote database into a directory. If a revision is given, that's the one that will be checked out. Otherwise, it will be the head of the branch supplied. If no directory is given, the branch name will be used as directory .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBpull \fP [URI]" 4 .PD 0 .IP "\fBpull \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Pulls branches from a netsync server. This pulls all branches that match the pattern given in PATTERN from the netsync server at the address ADDRESS. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBpush \fP [URI]" 4 .PD 0 .IP "\fBpush \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Pushes branches to a netsync server. This will push all branches that match the pattern given in PATTERN to the netsync server at the address ADDRESS. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-key\-to\-push " 4 push the specified key even if it hasn't signed anything .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .RE .IP "\fBserve \fP" 4 Serves the database to connecting clients. .RS .IP "\-\-bind " 4 address:port to listen on (default :4691) .IP "\-\-pid\-file / \-\-no\-pid\-file" 4 record process id of server .RE .IP "\fBsync \fP [URI]" 4 .PD 0 .IP "\fBsync \fP [ADDRESS[:PORTNUMBER] [PATTERN ...]]" .PD Synchronizes branches with a netsync server. This synchronizes branches that match the pattern given in PATTERN with the netsync server at the address ADDRESS. .RS .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-key\-to\-push " 4 push the specified key even if it hasn't signed anything .IP "\-\-set\-default / \-\-no\-set\-default" 4 use the current netsync arguments and options as the future default .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .SS "command group 'packet_io'" Commands for packet reading and writing. .IP "\fBprivkey \fP KEY_NAME_OR_HASH" 4 Prints a private key packet. .IP "\fBpubkey \fP KEY_NAME_OR_HASH" 4 Prints a public key packet. .IP "\fBread \fP [FILE1 [FILE2 [...]]]" 4 Reads packets from files. If no files are provided, the standard input is used. .SS "command group 'review'" Commands to review revisions. .IP "\fBapprove \fP REVISION" 4 Approves a particular revision. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBcomment \fP REVISION [COMMENT]" 4 Comments on a particular revision. .IP "\fBdisapprove \fP [PARENT\-REVISION] CHILD\-REVISION" 4 Disapproves a particular revision or revision range. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-date " 4 override date/time for commit .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBsuspend \fP REVISION" 4 Suspends a particular revision. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBtag \fP REVISION TAGNAME" 4 Puts a symbolic tag certificate on a revision. .IP "\fBtestresult \fP REV (pass|fail|true|false|yes|no|1|0)" 4 Notes the results of running a test on a revision. .SS "command group 'tree'" Commands to manipulate the tree. .IP "\fBcheckout \fP [DIRECTORY]" 4 .PD 0 .IP "\fBco \fP [DIRECTORY]" .PD Checks out a revision from the database into a directory. If a revision is given, that's the one that will be checked out. Otherwise, it will be the head of the branch (given or implicit). If no directory is given, the branch name will be used as directory. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBconflicts clean \fP" 4 Delete any bookkeeping files related to conflict resolution. .IP "\fBconflicts resolve_first \fP RESOLUTION" 4 Set the resolution for the first unresolved single\-file conflict.. Use 'mtn conflicts show_first' to see possible resolutions. .RS .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBconflicts resolve_first_left \fP RESOLUTION" 4 Set the left resolution for the first unresolved two\-file conflict. .RS .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBconflicts resolve_first_right \fP RESOLUTION" 4 Set the right resolution for the first unresolved two\-file conflict. .RS .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBconflicts show_first \fP" 4 Show the first unresolved conflict in the conflicts file, and possible resolutions. .RS .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBconflicts show_remaining \fP" 4 Show the remaining unresolved conflicts in the conflicts file. .RS .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBconflicts store \fP [LEFT_REVID RIGHT_REVID]" 4 Store the conflicts from merging two revisions. If no arguments are given, LEFT_REVID and RIGHT_REVID default to the first two heads that would be chosen by the 'merge' command. If '\-\-conflicts\-file' is not given, '_MTN/conflicts' is used. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-conflicts\-file " 4 file in which to store conflicts .RE .IP "\fBexplicit_merge \fP LEFT\-REVISION RIGHT\-REVISION DEST\-BRANCH" 4 Merges two explicitly given revisions. The results of the merge are placed on the branch specified by DEST\-BRANCH. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-date " 4 override date/time for commit .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-resolve\-conflicts / \-\-no\-resolve\-conflicts" 4 specify conflict resolutions in a file, instead of interactively .IP "\-\-resolve\-conflicts\-file " 4 use file to resolve conflicts .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBheads \fP" 4 Shows unmerged head revisions of a branch. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .RE .IP "\fBimport \fP DIRECTORY" 4 Imports the contents of a directory into a branch. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-date " 4 override date/time for commit .IP "\-\-dry\-run / \-\-no\-dry\-run" 4 don't perform the operation, just show what would have happened .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-no\-respect\-ignore / \-\-respect\-ignore" 4 do not ignore any files .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBmerge \fP" 4 Merges unmerged heads of a branch. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-date " 4 override date/time for commit .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-resolve\-conflicts / \-\-no\-resolve\-conflicts" 4 specify conflict resolutions in a file, instead of interactively .IP "\-\-resolve\-conflicts\-file " 4 use file to resolve conflicts .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBmerge_into_dir \fP SOURCE\-BRANCH DEST\-BRANCH DIR" 4 Merges one branch into a subdirectory in another branch. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-date " 4 override date/time for commit .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-resolve\-conflicts / \-\-no\-resolve\-conflicts" 4 specify conflict resolutions in a file, instead of interactively .IP "\-\-resolve\-conflicts\-file " 4 use file to resolve conflicts .IP "\-\-update / \-\-no\-update" 4 automatically update the workspace, if it was at a head and the command creates a new head .RE .IP "\fBmerge_into_workspace \fP OTHER\-REVISION" 4 Merges a revision into the current workspace's base revision. Merges OTHER\-REVISION into the current workspace's base revision, and update the current workspace with the result. There can be no pending changes in the current workspace. Both OTHER\-REVISION and the workspace's base revision will be recorded as parents on commit. The workspace's selected branch is not changed. .RS .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .RE .IP "\fBmigrate_workspace \fP [DIRECTORY]" 4 Migrates a workspace directory's metadata to the latest format. If no directory is given, defaults to the current workspace. .IP "\fBpropagate \fP SOURCE\-BRANCH DEST\-BRANCH" 4 Merges from one branch to another asymmetrically. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-date " 4 override date/time for commit .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .IP "\-\-resolve\-conflicts / \-\-no\-resolve\-conflicts" 4 specify conflict resolutions in a file, instead of interactively .IP "\-\-resolve\-conflicts\-file " 4 use file to resolve conflicts .RE .IP "\fBrefresh_inodeprints \fP" 4 Refreshes the inodeprint cache. .IP "\fBsetup \fP [DIRECTORY]" 4 Sets up a new workspace directory. If no directory is specified, uses the current directory. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .RE .SS "command group 'variables'" Commands to manage persistent variables. .IP "\fBcleanup_workspace_list \fP" 4 Removes all invalid, registered workspace paths for the current database. .IP "\fBregister_workspace \fP [WORKSPACE_PATH]" 4 Registers a new workspace for the current database. This command adds WORKSPACE_PATH to the list of `known\-workspaces'. .IP "\fBset \fP DOMAIN NAME VALUE" 4 Sets a database variable. This command modifies (or adds if it did not exist before) the variable named NAME, stored in the database, and sets it to the given value in VALUE. The variable is placed in the domain DOMAIN. .IP "\fBunregister_workspace \fP [WORKSPACE_PATH]" 4 Unregisters an existing workspace for the current database. This command removes WORKSPACE_PATH to the list of `known\-workspaces'. .IP "\fBunset \fP DOMAIN NAME" 4 Unsets a database variable. This command removes the variable NAME from domain DOMAIN, which was previously stored in the database. .SS "command group 'vcs'" Commands for interaction with other version control systems. .IP "\fBcvs_import \fP CVSROOT" 4 Imports all versions in a CVS repository. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .RE .IP "\fBgit_export \fP" 4 Produces a git fast\-export data stream on stdout. .RS .IP "\-\-authors\-file " 4 file mapping author names from original to new values .IP "\-\-branches\-file " 4 file mapping branch names from original to new values .IP "\-\-export\-marks " 4 save the internal marks table after exporting revisions .IP "\-\-import\-marks " 4 load the internal marks table before exporting revisions .IP "\-\-log\-certs / \-\-no\-log\-certs" 4 include standard cert values in commit logs .IP "\-\-log\-revids / \-\-no\-log\-revids" 4 include revision ids in commit logs .IP "\-\-refs " 4 include git refs for 'revs', 'roots' or 'leaves' .IP "\-\-use\-one\-changelog" 4 use only one changelog cert for the git commit message .RE .SS "command group 'workspace'" Commands that deal with the workspace. .IP "\fBadd \fP [PATH]..." 4 Adds files to the workspace. .RS .IP "\-\-no\-respect\-ignore / \-\-respect\-ignore" 4 do not ignore any files .IP "\-\-recursive [ \-R ] / \-\-no\-recursive" 4 also operate on the contents of any listed directories .IP "\-\-unknown / \-\-no\-unknown" 4 perform the operations for unknown files from workspace .RE .IP "\fBattr drop \fP PATH [ATTR]" 4 Removes attributes from a file. If no attribute is specified, this command removes all attributes attached to the file given in PATH. Otherwise only removes the attribute specified in ATTR. .IP "\fBattr get \fP PATH [ATTR]" 4 Gets the values of a file's attributes. If no attribute is specified, this command prints all attributes attached to the file given in PATH. Otherwise it only prints the attribute specified in ATTR. .IP "\fBattr set \fP PATH ATTR VALUE" 4 Sets an attribute on a file. Sets the attribute given on ATTR to the value specified in VALUE for the file mentioned in PATH. .IP "\fBci \fP [PATH]..." 4 .PD 0 .IP "\fBcommit \fP [PATH]..." .PD Commits workspace changes to the database. .RS .IP "\-\-author " 4 override author for commit .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-date " 4 override date/time for commit .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-message [ \-m ] " 4 set commit changelog message .IP "\-\-message\-file " 4 set filename containing commit changelog message .RE .IP "\fBdrop \fP [PATH]..." 4 .PD 0 .IP "\fBrm \fP [PATH]..." .PD Drops files from the workspace. .RS .IP "\-\-bookkeep\-only" 4 only update monotone's internal bookkeeping, not the filesystem .IP "\-\-missing" 4 perform the operations for files missing from workspace .IP "\-\-recursive [ \-R ] / \-\-no\-recursive" 4 also operate on the contents of any listed directories .RE .IP "\fBmkdir \fP [DIRECTORY...]" 4 Creates directories and adds them to the workspace. .RS .IP "\-\-no\-respect\-ignore / \-\-respect\-ignore" 4 do not ignore any files .RE .IP "\fBpivot_root \fP NEW_ROOT PUT_OLD" 4 Renames the root directory. After this command, the directory that currently has the name NEW_ROOT will be the root directory, and the directory that is currently the root directory will have name PUT_OLD. Use of '\-\-bookkeep\-only' is NOT recommended. .RS .IP "\-\-bookkeep\-only" 4 only update monotone's internal bookkeeping, not the filesystem .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .RE .IP "\fBpluck \fP [PATH...]" 4 Applies changes made at arbitrary places in history. This command takes changes made at any point in history, and edits your current workspace to include those changes. The end result is identical to 'mtn diff \-r FROM \-r TO | patch \-p0', except that this command uses monotone's merger, and thus intelligently handles renames, conflicts, and so on. If one revision is given, applies the changes made in that revision compared to its parent. If two revisions are given, applies the changes made to get from the first revision to the second. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .IP "\fBmv \fP SRC DEST" 4 .PD 0 .IP "\fBmv \fP SRC1 [SRC2 [...]] DEST_DIR" .IP "\fBrename \fP SRC DEST" .IP "\fBrename \fP SRC1 [SRC2 [...]] DEST_DIR" .PD Renames entries in the workspace. .RS .IP "\-\-bookkeep\-only" 4 only update monotone's internal bookkeeping, not the filesystem .RE .IP "\fBrevert \fP [PATH]..." 4 Reverts files and/or directories. In order to revert the entire workspace, specify '.' as the file name. .RS .IP "\-\-depth " 4 limit the number of levels of directories to descend .IP "\-\-exclude " 4 leave out anything described by its argument .IP "\-\-missing" 4 perform the operations for files missing from workspace .RE .IP "\fBundrop \fP PATH..." 4 Reverses a mistaken 'drop'. If the file was deleted from the workspace, this is the same as 'revert'. Otherwise, it just removes the 'drop' from the manifest. .IP "\fBupdate \fP" 4 Updates the workspace. This command modifies your workspace to be based off of a different revision, preserving uncommitted changes as it does so. If a revision is given, update the workspace to that revision. If not, update the workspace to the head of the branch. .RS .IP "\-\-branch [ \-b ] " 4 select branch cert for operation .IP "\-\-move\-conflicting\-paths / \-\-no\-move\-conflicting\-paths" 4 move conflicting, unversioned paths into '_MTN/resolutions' before proceeding with any workspace change .IP "\-\-revision [ \-r ] " 4 select revision id for operation .RE .SH "SEE ALSO" info mtn and the documentation on \fBhttp://www.monotone.ca/docs\fP .SH "BUGS" Please report bugs to \fBhttps://code.monotone.ca/p/monotone/issues/\fP. .SH "AUTHORS" monotone was written originally by Graydon Hoare in 2003 and has since then received numerous contributions from many individuals. A complete list of authors can be found in AUTHORS. Nowadays, monotone is maintained by a collective of enthusiastic programmers, known as the monotone development team. .SH "COPYRIGHT" monotone and this man page is Copyright (c) 2003 \- 2016 by the monotone development team.