1monotone(1) General Commands Manual monotone(1)
2
6 monotone - a distributed version control system
7
9 mtn [options...] command [arguments...]
10
12 monotone is a highly reliable, very customizable distributed version
13 control system that provides lightweight branches, history-sensitive
14 merging and a flexible trust setup. monotone has an easy-to-learn com‐
15 mand set and comes with a rich interface for scripting purposes and
16 thorough documentation.
17 For more information on monotone, visit http://www.monotone.ca.
19 The complete documentation, including a tutorial for a quick start with
21 the system, can be found online on http://www.monotone.ca/docs.
22
24 --confdir <arg> set location of configuration directory
25 --date-format <arg> strftime(3) format specification for printing
27 dates
28 --db [ -d ] <arg> set name of database
30 --dump <arg> file to dump debugging log to, on failure
32 --help [ -h ] display help message
34 --ignore-suspend-certs / --no-ignore-suspend-certs
36 do not ignore revisions marked as suspended
37 --key [ -k ] <arg> / --use-default-key
39 sets the key for signatures, using either the
40 key name or the key hash
41 --keydir <arg> set location of key store
43 --log <arg> file to write the log to
45 --no-builtin-rcfile / --builtin-rcfile
47 do not load the built-in lua file with the de‐
48 fault hooks
49 --no-default-confdir / --allow-default-confdir
51 forbid use of the default confdir
52 --no-format-dates print date certs exactly as stored in the
54 database
55 --no-standard-rcfiles / --standard-rcfiles
57 do not load '~/.monotone/monotonerc' or
58 '_MTN/monotonerc' lua files
59 --no-workspace / --allow-workspace
61 don't look for a workspace
62 --non-interactive / --interactive
64 do not prompt the user for input
65 --quiet [ -q ] decrease verbosity (undo previous '-v', then
67 disable informational output, then disable
68 warnings)
69 --rcfile <arg> / --clear-rcfiles
71 load extra lua file
72 --root <arg> limit search for workspace to specified root
74 --ssh-sign <arg> controls use of ssh-agent. valid arguments
76 are: 'yes' to use ssh-agent to make signatures
77 if possible, 'no' to force use of monotone's
78 internal code, 'only' to force use of
79 ssh-agent, 'check' to sign with both and com‐
80 pare
81 --ticker <arg> set ticker style (count|dot|none)
83 --timestamps show timestamps in front of errors, warnings
85 and progress messages
86 --verbose [ -v ] increase verbosity (undo previous '-q', and
88 then enable debug output)
89 --version print version number, then exit
91 --xargs [ -@ ] <arg> insert command line arguments taken from the
93 given file
94
97 command group 'automation'
98 Commands that aid in scripted execution.
99 automate ancestors REV1 [REV2 [REV3 [...]]]
101 Prints the ancestors of the given revisions.
102 automate ancestry_difference NEW_REV [OLD_REV1 [OLD_REV2 [...]]]
104 Lists the ancestors of the first revision given, not in the others.
105 automate branches
107 Prints all branch certs in the revision graph.
108 automate cert REVISION-ID NAME VALUE
110 Adds a revision certificate.
111 automate certs REV
113 Prints all certificates attached to a revision.
114 automate checkout [DIRECTORY]
116 Checks out a revision from the database into a directory. If a re‐
117 vision is given, that's the one that will be checked out. Other‐
118 wise, it will be the head of the branch (given or implicit). If no
119 directory is given, the branch name will be used as directory.
120 --branch [ -b ] <arg>
122 select branch cert for operation
123 --move-conflicting-paths / --no-move-conflicting-paths
125 move conflicting, unversioned paths into '_MTN/resolutions' be‐
126 fore proceeding with any workspace change
127 --revision [ -r ] <arg>
129 select revision id for operation
130 automate children REV
132 Prints the children of a revision.
133 automate common_ancestors REV1 [REV2 [REV3 [...]]]
135 Prints revisions that are common ancestors of a list of revisions.
136 automate content_diff [FILE [...]]
138 Calculates diffs of files.
139 --depth <arg>
141 limit the number of levels of directories to descend
142 --exclude <arg>
144 leave out anything described by its argument
145 --reverse
147 reverse order of diff
148 --revision [ -r ] <arg>
150 select revision id for operation
151 --with-header / --without-header
153 show the matching cset in the diff header
154 automate descendents REV1 [REV2 [REV3 [...]]]
156 Prints the descendents of the given revisions.
157 automate drop_attribute PATH [KEY]
159 Drops an attribute or all of them from a certain path.
160 automate drop_db_variables DOMAIN [NAME]
162 Drops a database variable.
163 automate drop_public_key KEY_NAME_OR_HASH
165 Drops a public key.
166 automate erase_ancestors [REV1 [REV2 [REV3 [...]]]]
168 Erases the ancestors in a list of revisions.
169 automate erase_descendants [REV1 [REV2 [REV3 [...]]]]
171 Erases the descendants in a list of revisions.
172 automate file_merge LEFT_REVID LEFT_FILENAME RIGHT_REVID RIGHT_FILE‐
174 NAME
175 Prints the results of the internal line merger, given two child re‐
176 visions and file names.
177 automate generate_key KEY_NAME PASSPHRASE
179 Generates an RSA key-pair.
180 --force-duplicate-key
182 force genkey to not error out when the named key already exists
183 automate get_attributes PATH
185 Prints all attributes for the specified path. If an explicit revi‐
186 sion is given, the file's attributes at this specific revision are
187 returned.
188 --revision [ -r ] <arg>
190 select revision id for operation
191 automate get_base_revision_id
193 Shows the revision on which the workspace is based.
194 automate get_content_changed REV FILE
196 Lists the revisions that changed the content relative to another
197 revision.
198 automate get_corresponding_path REV1 FILE REV2
200 Prints the name of a file in a target revision relative to a given
201 revision.
202 automate get_current_revision [PATHS ...]
204 Shows change information for a workspace.
205 --depth <arg>
207 limit the number of levels of directories to descend
208 --exclude <arg>
210 leave out anything described by its argument
211 automate get_current_revision_id
213 Shows the revision of the current workspace.
214 automate get_db_variables [DOMAIN]
216 Retrieve database variables.
217 automate get_extended_manifest_of REVISION
219 Prints the extended manifest for the given identifier.
220 automate get_file FILEID
222 Prints the contents of a file (given an identifier).
223 automate get_file_of FILENAME
225 Prints the contents of a file (given a name).
226 --revision [ -r ] <arg>
228 select revision id for operation
229 automate get_file_size FILEID
231 Prints the size of a file (given an identifier).
232 automate get_manifest_of [REVID]
234 Shows the manifest associated with a revision.
235 automate get_option OPTION
237 Shows the value of an option.
238 automate get_public_key KEY_NAME_OR_HASH
240 Prints a public key packet.
241 automate get_revision REVID
243 Shows change information for a revision.
244 automate get_workspace_root
246 Prints the workspace root for the current directory.
247 automate graph
249 Prints the complete ancestry graph.
250 automate heads [BRANCH]
252 Prints the heads of the given branch.
253 automate identify PATH
255 Prints the file identifier of a file.
256 automate interface_version
258 Prints the automation interface's version.
259 automate inventory [PATH]...
261 Prints a summary of files found in the workspace.
262 --depth <arg>
264 limit the number of levels of directories to descend
265 --exclude <arg>
267 leave out anything described by its argument
268 --no-corresponding-renames / --corresponding-renames
270 don't output corresponding renames if restricted on such nodes
271 --no-ignored / --ignored
273 don't output ignored files
274 --no-unchanged / --unchanged
276 don't output unchanged files
277 --no-unknown / --unknown
279 don't output unknown files
280 automate keys
282 Lists all keys in the keystore.
283 automate leaves
285 Lists the leaves of the revision graph.
286 automate log [PATH] ...
288 Lists the selected revision history.
289 --depth <arg>
291 limit the number of levels of directories to descend
292 --exclude <arg>
294 leave out anything described by its argument
295 --from <arg> / --clear-from
297 revision(s) to start logging at
298 --last <arg>
300 limit log output to the last number of entries
301 --next <arg>
303 limit log output to the next number of entries
304 --no-merges / --merges
306 exclude merges when printing logs
307 --to <arg> / --clear-to
309 revision(s) to stop logging at
310 automate lua LUA_FUNCTION [ARG1 [ARG2 [...]]]
312 Executes the given lua function and returns the result.
313 automate packet_for_fdata FILEID
315 Prints the file data in packet format.
316 automate packet_for_fdelta OLD_FILE NEW_FILE
318 Prints the file delta in packet format.
319 automate packet_for_rdata REVID
321 Prints the revision data in packet format.
322 automate packets_for_certs REVID
324 Prints the certs associated with a revision in packet format.
325 automate parents REV
327 Prints the parents of a revision.
328 automate pull [URI]
330 automate pull [ADDRESS[:PORTNUMBER] [PATTERN ...]]
331 Pulls branches from a netsync server.
332 --dry-run / --no-dry-run
334 don't perform the operation, just show what would have happened
335 --exclude <arg>
337 leave out anything described by its argument
338 --set-default / --no-set-default
340 use the current netsync arguments and options as the future de‐
341 fault
342 automate push [URI]
344 automate push [ADDRESS[:PORTNUMBER] [PATTERN ...]]
345 Pushes branches to a netsync server.
346 --dry-run / --no-dry-run
348 don't perform the operation, just show what would have happened
349 --exclude <arg>
351 leave out anything described by its argument
352 --key-to-push <arg>
354 push the specified key even if it hasn't signed anything
355 --set-default / --no-set-default
357 use the current netsync arguments and options as the future de‐
358 fault
359 automate put_file [FILEID] CONTENTS
361 Stores a file in the database.
362 automate put_public_key KEY-PACKET-DATA
364 Store the public key in the database.
365 automate put_revision REVISION-DATA
367 Stores a revision into the database.
368 automate read_packets PACKET-DATA
370 Load the given packets into the database.
371 automate remote COMMAND [ARGS]
373 Executes COMMAND on a remote server.
374 --remote-stdio-host <arg>
376 sets the host (and optionally the port) for a remote netsync
377 action
378 --set-default / --no-set-default
380 use the current netsync arguments and options as the future de‐
381 fault
382 automate remote_stdio [URI]
384 automate remote_stdio [ADDRESS[:PORTNUMBER]]
385 Opens an 'automate stdio' connection to a remote server.
386 --set-default / --no-set-default
388 use the current netsync arguments and options as the future de‐
389 fault
390 automate roots
392 Lists the roots of the revision graph.
393 automate select SELECTOR
395 Lists the revisions that match a selector.
396 automate set_attribute PATH KEY VALUE
398 Sets an attribute on a certain path.
399 automate set_db_variable DOMAIN NAME VALUE
401 Sets a database variable.
402 automate show_conflicts [LEFT_REVID RIGHT_REVID]
404 Shows the conflicts between two revisions. If no arguments are
405 given, LEFT_REVID and RIGHT_REVID default to the first two heads
406 that would be chosen by the 'merge' command.
407 --branch [ -b ] <arg>
409 select branch cert for operation
410 --ignore-suspend-certs / --no-ignore-suspend-certs
412 do not ignore revisions marked as suspended
413 automate stdio
415 Automates several commands in one run.
416 --automate-stdio-size <arg>
418 block size in bytes for 'automate stdio' output
419 automate sync [URI]
421 automate sync [ADDRESS[:PORTNUMBER] [PATTERN ...]]
422 Synchronizes branches with a netsync server.
423 --dry-run / --no-dry-run
425 don't perform the operation, just show what would have happened
426 --exclude <arg>
428 leave out anything described by its argument
429 --key-to-push <arg>
431 push the specified key even if it hasn't signed anything
432 --set-default / --no-set-default
434 use the current netsync arguments and options as the future de‐
435 fault
436 automate tags [BRANCH_PATTERN]
438 Prints all tags attached to a set of branches.
439 automate toposort [REV1 [REV2 [REV3 [...]]]]
441 Topologically sorts a list of revisions.
442 automate update
444 Updates the workspace.
445 --branch [ -b ] <arg>
447 select branch cert for operation
448 --move-conflicting-paths / --no-move-conflicting-paths
450 move conflicting, unversioned paths into '_MTN/resolutions' be‐
451 fore proceeding with any workspace change
452 --revision [ -r ] <arg>
454 select revision id for operation
455 command group 'database'
457 Commands that manipulate the database.
458 db changesetify
460 Converts the database to the changeset format.
461 db check
463 Does some sanity checks on the database. Ensures that the database
464 is consistent by issuing multiple checks.
465 db dump
467 Dumps the contents of the database. Generates a list of SQL in‐
468 structions that represent the whole contents of the database. The
469 resulting output is useful to later restore the database from a
470 text file that serves as a backup.
471 db execute
473 Executes an SQL command on the database. Directly executes the
474 given SQL command on the database
475 db fix_certs
477 Attempt to fix bad certs. Older monotone versions could sometimes
478 associate certs with the wrong key. This fixes such certs if you
479 have the correct key, and can optionally drop any certs that you
480 don't have the correct key for. This should only be needed if you
481 had such certs in your db when upgrading from 0.44 or earlier, or
482 if you loaded such certs with 'mtn read'.
483 --drop-bad-certs
485 drop certs signed by keys we don't know about
486 db info
488 Shows information about the database.
489 --full / --concise
491 print detailed information
492 db init
494 Initializes a database. Creates a new database file and initial‐
495 izes it.
496 db load
498 Loads the contents of the database. Reads a list of SQL instruc‐
499 tions that regenerate the contents of the database. This is sup‐
500 posed to be used in conjunction with the output generated by the
501 'dump' command.
502 db migrate
504 Migrates the database to a newer schema. Updates the database's
505 internal schema to the most recent one. Needed to automatically
506 resolve incompatibilities that may be introduced in newer versions
507 of monotone.
508 db regenerate_caches
510 Regenerates the caches stored in the database.
511 db rosterify
513 Converts the database to the rosters format.
514 --drop-attr <arg>
516 when rosterifying, drop attrs entries with the given key
517 db set_epoch BRANCH EPOCH
519 Sets the branch's epoch.
520 db version
522 Shows the database's version.
523 local kill_certs SELECTOR CERTNAME [CERTVAL]
525 Deletes the specified certs from the local database. Deletes all
526 certs which are on the given revision(s) and have the given name
527 and if a value is specified then also the given value.
528 local kill_revision REVID
530 Kills a revision from the local database.
531 command group 'debug'
533 Commands that aid in program debugging.
534 asciik SELECTOR
536 Prints an ASCII representation of the revisions' graph.
537 fdiff SRCNAME DESTNAME SRCID DESTID
539 Differences 2 files and outputs the result.
540 --context
542 use context diff format
543 --diff-args <arg>
545 argument to pass external diff hook
546 --external
548 use external diff hook for generating diffs
549 --no-show-encloser / --show-encloser
551 do not show the function containing each block of changes
552 --reverse
554 reverse order of diff
555 --unified
557 use unified diff format
558 --with-header / --without-header
560 show the matching cset in the diff header
561 fload
563 Loads a file's contents into the database.
564 fmerge PARENT_FILEID LEFT_FILEID RIGHT_FILEID
566 Merges 3 files and outputs the result.
567 get_roster [REVID]
569 Dumps the roster associated with a given identifier. If no REVID
570 is given, the workspace is used.
571 identify [PATH]
573 Calculates the identity of a file or stdin. If any PATH is given,
574 calculates their identity; otherwise, the one from the standard in‐
575 put is calculated.
576 rcs_import RCSFILE...
578 Parses versions in RCS files. This command doesn't reconstruct or
579 import revisions. You probably want to use cvs_import.
580 --branch [ -b ] <arg>
582 select branch cert for operation
583 command group 'informative'
585 Commands for information retrieval.
586 annotate PATH
588 Prints an annotated copy of a file. Calculates and prints an anno‐
589 tated copy of the given file from the specified REVISION.
590 --revision [ -r ] <arg>
592 select revision id for operation
593 --revs-only
595 annotate using full revision ids only
596 bisect bad
598 Marks the current revision or specified revisions as bad. Known
599 bad revisions are removed from the set being searched.
600 --move-conflicting-paths / --no-move-conflicting-paths
602 move conflicting, unversioned paths into '_MTN/resolutions' be‐
603 fore proceeding with any workspace change
604 --revision [ -r ] <arg>
606 select revision id for operation
607 bisect good
609 Marks the current revision or specified revisions as good. Known
610 good revisions are removed from the set being searched.
611 --move-conflicting-paths / --no-move-conflicting-paths
613 move conflicting, unversioned paths into '_MTN/resolutions' be‐
614 fore proceeding with any workspace change
615 --revision [ -r ] <arg>
617 select revision id for operation
618 bisect reset
620 Reset the current bisection search. Update the workspace back to
621 the revision from which the bisection was started and remove all
622 current search information, allowing a new search to be started.
623 bisect skip
625 Excludes the current revision or specified revisions from the
626 search. Skipped revisions are removed from the set being searched.
627 Revisions that cannot be tested for some reason should be skipped.
628 --move-conflicting-paths / --no-move-conflicting-paths
630 move conflicting, unversioned paths into '_MTN/resolutions' be‐
631 fore proceeding with any workspace change
632 --revision [ -r ] <arg>
634 select revision id for operation
635 bisect status
637 Reports on the current status of the bisection search. Lists the
638 total number of revisions in the search set, the number of revi‐
639 sions that have been determined to be good or bad, the number of
640 revisions that have been skipped and the number of revisions re‐
641 maining to be tested.
642 bisect update
644 Updates the workspace to the next revision to be tested by bisec‐
645 tion. This command can be used if updates by good, bad or skip
646 commands fail due to blocked paths or other problems.
647 --move-conflicting-paths / --no-move-conflicting-paths
649 move conflicting, unversioned paths into '_MTN/resolutions' be‐
650 fore proceeding with any workspace change
651 cat FILENAME
653 Prints a file from the database. Fetches the given file FILENAME
654 from the database and prints it to the standard output.
655 --revision [ -r ] <arg>
657 select revision id for operation
658 complete (revision|file|key) PARTIAL-ID
660 Completes a partial identifier.
661 di [PATH]...
663 diff [PATH]...
664 Shows current differences. Compares the current tree with the
665 files in the repository and prints the differences on the standard
666 output. If one revision is given, the diff between the workspace
667 and that revision is shown. If two revisions are given, the diff
668 between them is given. If no format is specified, unified is used
669 by default.
670 --context
672 use context diff format
673 --depth <arg>
675 limit the number of levels of directories to descend
676 --diff-args <arg>
678 argument to pass external diff hook
679 --exclude <arg>
681 leave out anything described by its argument
682 --external
684 use external diff hook for generating diffs
685 --no-show-encloser / --show-encloser
687 do not show the function containing each block of changes
688 --reverse
690 reverse order of diff
691 --revision [ -r ] <arg>
693 select revision id for operation
694 --unified
696 use unified diff format
697 --with-header / --without-header
699 show the matching cset in the diff header
700 help command [ARGS...]
702 Displays help about commands and options.
703 --hidden / --no-hidden
705 show hidden commands and options
706 list branches [PATTERN]
708 Lists branches in the database that match a pattern.
709 --exclude <arg>
711 leave out anything described by its argument
712 list certs REVID
714 Lists certificates attached to a revision.
715 list changed [PATH...]
717 Lists files that have changed with respect to the current revision.
718 --depth <arg>
720 limit the number of levels of directories to descend
721 --exclude <arg>
723 leave out anything described by its argument
724 list databases
726 list dbs
727 Lists managed databases and their known workspaces.
728 list duplicates
730 Lists duplicate files in the specified revision. If no revision is
731 specified, use the workspace.
732 --revision [ -r ] <arg>
734 select revision id for operation
735 list epochs [BRANCH [...]]
737 Lists the current epoch of branches that match a pattern.
738 list ignored [PATH]
740 Lists workspace files that are ignored in the current branch.
741 --depth <arg>
743 limit the number of levels of directories to descend
744 --exclude <arg>
746 leave out anything described by its argument
747 --recursive [ -R ] / --no-recursive
749 also operate on the contents of any listed directories
750 list keys [PATTERN]
752 Lists keys that match a pattern.
753 list known
755 Lists workspace files that belong to the current branch.
756 --depth <arg>
758 limit the number of levels of directories to descend
759 --exclude <arg>
761 leave out anything described by its argument
762 list missing
764 Lists files that belong to the branch but are not in the workspace.
765 --depth <arg>
767 limit the number of levels of directories to descend
768 --exclude <arg>
770 leave out anything described by its argument
771 list tags [PATTERN]
773 Lists all tags in the database.
774 --exclude <arg>
776 leave out anything described by its argument
777 list unknown [PATH]
779 Lists workspace files that are unknown in the current branch.
780 --depth <arg>
782 limit the number of levels of directories to descend
783 --exclude <arg>
785 leave out anything described by its argument
786 --recursive [ -R ] / --no-recursive
788 also operate on the contents of any listed directories
789 list vars [DOMAIN]
791 Lists variables in the whole database or a domain.
792 list workspaces
794 Lists known workspaces of a specified database.
795 log [PATH] ...
797 Prints selected history in forward or reverse order. This command
798 prints selected history in forward or reverse order, filtering it
799 by PATH if given.
800 --brief / --no-brief
802 print a brief version of the normal output
803 --depth <arg>
805 limit the number of levels of directories to descend
806 --diffs / --no-diffs
808 print diffs along with logs
809 --exclude <arg>
811 leave out anything described by its argument
812 --from <arg> / --clear-from
814 revision(s) to start logging at
815 --last <arg>
817 limit log output to the last number of entries
818 --next <arg>
820 limit log output to the next number of entries
821 --no-files / --files
823 exclude files when printing logs
824 --no-graph / --graph
826 do not use ASCII graph to display ancestry
827 --no-merges / --merges
829 exclude merges when printing logs
830 --revision [ -r ] <arg>
832 select revision id for operation
833 --to <arg> / --clear-to
835 revision(s) to stop logging at
836 manpage
838 Generate a manual page from monotone's command help.
839 --formatted / --plain
841 automatically run the output through nroff (default if the out‐
842 put is a terminal)
843 --hidden / --no-hidden
845 show hidden commands and options
846 show_conflicts REV REV
848 Shows what conflicts need resolution between two revisions. The
849 conflicts are calculated based on the two revisions given in the
850 REV parameters.
851 status [PATH]...
853 Shows workspace's status information.
854 --depth <arg>
856 limit the number of levels of directories to descend
857 --exclude <arg>
859 leave out anything described by its argument
860 version
862 Shows the program version.
863 --full / --concise
865 print detailed information
866 command group 'key_and_cert'
868 Commands to manage keys and certificates.
869 cert SELECTOR CERTNAME [CERTVAL]
871 Creates a certificate for a revision or set of revisions. Creates
872 a certificate with the given name and value on each revision that
873 matches the given selector
874 dropkey KEY_NAME_OR_HASH
876 Drops a public and/or private key.
877 genkey KEY_NAME
879 Generates an RSA key-pair.
880 --force-duplicate-key
882 force genkey to not error out when the named key already exists
883 passphrase KEY_NAME_OR_HASH
885 Changes the passphrase of a private RSA key.
886 ssh_agent_add
888 Adds a private key to ssh-agent.
889 ssh_agent_export [FILENAME]
891 Exports a private key for use with ssh-agent.
892 trusted REVISION NAME VALUE SIGNER1 [SIGNER2 [...]]
894 Tests whether a hypothetical certificate would be trusted. The
895 current settings are used to run the test.
896 command group 'network'
898 Commands that access the network.
899 clone URI [DIRECTORY]
901 clone HOST[:PORTNUMBER] BRANCH [DIRECTORY]
902 Checks out a revision from a remote database into a directory. If
903 a revision is given, that's the one that will be checked out. Oth‐
904 erwise, it will be the head of the branch supplied. If no direc‐
905 tory is given, the branch name will be used as directory
906 --branch [ -b ] <arg>
908 select branch cert for operation
909 --revision [ -r ] <arg>
911 select revision id for operation
912 pull [URI]
914 pull [ADDRESS[:PORTNUMBER] [PATTERN ...]]
915 Pulls branches from a netsync server. This pulls all branches that
916 match the pattern given in PATTERN from the netsync server at the
917 address ADDRESS.
918 --dry-run / --no-dry-run
920 don't perform the operation, just show what would have happened
921 --exclude <arg>
923 leave out anything described by its argument
924 --set-default / --no-set-default
926 use the current netsync arguments and options as the future de‐
927 fault
928 --update / --no-update
930 automatically update the workspace, if it was at a head and the
931 command creates a new head
932 push [URI]
934 push [ADDRESS[:PORTNUMBER] [PATTERN ...]]
935 Pushes branches to a netsync server. This will push all branches
936 that match the pattern given in PATTERN to the netsync server at
937 the address ADDRESS.
938 --dry-run / --no-dry-run
940 don't perform the operation, just show what would have happened
941 --exclude <arg>
943 leave out anything described by its argument
944 --key-to-push <arg>
946 push the specified key even if it hasn't signed anything
947 --set-default / --no-set-default
949 use the current netsync arguments and options as the future de‐
950 fault
951 serve
953 Serves the database to connecting clients.
954 --bind <arg>
956 address:port to listen on (default :4691)
957 --pid-file <arg> / --no-pid-file
959 record process id of server
960 sync [URI]
962 sync [ADDRESS[:PORTNUMBER] [PATTERN ...]]
963 Synchronizes branches with a netsync server. This synchronizes
964 branches that match the pattern given in PATTERN with the netsync
965 server at the address ADDRESS.
966 --dry-run / --no-dry-run
968 don't perform the operation, just show what would have happened
969 --exclude <arg>
971 leave out anything described by its argument
972 --key-to-push <arg>
974 push the specified key even if it hasn't signed anything
975 --set-default / --no-set-default
977 use the current netsync arguments and options as the future de‐
978 fault
979 --update / --no-update
981 automatically update the workspace, if it was at a head and the
982 command creates a new head
983 command group 'packet_io'
985 Commands for packet reading and writing.
986 privkey KEY_NAME_OR_HASH
988 Prints a private key packet.
989 pubkey KEY_NAME_OR_HASH
991 Prints a public key packet.
992 read [FILE1 [FILE2 [...]]]
994 Reads packets from files. If no files are provided, the standard
995 input is used.
996 command group 'review'
998 Commands to review revisions.
999 approve REVISION
1001 Approves a particular revision.
1002 --branch [ -b ] <arg>
1004 select branch cert for operation
1005 --update / --no-update
1007 automatically update the workspace, if it was at a head and the
1008 command creates a new head
1009 comment REVISION [COMMENT]
1011 Comments on a particular revision.
1012 disapprove [PARENT-REVISION] CHILD-REVISION
1014 Disapproves a particular revision or revision range.
1015 --author <arg>
1017 override author for commit
1018 --branch [ -b ] <arg>
1020 select branch cert for operation
1021 --date <arg>
1023 override date/time for commit
1024 --message [ -m ] <arg>
1026 set commit changelog message
1027 --message-file <arg>
1029 set filename containing commit changelog message
1030 --update / --no-update
1032 automatically update the workspace, if it was at a head and the
1033 command creates a new head
1034 suspend REVISION
1036 Suspends a particular revision.
1037 --branch [ -b ] <arg>
1039 select branch cert for operation
1040 --update / --no-update
1042 automatically update the workspace, if it was at a head and the
1043 command creates a new head
1044 tag REVISION TAGNAME
1046 Puts a symbolic tag certificate on a revision.
1047 testresult REV (pass|fail|true|false|yes|no|1|0)
1049 Notes the results of running a test on a revision.
1050 command group 'tree'
1052 Commands to manipulate the tree.
1053 checkout [DIRECTORY]
1055 co [DIRECTORY]
1056 Checks out a revision from the database into a directory. If a re‐
1057 vision is given, that's the one that will be checked out. Other‐
1058 wise, it will be the head of the branch (given or implicit). If no
1059 directory is given, the branch name will be used as directory.
1060 --branch [ -b ] <arg>
1062 select branch cert for operation
1063 --move-conflicting-paths / --no-move-conflicting-paths
1065 move conflicting, unversioned paths into '_MTN/resolutions' be‐
1066 fore proceeding with any workspace change
1067 --revision [ -r ] <arg>
1069 select revision id for operation
1070 conflicts clean
1072 Delete any bookkeeping files related to conflict resolution.
1073 conflicts resolve_first RESOLUTION
1075 Set the resolution for the first unresolved single-file conflict..
1076 Use 'mtn conflicts show_first' to see possible resolutions.
1077 --conflicts-file <arg>
1079 file in which to store conflicts
1080 conflicts resolve_first_left RESOLUTION
1082 Set the left resolution for the first unresolved two-file conflict.
1083 --conflicts-file <arg>
1085 file in which to store conflicts
1086 conflicts resolve_first_right RESOLUTION
1088 Set the right resolution for the first unresolved two-file con‐
1089 flict.
1090 --conflicts-file <arg>
1092 file in which to store conflicts
1093 conflicts show_first
1095 Show the first unresolved conflict in the conflicts file, and pos‐
1096 sible resolutions.
1097 --conflicts-file <arg>
1099 file in which to store conflicts
1100 conflicts show_remaining
1102 Show the remaining unresolved conflicts in the conflicts file.
1103 --conflicts-file <arg>
1105 file in which to store conflicts
1106 conflicts store [LEFT_REVID RIGHT_REVID]
1108 Store the conflicts from merging two revisions. If no arguments
1109 are given, LEFT_REVID and RIGHT_REVID default to the first two
1110 heads that would be chosen by the 'merge' command. If '--con‐
1111 flicts-file' is not given, '_MTN/conflicts' is used.
1112 --branch [ -b ] <arg>
1114 select branch cert for operation
1115 --conflicts-file <arg>
1117 file in which to store conflicts
1118 explicit_merge LEFT-REVISION RIGHT-REVISION DEST-BRANCH
1120 Merges two explicitly given revisions. The results of the merge
1121 are placed on the branch specified by DEST-BRANCH.
1122 --author <arg>
1124 override author for commit
1125 --date <arg>
1127 override date/time for commit
1128 --message [ -m ] <arg>
1130 set commit changelog message
1131 --message-file <arg>
1133 set filename containing commit changelog message
1134 --resolve-conflicts / --no-resolve-conflicts
1136 specify conflict resolutions in a file, instead of interac‐
1137 tively
1138 --resolve-conflicts-file <arg>
1140 use file to resolve conflicts
1141 --update / --no-update
1143 automatically update the workspace, if it was at a head and the
1144 command creates a new head
1145 heads
1147 Shows unmerged head revisions of a branch.
1148 --branch [ -b ] <arg>
1150 select branch cert for operation
1151 import DIRECTORY
1153 Imports the contents of a directory into a branch.
1154 --author <arg>
1156 override author for commit
1157 --branch [ -b ] <arg>
1159 select branch cert for operation
1160 --date <arg>
1162 override date/time for commit
1163 --dry-run / --no-dry-run
1165 don't perform the operation, just show what would have happened
1166 --exclude <arg>
1168 leave out anything described by its argument
1169 --message [ -m ] <arg>
1171 set commit changelog message
1172 --message-file <arg>
1174 set filename containing commit changelog message
1175 --no-respect-ignore / --respect-ignore
1177 do not ignore any files
1178 --revision [ -r ] <arg>
1180 select revision id for operation
1181 merge
1183 Merges unmerged heads of a branch.
1184 --author <arg>
1186 override author for commit
1187 --branch [ -b ] <arg>
1189 select branch cert for operation
1190 --date <arg>
1192 override date/time for commit
1193 --message [ -m ] <arg>
1195 set commit changelog message
1196 --message-file <arg>
1198 set filename containing commit changelog message
1199 --resolve-conflicts / --no-resolve-conflicts
1201 specify conflict resolutions in a file, instead of interac‐
1202 tively
1203 --resolve-conflicts-file <arg>
1205 use file to resolve conflicts
1206 --update / --no-update
1208 automatically update the workspace, if it was at a head and the
1209 command creates a new head
1210 merge_into_dir SOURCE-BRANCH DEST-BRANCH DIR
1212 Merges one branch into a subdirectory in another branch.
1213 --author <arg>
1215 override author for commit
1216 --date <arg>
1218 override date/time for commit
1219 --message [ -m ] <arg>
1221 set commit changelog message
1222 --message-file <arg>
1224 set filename containing commit changelog message
1225 --resolve-conflicts / --no-resolve-conflicts
1227 specify conflict resolutions in a file, instead of interac‐
1228 tively
1229 --resolve-conflicts-file <arg>
1231 use file to resolve conflicts
1232 --update / --no-update
1234 automatically update the workspace, if it was at a head and the
1235 command creates a new head
1236 merge_into_workspace OTHER-REVISION
1238 Merges a revision into the current workspace's base revision.
1239 Merges OTHER-REVISION into the current workspace's base revision,
1240 and update the current workspace with the result. There can be no
1241 pending changes in the current workspace. Both OTHER-REVISION and
1242 the workspace's base revision will be recorded as parents on com‐
1243 mit. The workspace's selected branch is not changed.
1244 --move-conflicting-paths / --no-move-conflicting-paths
1246 move conflicting, unversioned paths into '_MTN/resolutions' be‐
1247 fore proceeding with any workspace change
1248 migrate_workspace [DIRECTORY]
1250 Migrates a workspace directory's metadata to the latest format. If
1251 no directory is given, defaults to the current workspace.
1252 propagate SOURCE-BRANCH DEST-BRANCH
1254 Merges from one branch to another asymmetrically.
1255 --author <arg>
1257 override author for commit
1258 --date <arg>
1260 override date/time for commit
1261 --message [ -m ] <arg>
1263 set commit changelog message
1264 --message-file <arg>
1266 set filename containing commit changelog message
1267 --resolve-conflicts / --no-resolve-conflicts
1269 specify conflict resolutions in a file, instead of interac‐
1270 tively
1271 --resolve-conflicts-file <arg>
1273 use file to resolve conflicts
1274 refresh_inodeprints
1276 Refreshes the inodeprint cache.
1277 setup [DIRECTORY]
1279 Sets up a new workspace directory. If no directory is specified,
1280 uses the current directory.
1281 --branch [ -b ] <arg>
1283 select branch cert for operation
1284 command group 'variables'
1286 Commands to manage persistent variables.
1287 cleanup_workspace_list
1289 Removes all invalid, registered workspace paths for the current
1290 database.
1291 register_workspace [WORKSPACE_PATH]
1293 Registers a new workspace for the current database. This command
1294 adds WORKSPACE_PATH to the list of `known-workspaces'.
1295 set DOMAIN NAME VALUE
1297 Sets a database variable. This command modifies (or adds if it did
1298 not exist before) the variable named NAME, stored in the database,
1299 and sets it to the given value in VALUE. The variable is placed in
1300 the domain DOMAIN.
1301 unregister_workspace [WORKSPACE_PATH]
1303 Unregisters an existing workspace for the current database. This
1304 command removes WORKSPACE_PATH to the list of `known-workspaces'.
1305 unset DOMAIN NAME
1307 Unsets a database variable. This command removes the variable NAME
1308 from domain DOMAIN, which was previously stored in the database.
1309 command group 'vcs'
1311 Commands for interaction with other version control systems.
1312 cvs_import CVSROOT
1314 Imports all versions in a CVS repository.
1315 --branch [ -b ] <arg>
1317 select branch cert for operation
1318 git_export
1320 Produces a git fast-export data stream on stdout.
1321 --authors-file <arg>
1323 file mapping author names from original to new values
1324 --branches-file <arg>
1326 file mapping branch names from original to new values
1327 --export-marks <arg>
1329 save the internal marks table after exporting revisions
1330 --import-marks <arg>
1332 load the internal marks table before exporting revisions
1333 --log-certs / --no-log-certs
1335 include standard cert values in commit logs
1336 --log-revids / --no-log-revids
1338 include revision ids in commit logs
1339 --refs <arg>
1341 include git refs for 'revs', 'roots' or 'leaves'
1342 --use-one-changelog
1344 use only one changelog cert for the git commit message
1345 command group 'workspace'
1347 Commands that deal with the workspace.
1348 add [PATH]...
1350 Adds files to the workspace.
1351 --no-respect-ignore / --respect-ignore
1353 do not ignore any files
1354 --recursive [ -R ] / --no-recursive
1356 also operate on the contents of any listed directories
1357 --unknown / --no-unknown
1359 perform the operations for unknown files from workspace
1360 attr drop PATH [ATTR]
1362 Removes attributes from a file. If no attribute is specified, this
1363 command removes all attributes attached to the file given in PATH.
1364 Otherwise only removes the attribute specified in ATTR.
1365 attr get PATH [ATTR]
1367 Gets the values of a file's attributes. If no attribute is speci‐
1368 fied, this command prints all attributes attached to the file given
1369 in PATH. Otherwise it only prints the attribute specified in ATTR.
1370 attr set PATH ATTR VALUE
1372 Sets an attribute on a file. Sets the attribute given on ATTR to
1373 the value specified in VALUE for the file mentioned in PATH.
1374 ci [PATH]...
1376 commit [PATH]...
1377 Commits workspace changes to the database.
1378 --author <arg>
1380 override author for commit
1381 --branch [ -b ] <arg>
1383 select branch cert for operation
1384 --date <arg>
1386 override date/time for commit
1387 --depth <arg>
1389 limit the number of levels of directories to descend
1390 --exclude <arg>
1392 leave out anything described by its argument
1393 --message [ -m ] <arg>
1395 set commit changelog message
1396 --message-file <arg>
1398 set filename containing commit changelog message
1399 drop [PATH]...
1401 rm [PATH]...
1402 Drops files from the workspace.
1403 --bookkeep-only
1405 only update monotone's internal bookkeeping, not the filesystem
1406 --missing
1408 perform the operations for files missing from workspace
1409 --recursive [ -R ] / --no-recursive
1411 also operate on the contents of any listed directories
1412 mkdir [DIRECTORY...]
1414 Creates directories and adds them to the workspace.
1415 --no-respect-ignore / --respect-ignore
1417 do not ignore any files
1418 pivot_root NEW_ROOT PUT_OLD
1420 Renames the root directory. After this command, the directory that
1421 currently has the name NEW_ROOT will be the root directory, and the
1422 directory that is currently the root directory will have name
1423 PUT_OLD. Use of '--bookkeep-only' is NOT recommended.
1424 --bookkeep-only
1426 only update monotone's internal bookkeeping, not the filesystem
1427 --move-conflicting-paths / --no-move-conflicting-paths
1429 move conflicting, unversioned paths into '_MTN/resolutions' be‐
1430 fore proceeding with any workspace change
1431 pluck [PATH...]
1433 Applies changes made at arbitrary places in history. This command
1434 takes changes made at any point in history, and edits your current
1435 workspace to include those changes. The end result is identical to
1436 'mtn diff -r FROM -r TO | patch -p0', except that this command uses
1437 monotone's merger, and thus intelligently handles renames, con‐
1438 flicts, and so on. If one revision is given, applies the changes
1439 made in that revision compared to its parent. If two revisions are
1440 given, applies the changes made to get from the first revision to
1441 the second.
1442 --depth <arg>
1444 limit the number of levels of directories to descend
1445 --exclude <arg>
1447 leave out anything described by its argument
1448 --move-conflicting-paths / --no-move-conflicting-paths
1450 move conflicting, unversioned paths into '_MTN/resolutions' be‐
1451 fore proceeding with any workspace change
1452 --revision [ -r ] <arg>
1454 select revision id for operation
1455 mv SRC DEST
1457 mv SRC1 [SRC2 [...]] DEST_DIR
1458 rename SRC DEST
1459 rename SRC1 [SRC2 [...]] DEST_DIR
1460 Renames entries in the workspace.
1461 --bookkeep-only
1463 only update monotone's internal bookkeeping, not the filesystem
1464 revert [PATH]...
1466 Reverts files and/or directories. In order to revert the entire
1467 workspace, specify '.' as the file name.
1468 --depth <arg>
1470 limit the number of levels of directories to descend
1471 --exclude <arg>
1473 leave out anything described by its argument
1474 --missing
1476 perform the operations for files missing from workspace
1477 undrop PATH...
1479 Reverses a mistaken 'drop'. If the file was deleted from the
1480 workspace, this is the same as 'revert'. Otherwise, it just removes
1481 the 'drop' from the manifest.
1482 update
1484 Updates the workspace. This command modifies your workspace to be
1485 based off of a different revision, preserving uncommitted changes
1486 as it does so. If a revision is given, update the workspace to
1487 that revision. If not, update the workspace to the head of the
1488 branch.
1489 --branch [ -b ] <arg>
1491 select branch cert for operation
1492 --move-conflicting-paths / --no-move-conflicting-paths
1494 move conflicting, unversioned paths into '_MTN/resolutions' be‐
1495 fore proceeding with any workspace change
1496 --revision [ -r ] <arg>
1498 select revision id for operation
1499
1501 info mtn and the documentation on http://www.monotone.ca/docs
1502
1504 Please report bugs to https://code.monotone.ca/p/monotone/issues/.
1505
1507 monotone was written originally by Graydon Hoare <graydon@pobox.com> in
1508 2003 and has since then received numerous contributions from many indi‐
1509 viduals. A complete list of authors can be found in AUTHORS.
1510 Nowadays, monotone is maintained by a collective of enthusiastic pro‐
1512 grammers, known as the monotone development team.
1513
1515 monotone and this man page is Copyright (c) 2003 - 2022 by the monotone
1516 development team.
1517monotone 1.1 2022-07-21 monotone(1)