1monotone(1)                 General Commands Manual                monotone(1)
2
3
4

NAME

6       monotone - a distributed version control system
7

SYNOPSIS

9       mtn [options...] command [arguments...]
10

DESCRIPTION

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
18       For more information on monotone, visit http://www.monotone.ca.
19
20       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

GLOBAL OPTIONS

24       --confdir <arg>          set location of configuration directory
25
26       --date-format <arg>      strftime(3) format specification for  printing
27                                dates
28
29       --db [ -d ] <arg>        set name of database
30
31       --dump <arg>             file to dump debugging log to, on failure
32
33       --help [ -h ]            display help message
34
35       --ignore-suspend-certs / --no-ignore-suspend-certs
36                                do not ignore revisions marked as suspended
37
38       --key [ -k ] <arg> / --use-default-key
39                                sets  the key for signatures, using either the
40                                key name or the key hash
41
42       --keydir <arg>           set location of key store
43
44       --log <arg>              file to write the log to
45
46       --no-builtin-rcfile / --builtin-rcfile
47                                do not load the built-in lua file with the de‐
48                                fault hooks
49
50       --no-default-confdir / --allow-default-confdir
51                                forbid use of the default confdir
52
53       --no-format-dates        print  date  certs  exactly  as  stored in the
54                                database
55
56       --no-standard-rcfiles / --standard-rcfiles
57                                do  not   load   '~/.monotone/monotonerc'   or
58                                '_MTN/monotonerc' lua files
59
60       --no-workspace / --allow-workspace
61                                don't look for a workspace
62
63       --non-interactive / --interactive
64                                do not prompt the user for input
65
66       --quiet [ -q ]           decrease  verbosity  (undo previous '-v', then
67                                disable  informational  output,  then  disable
68                                warnings)
69
70       --rcfile <arg> / --clear-rcfiles
71                                load extra lua file
72
73       --root <arg>             limit search for workspace to specified root
74
75       --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
82       --ticker <arg>           set ticker style (count|dot|none)
83
84       --timestamps             show timestamps in front of  errors,  warnings
85                                and progress messages
86
87       --verbose [ -v ]         increase  verbosity  (undo  previous '-q', and
88                                then enable debug output)
89
90       --version                print version number, then exit
91
92       --xargs [ -@ ] <arg>     insert command line arguments taken  from  the
93                                given file
94
95

COMMANDS

97   command group 'automation'
98       Commands that aid in scripted execution.
99
100       automate ancestors  REV1 [REV2 [REV3 [...]]]
101           Prints the ancestors of the given revisions.
102
103       automate ancestry_difference  NEW_REV [OLD_REV1 [OLD_REV2 [...]]]
104           Lists the ancestors of the first revision given, not in the others.
105
106       automate branches
107           Prints all branch certs in the revision graph.
108
109       automate cert  REVISION-ID NAME VALUE
110           Adds a revision certificate.
111
112       automate certs  REV
113           Prints all certificates attached to a revision.
114
115       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
121           --branch [ -b ] <arg>
122               select branch cert for operation
123
124           --move-conflicting-paths / --no-move-conflicting-paths
125               move conflicting, unversioned paths into '_MTN/resolutions' be‐
126               fore proceeding with any workspace change
127
128           --revision [ -r ] <arg>
129               select revision id for operation
130
131       automate children  REV
132           Prints the children of a revision.
133
134       automate common_ancestors  REV1 [REV2 [REV3 [...]]]
135           Prints revisions that are common ancestors of a list of revisions.
136
137       automate content_diff  [FILE [...]]
138           Calculates diffs of files.
139
140           --depth <arg>
141               limit the number of levels of directories to descend
142
143           --exclude <arg>
144               leave out anything described by its argument
145
146           --reverse
147               reverse order of diff
148
149           --revision [ -r ] <arg>
150               select revision id for operation
151
152           --with-header / --without-header
153               show the matching cset in the diff header
154
155       automate descendents  REV1 [REV2 [REV3 [...]]]
156           Prints the descendents of the given revisions.
157
158       automate drop_attribute  PATH [KEY]
159           Drops an attribute or all of them from a certain path.
160
161       automate drop_db_variables  DOMAIN [NAME]
162           Drops a database variable.
163
164       automate drop_public_key  KEY_NAME_OR_HASH
165           Drops a public key.
166
167       automate erase_ancestors  [REV1 [REV2 [REV3 [...]]]]
168           Erases the ancestors in a list of revisions.
169
170       automate erase_descendants  [REV1 [REV2 [REV3 [...]]]]
171           Erases the descendants in a list of revisions.
172
173       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
178       automate generate_key  KEY_NAME PASSPHRASE
179           Generates an RSA key-pair.
180
181           --force-duplicate-key
182               force genkey to not error out when the named key already exists
183
184       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
189           --revision [ -r ] <arg>
190               select revision id for operation
191
192       automate get_base_revision_id
193           Shows the revision on which the workspace is based.
194
195       automate get_content_changed  REV FILE
196           Lists  the  revisions  that changed the content relative to another
197           revision.
198
199       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
203       automate get_current_revision  [PATHS ...]
204           Shows change information for a workspace.
205
206           --depth <arg>
207               limit the number of levels of directories to descend
208
209           --exclude <arg>
210               leave out anything described by its argument
211
212       automate get_current_revision_id
213           Shows the revision of the current workspace.
214
215       automate get_db_variables  [DOMAIN]
216           Retrieve database variables.
217
218       automate get_extended_manifest_of  REVISION
219           Prints the extended manifest for the given identifier.
220
221       automate get_file  FILEID
222           Prints the contents of a file (given an identifier).
223
224       automate get_file_of  FILENAME
225           Prints the contents of a file (given a name).
226
227           --revision [ -r ] <arg>
228               select revision id for operation
229
230       automate get_file_size  FILEID
231           Prints the size of a file (given an identifier).
232
233       automate get_manifest_of  [REVID]
234           Shows the manifest associated with a revision.
235
236       automate get_option  OPTION
237           Shows the value of an option.
238
239       automate get_public_key  KEY_NAME_OR_HASH
240           Prints a public key packet.
241
242       automate get_revision  REVID
243           Shows change information for a revision.
244
245       automate get_workspace_root
246           Prints the workspace root for the current directory.
247
248       automate graph
249           Prints the complete ancestry graph.
250
251       automate heads  [BRANCH]
252           Prints the heads of the given branch.
253
254       automate identify  PATH
255           Prints the file identifier of a file.
256
257       automate interface_version
258           Prints the automation interface's version.
259
260       automate inventory  [PATH]...
261           Prints a summary of files found in the workspace.
262
263           --depth <arg>
264               limit the number of levels of directories to descend
265
266           --exclude <arg>
267               leave out anything described by its argument
268
269           --no-corresponding-renames / --corresponding-renames
270               don't output corresponding renames if restricted on such nodes
271
272           --no-ignored / --ignored
273               don't output ignored files
274
275           --no-unchanged / --unchanged
276               don't output unchanged files
277
278           --no-unknown / --unknown
279               don't output unknown files
280
281       automate keys
282           Lists all keys in the keystore.
283
284       automate leaves
285           Lists the leaves of the revision graph.
286
287       automate log  [PATH] ...
288           Lists the selected revision history.
289
290           --depth <arg>
291               limit the number of levels of directories to descend
292
293           --exclude <arg>
294               leave out anything described by its argument
295
296           --from <arg> / --clear-from
297               revision(s) to start logging at
298
299           --last <arg>
300               limit log output to the last number of entries
301
302           --next <arg>
303               limit log output to the next number of entries
304
305           --no-merges / --merges
306               exclude merges when printing logs
307
308           --to <arg> / --clear-to
309               revision(s) to stop logging at
310
311       automate lua  LUA_FUNCTION [ARG1 [ARG2 [...]]]
312           Executes the given lua function and returns the result.
313
314       automate packet_for_fdata  FILEID
315           Prints the file data in packet format.
316
317       automate packet_for_fdelta  OLD_FILE NEW_FILE
318           Prints the file delta in packet format.
319
320       automate packet_for_rdata  REVID
321           Prints the revision data in packet format.
322
323       automate packets_for_certs  REVID
324           Prints the certs associated with a revision in packet format.
325
326       automate parents  REV
327           Prints the parents of a revision.
328
329       automate pull  [URI]
330       automate pull  [ADDRESS[:PORTNUMBER] [PATTERN ...]]
331           Pulls branches from a netsync server.
332
333           --dry-run / --no-dry-run
334               don't perform the operation, just show what would have happened
335
336           --exclude <arg>
337               leave out anything described by its argument
338
339           --set-default / --no-set-default
340               use the current netsync arguments and options as the future de‐
341               fault
342
343       automate push  [URI]
344       automate push  [ADDRESS[:PORTNUMBER] [PATTERN ...]]
345           Pushes branches to a netsync server.
346
347           --dry-run / --no-dry-run
348               don't perform the operation, just show what would have happened
349
350           --exclude <arg>
351               leave out anything described by its argument
352
353           --key-to-push <arg>
354               push the specified key even if it hasn't signed anything
355
356           --set-default / --no-set-default
357               use the current netsync arguments and options as the future de‐
358               fault
359
360       automate put_file  [FILEID] CONTENTS
361           Stores a file in the database.
362
363       automate put_public_key  KEY-PACKET-DATA
364           Store the public key in the database.
365
366       automate put_revision  REVISION-DATA
367           Stores a revision into the database.
368
369       automate read_packets  PACKET-DATA
370           Load the given packets into the database.
371
372       automate remote  COMMAND [ARGS]
373           Executes COMMAND on a remote server.
374
375           --remote-stdio-host <arg>
376               sets  the  host  (and optionally the port) for a remote netsync
377               action
378
379           --set-default / --no-set-default
380               use the current netsync arguments and options as the future de‐
381               fault
382
383       automate remote_stdio  [URI]
384       automate remote_stdio  [ADDRESS[:PORTNUMBER]]
385           Opens an 'automate stdio' connection to a remote server.
386
387           --set-default / --no-set-default
388               use the current netsync arguments and options as the future de‐
389               fault
390
391       automate roots
392           Lists the roots of the revision graph.
393
394       automate select  SELECTOR
395           Lists the revisions that match a selector.
396
397       automate set_attribute  PATH KEY VALUE
398           Sets an attribute on a certain path.
399
400       automate set_db_variable  DOMAIN NAME VALUE
401           Sets a database variable.
402
403       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
408           --branch [ -b ] <arg>
409               select branch cert for operation
410
411           --ignore-suspend-certs / --no-ignore-suspend-certs
412               do not ignore revisions marked as suspended
413
414       automate stdio
415           Automates several commands in one run.
416
417           --automate-stdio-size <arg>
418               block size in bytes for 'automate stdio' output
419
420       automate sync  [URI]
421       automate sync  [ADDRESS[:PORTNUMBER] [PATTERN ...]]
422           Synchronizes branches with a netsync server.
423
424           --dry-run / --no-dry-run
425               don't perform the operation, just show what would have happened
426
427           --exclude <arg>
428               leave out anything described by its argument
429
430           --key-to-push <arg>
431               push the specified key even if it hasn't signed anything
432
433           --set-default / --no-set-default
434               use the current netsync arguments and options as the future de‐
435               fault
436
437       automate tags  [BRANCH_PATTERN]
438           Prints all tags attached to a set of branches.
439
440       automate toposort  [REV1 [REV2 [REV3 [...]]]]
441           Topologically sorts a list of revisions.
442
443       automate update
444           Updates the workspace.
445
446           --branch [ -b ] <arg>
447               select branch cert for operation
448
449           --move-conflicting-paths / --no-move-conflicting-paths
450               move conflicting, unversioned paths into '_MTN/resolutions' be‐
451               fore proceeding with any workspace change
452
453           --revision [ -r ] <arg>
454               select revision id for operation
455
456   command group 'database'
457       Commands that manipulate the database.
458
459       db changesetify
460           Converts the database to the changeset format.
461
462       db check
463           Does some sanity checks on the database.  Ensures that the database
464           is consistent by issuing multiple checks.
465
466       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
472       db execute
473           Executes an SQL command on the  database.   Directly  executes  the
474           given SQL command on the database
475
476       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
484           --drop-bad-certs
485               drop certs signed by keys we don't know about
486
487       db info
488           Shows information about the database.
489
490           --full / --concise
491               print detailed information
492
493       db init
494           Initializes a database.  Creates a new database file  and  initial‐
495           izes it.
496
497       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
503       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
509       db regenerate_caches
510           Regenerates the caches stored in the database.
511
512       db rosterify
513           Converts the database to the rosters format.
514
515           --drop-attr <arg>
516               when rosterifying, drop attrs entries with the given key
517
518       db set_epoch  BRANCH EPOCH
519           Sets the branch's epoch.
520
521       db version
522           Shows the database's version.
523
524       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
529       local kill_revision  REVID
530           Kills a revision from the local database.
531
532   command group 'debug'
533       Commands that aid in program debugging.
534
535       asciik  SELECTOR
536           Prints an ASCII representation of the revisions' graph.
537
538       fdiff  SRCNAME DESTNAME SRCID DESTID
539           Differences 2 files and outputs the result.
540
541           --context
542               use context diff format
543
544           --diff-args <arg>
545               argument to pass external diff hook
546
547           --external
548               use external diff hook for generating diffs
549
550           --no-show-encloser / --show-encloser
551               do not show the function containing each block of changes
552
553           --reverse
554               reverse order of diff
555
556           --unified
557               use unified diff format
558
559           --with-header / --without-header
560               show the matching cset in the diff header
561
562       fload
563           Loads a file's contents into the database.
564
565       fmerge  PARENT_FILEID LEFT_FILEID RIGHT_FILEID
566           Merges 3 files and outputs the result.
567
568       get_roster  [REVID]
569           Dumps  the  roster associated with a given identifier.  If no REVID
570           is given, the workspace is used.
571
572       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
577       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
581           --branch [ -b ] <arg>
582               select branch cert for operation
583
584   command group 'informative'
585       Commands for information retrieval.
586
587       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
591           --revision [ -r ] <arg>
592               select revision id for operation
593
594           --revs-only
595               annotate using full revision ids only
596
597       bisect bad
598           Marks the current revision or specified revisions  as  bad.   Known
599           bad revisions are removed from the set being searched.
600
601           --move-conflicting-paths / --no-move-conflicting-paths
602               move conflicting, unversioned paths into '_MTN/resolutions' be‐
603               fore proceeding with any workspace change
604
605           --revision [ -r ] <arg>
606               select revision id for operation
607
608       bisect good
609           Marks the current revision or specified revisions as  good.   Known
610           good revisions are removed from the set being searched.
611
612           --move-conflicting-paths / --no-move-conflicting-paths
613               move conflicting, unversioned paths into '_MTN/resolutions' be‐
614               fore proceeding with any workspace change
615
616           --revision [ -r ] <arg>
617               select revision id for operation
618
619       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
624       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
629           --move-conflicting-paths / --no-move-conflicting-paths
630               move conflicting, unversioned paths into '_MTN/resolutions' be‐
631               fore proceeding with any workspace change
632
633           --revision [ -r ] <arg>
634               select revision id for operation
635
636       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
643       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
648           --move-conflicting-paths / --no-move-conflicting-paths
649               move conflicting, unversioned paths into '_MTN/resolutions' be‐
650               fore proceeding with any workspace change
651
652       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
656           --revision [ -r ] <arg>
657               select revision id for operation
658
659       complete  (revision|file|key) PARTIAL-ID
660           Completes a partial identifier.
661
662       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
671           --context
672               use context diff format
673
674           --depth <arg>
675               limit the number of levels of directories to descend
676
677           --diff-args <arg>
678               argument to pass external diff hook
679
680           --exclude <arg>
681               leave out anything described by its argument
682
683           --external
684               use external diff hook for generating diffs
685
686           --no-show-encloser / --show-encloser
687               do not show the function containing each block of changes
688
689           --reverse
690               reverse order of diff
691
692           --revision [ -r ] <arg>
693               select revision id for operation
694
695           --unified
696               use unified diff format
697
698           --with-header / --without-header
699               show the matching cset in the diff header
700
701       help  command [ARGS...]
702           Displays help about commands and options.
703
704           --hidden / --no-hidden
705               show hidden commands and options
706
707       list branches  [PATTERN]
708           Lists branches in the database that match a pattern.
709
710           --exclude <arg>
711               leave out anything described by its argument
712
713       list certs  REVID
714           Lists certificates attached to a revision.
715
716       list changed  [PATH...]
717           Lists files that have changed with respect to the current revision.
718
719           --depth <arg>
720               limit the number of levels of directories to descend
721
722           --exclude <arg>
723               leave out anything described by its argument
724
725       list databases
726       list dbs
727           Lists managed databases and their known workspaces.
728
729       list duplicates
730           Lists duplicate files in the specified revision. If no revision  is
731           specified, use the workspace.
732
733           --revision [ -r ] <arg>
734               select revision id for operation
735
736       list epochs  [BRANCH [...]]
737           Lists the current epoch of branches that match a pattern.
738
739       list ignored  [PATH]
740           Lists workspace files that are ignored in the current branch.
741
742           --depth <arg>
743               limit the number of levels of directories to descend
744
745           --exclude <arg>
746               leave out anything described by its argument
747
748           --recursive [ -R ] / --no-recursive
749               also operate on the contents of any listed directories
750
751       list keys  [PATTERN]
752           Lists keys that match a pattern.
753
754       list known
755           Lists workspace files that belong to the current branch.
756
757           --depth <arg>
758               limit the number of levels of directories to descend
759
760           --exclude <arg>
761               leave out anything described by its argument
762
763       list missing
764           Lists files that belong to the branch but are not in the workspace.
765
766           --depth <arg>
767               limit the number of levels of directories to descend
768
769           --exclude <arg>
770               leave out anything described by its argument
771
772       list tags  [PATTERN]
773           Lists all tags in the database.
774
775           --exclude <arg>
776               leave out anything described by its argument
777
778       list unknown  [PATH]
779           Lists workspace files that are unknown in the current branch.
780
781           --depth <arg>
782               limit the number of levels of directories to descend
783
784           --exclude <arg>
785               leave out anything described by its argument
786
787           --recursive [ -R ] / --no-recursive
788               also operate on the contents of any listed directories
789
790       list vars  [DOMAIN]
791           Lists variables in the whole database or a domain.
792
793       list workspaces
794           Lists known workspaces of a specified database.
795
796       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
801           --brief / --no-brief
802               print a brief version of the normal output
803
804           --depth <arg>
805               limit the number of levels of directories to descend
806
807           --diffs / --no-diffs
808               print diffs along with logs
809
810           --exclude <arg>
811               leave out anything described by its argument
812
813           --from <arg> / --clear-from
814               revision(s) to start logging at
815
816           --last <arg>
817               limit log output to the last number of entries
818
819           --next <arg>
820               limit log output to the next number of entries
821
822           --no-files / --files
823               exclude files when printing logs
824
825           --no-graph / --graph
826               do not use ASCII graph to display ancestry
827
828           --no-merges / --merges
829               exclude merges when printing logs
830
831           --revision [ -r ] <arg>
832               select revision id for operation
833
834           --to <arg> / --clear-to
835               revision(s) to stop logging at
836
837       manpage
838           Generate a manual page from monotone's command help.
839
840           --formatted / --plain
841               automatically run the output through nroff (default if the out‐
842               put is a terminal)
843
844           --hidden / --no-hidden
845               show hidden commands and options
846
847       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
852       status  [PATH]...
853           Shows workspace's status information.
854
855           --depth <arg>
856               limit the number of levels of directories to descend
857
858           --exclude <arg>
859               leave out anything described by its argument
860
861       version
862           Shows the program version.
863
864           --full / --concise
865               print detailed information
866
867   command group 'key_and_cert'
868       Commands to manage keys and certificates.
869
870       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
875       dropkey  KEY_NAME_OR_HASH
876           Drops a public and/or private key.
877
878       genkey  KEY_NAME
879           Generates an RSA key-pair.
880
881           --force-duplicate-key
882               force genkey to not error out when the named key already exists
883
884       passphrase  KEY_NAME_OR_HASH
885           Changes the passphrase of a private RSA key.
886
887       ssh_agent_add
888           Adds a private key to ssh-agent.
889
890       ssh_agent_export  [FILENAME]
891           Exports a private key for use with ssh-agent.
892
893       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
897   command group 'network'
898       Commands that access the network.
899
900       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
907           --branch [ -b ] <arg>
908               select branch cert for operation
909
910           --revision [ -r ] <arg>
911               select revision id for operation
912
913       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
919           --dry-run / --no-dry-run
920               don't perform the operation, just show what would have happened
921
922           --exclude <arg>
923               leave out anything described by its argument
924
925           --set-default / --no-set-default
926               use the current netsync arguments and options as the future de‐
927               fault
928
929           --update / --no-update
930               automatically update the workspace, if it was at a head and the
931               command creates a new head
932
933       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
939           --dry-run / --no-dry-run
940               don't perform the operation, just show what would have happened
941
942           --exclude <arg>
943               leave out anything described by its argument
944
945           --key-to-push <arg>
946               push the specified key even if it hasn't signed anything
947
948           --set-default / --no-set-default
949               use the current netsync arguments and options as the future de‐
950               fault
951
952       serve
953           Serves the database to connecting clients.
954
955           --bind <arg>
956               address:port to listen on (default :4691)
957
958           --pid-file <arg> / --no-pid-file
959               record process id of server
960
961       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
967           --dry-run / --no-dry-run
968               don't perform the operation, just show what would have happened
969
970           --exclude <arg>
971               leave out anything described by its argument
972
973           --key-to-push <arg>
974               push the specified key even if it hasn't signed anything
975
976           --set-default / --no-set-default
977               use the current netsync arguments and options as the future de‐
978               fault
979
980           --update / --no-update
981               automatically update the workspace, if it was at a head and the
982               command creates a new head
983
984   command group 'packet_io'
985       Commands for packet reading and writing.
986
987       privkey  KEY_NAME_OR_HASH
988           Prints a private key packet.
989
990       pubkey  KEY_NAME_OR_HASH
991           Prints a public key packet.
992
993       read  [FILE1 [FILE2 [...]]]
994           Reads  packets  from files.  If no files are provided, the standard
995           input is used.
996
997   command group 'review'
998       Commands to review revisions.
999
1000       approve  REVISION
1001           Approves a particular revision.
1002
1003           --branch [ -b ] <arg>
1004               select branch cert for operation
1005
1006           --update / --no-update
1007               automatically update the workspace, if it was at a head and the
1008               command creates a new head
1009
1010       comment  REVISION [COMMENT]
1011           Comments on a particular revision.
1012
1013       disapprove  [PARENT-REVISION] CHILD-REVISION
1014           Disapproves a particular revision or revision range.
1015
1016           --author <arg>
1017               override author for commit
1018
1019           --branch [ -b ] <arg>
1020               select branch cert for operation
1021
1022           --date <arg>
1023               override date/time for commit
1024
1025           --message [ -m ] <arg>
1026               set commit changelog message
1027
1028           --message-file <arg>
1029               set filename containing commit changelog message
1030
1031           --update / --no-update
1032               automatically update the workspace, if it was at a head and the
1033               command creates a new head
1034
1035       suspend  REVISION
1036           Suspends a particular revision.
1037
1038           --branch [ -b ] <arg>
1039               select branch cert for operation
1040
1041           --update / --no-update
1042               automatically update the workspace, if it was at a head and the
1043               command creates a new head
1044
1045       tag  REVISION TAGNAME
1046           Puts a symbolic tag certificate on a revision.
1047
1048       testresult  REV (pass|fail|true|false|yes|no|1|0)
1049           Notes the results of running a test on a revision.
1050
1051   command group 'tree'
1052       Commands to manipulate the tree.
1053
1054       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
1061           --branch [ -b ] <arg>
1062               select branch cert for operation
1063
1064           --move-conflicting-paths / --no-move-conflicting-paths
1065               move conflicting, unversioned paths into '_MTN/resolutions' be‐
1066               fore proceeding with any workspace change
1067
1068           --revision [ -r ] <arg>
1069               select revision id for operation
1070
1071       conflicts clean
1072           Delete any bookkeeping files related to conflict resolution.
1073
1074       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
1078           --conflicts-file <arg>
1079               file in which to store conflicts
1080
1081       conflicts resolve_first_left  RESOLUTION
1082           Set the left resolution for the first unresolved two-file conflict.
1083
1084           --conflicts-file <arg>
1085               file in which to store conflicts
1086
1087       conflicts resolve_first_right  RESOLUTION
1088           Set the right resolution for the  first  unresolved  two-file  con‐
1089           flict.
1090
1091           --conflicts-file <arg>
1092               file in which to store conflicts
1093
1094       conflicts show_first
1095           Show  the first unresolved conflict in the conflicts file, and pos‐
1096           sible resolutions.
1097
1098           --conflicts-file <arg>
1099               file in which to store conflicts
1100
1101       conflicts show_remaining
1102           Show the remaining unresolved conflicts in the conflicts file.
1103
1104           --conflicts-file <arg>
1105               file in which to store conflicts
1106
1107       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
1113           --branch [ -b ] <arg>
1114               select branch cert for operation
1115
1116           --conflicts-file <arg>
1117               file in which to store conflicts
1118
1119       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
1123           --author <arg>
1124               override author for commit
1125
1126           --date <arg>
1127               override date/time for commit
1128
1129           --message [ -m ] <arg>
1130               set commit changelog message
1131
1132           --message-file <arg>
1133               set filename containing commit changelog message
1134
1135           --resolve-conflicts / --no-resolve-conflicts
1136               specify conflict resolutions in a  file,  instead  of  interac‐
1137               tively
1138
1139           --resolve-conflicts-file <arg>
1140               use file to resolve conflicts
1141
1142           --update / --no-update
1143               automatically update the workspace, if it was at a head and the
1144               command creates a new head
1145
1146       heads
1147           Shows unmerged head revisions of a branch.
1148
1149           --branch [ -b ] <arg>
1150               select branch cert for operation
1151
1152       import  DIRECTORY
1153           Imports the contents of a directory into a branch.
1154
1155           --author <arg>
1156               override author for commit
1157
1158           --branch [ -b ] <arg>
1159               select branch cert for operation
1160
1161           --date <arg>
1162               override date/time for commit
1163
1164           --dry-run / --no-dry-run
1165               don't perform the operation, just show what would have happened
1166
1167           --exclude <arg>
1168               leave out anything described by its argument
1169
1170           --message [ -m ] <arg>
1171               set commit changelog message
1172
1173           --message-file <arg>
1174               set filename containing commit changelog message
1175
1176           --no-respect-ignore / --respect-ignore
1177               do not ignore any files
1178
1179           --revision [ -r ] <arg>
1180               select revision id for operation
1181
1182       merge
1183           Merges unmerged heads of a branch.
1184
1185           --author <arg>
1186               override author for commit
1187
1188           --branch [ -b ] <arg>
1189               select branch cert for operation
1190
1191           --date <arg>
1192               override date/time for commit
1193
1194           --message [ -m ] <arg>
1195               set commit changelog message
1196
1197           --message-file <arg>
1198               set filename containing commit changelog message
1199
1200           --resolve-conflicts / --no-resolve-conflicts
1201               specify conflict resolutions in a  file,  instead  of  interac‐
1202               tively
1203
1204           --resolve-conflicts-file <arg>
1205               use file to resolve conflicts
1206
1207           --update / --no-update
1208               automatically update the workspace, if it was at a head and the
1209               command creates a new head
1210
1211       merge_into_dir  SOURCE-BRANCH DEST-BRANCH DIR
1212           Merges one branch into a subdirectory in another branch.
1213
1214           --author <arg>
1215               override author for commit
1216
1217           --date <arg>
1218               override date/time for commit
1219
1220           --message [ -m ] <arg>
1221               set commit changelog message
1222
1223           --message-file <arg>
1224               set filename containing commit changelog message
1225
1226           --resolve-conflicts / --no-resolve-conflicts
1227               specify conflict resolutions in a  file,  instead  of  interac‐
1228               tively
1229
1230           --resolve-conflicts-file <arg>
1231               use file to resolve conflicts
1232
1233           --update / --no-update
1234               automatically update the workspace, if it was at a head and the
1235               command creates a new head
1236
1237       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
1245           --move-conflicting-paths / --no-move-conflicting-paths
1246               move conflicting, unversioned paths into '_MTN/resolutions' be‐
1247               fore proceeding with any workspace change
1248
1249       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
1253       propagate  SOURCE-BRANCH DEST-BRANCH
1254           Merges from one branch to another asymmetrically.
1255
1256           --author <arg>
1257               override author for commit
1258
1259           --date <arg>
1260               override date/time for commit
1261
1262           --message [ -m ] <arg>
1263               set commit changelog message
1264
1265           --message-file <arg>
1266               set filename containing commit changelog message
1267
1268           --resolve-conflicts / --no-resolve-conflicts
1269               specify  conflict  resolutions  in  a file, instead of interac‐
1270               tively
1271
1272           --resolve-conflicts-file <arg>
1273               use file to resolve conflicts
1274
1275       refresh_inodeprints
1276           Refreshes the inodeprint cache.
1277
1278       setup  [DIRECTORY]
1279           Sets up a new workspace directory.  If no directory  is  specified,
1280           uses the current directory.
1281
1282           --branch [ -b ] <arg>
1283               select branch cert for operation
1284
1285   command group 'variables'
1286       Commands to manage persistent variables.
1287
1288       cleanup_workspace_list
1289           Removes  all  invalid,  registered  workspace paths for the current
1290           database.
1291
1292       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
1296       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
1302       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
1306       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
1310   command group 'vcs'
1311       Commands for interaction with other version control systems.
1312
1313       cvs_import  CVSROOT
1314           Imports all versions in a CVS repository.
1315
1316           --branch [ -b ] <arg>
1317               select branch cert for operation
1318
1319       git_export
1320           Produces a git fast-export data stream on stdout.
1321
1322           --authors-file <arg>
1323               file mapping author names from original to new values
1324
1325           --branches-file <arg>
1326               file mapping branch names from original to new values
1327
1328           --export-marks <arg>
1329               save the internal marks table after exporting revisions
1330
1331           --import-marks <arg>
1332               load the internal marks table before exporting revisions
1333
1334           --log-certs / --no-log-certs
1335               include standard cert values in commit logs
1336
1337           --log-revids / --no-log-revids
1338               include revision ids in commit logs
1339
1340           --refs <arg>
1341               include git refs for 'revs', 'roots' or 'leaves'
1342
1343           --use-one-changelog
1344               use only one changelog cert for the git commit message
1345
1346   command group 'workspace'
1347       Commands that deal with the workspace.
1348
1349       add  [PATH]...
1350           Adds files to the workspace.
1351
1352           --no-respect-ignore / --respect-ignore
1353               do not ignore any files
1354
1355           --recursive [ -R ] / --no-recursive
1356               also operate on the contents of any listed directories
1357
1358           --unknown / --no-unknown
1359               perform the operations for unknown files from workspace
1360
1361       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
1366       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
1371       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
1375       ci  [PATH]...
1376       commit  [PATH]...
1377           Commits workspace changes to the database.
1378
1379           --author <arg>
1380               override author for commit
1381
1382           --branch [ -b ] <arg>
1383               select branch cert for operation
1384
1385           --date <arg>
1386               override date/time for commit
1387
1388           --depth <arg>
1389               limit the number of levels of directories to descend
1390
1391           --exclude <arg>
1392               leave out anything described by its argument
1393
1394           --message [ -m ] <arg>
1395               set commit changelog message
1396
1397           --message-file <arg>
1398               set filename containing commit changelog message
1399
1400       drop  [PATH]...
1401       rm  [PATH]...
1402           Drops files from the workspace.
1403
1404           --bookkeep-only
1405               only update monotone's internal bookkeeping, not the filesystem
1406
1407           --missing
1408               perform the operations for files missing from workspace
1409
1410           --recursive [ -R ] / --no-recursive
1411               also operate on the contents of any listed directories
1412
1413       mkdir  [DIRECTORY...]
1414           Creates directories and adds them to the workspace.
1415
1416           --no-respect-ignore / --respect-ignore
1417               do not ignore any files
1418
1419       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
1425           --bookkeep-only
1426               only update monotone's internal bookkeeping, not the filesystem
1427
1428           --move-conflicting-paths / --no-move-conflicting-paths
1429               move conflicting, unversioned paths into '_MTN/resolutions' be‐
1430               fore proceeding with any workspace change
1431
1432       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
1443           --depth <arg>
1444               limit the number of levels of directories to descend
1445
1446           --exclude <arg>
1447               leave out anything described by its argument
1448
1449           --move-conflicting-paths / --no-move-conflicting-paths
1450               move conflicting, unversioned paths into '_MTN/resolutions' be‐
1451               fore proceeding with any workspace change
1452
1453           --revision [ -r ] <arg>
1454               select revision id for operation
1455
1456       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
1462           --bookkeep-only
1463               only update monotone's internal bookkeeping, not the filesystem
1464
1465       revert  [PATH]...
1466           Reverts files and/or directories.  In order to  revert  the  entire
1467           workspace, specify '.' as the file name.
1468
1469           --depth <arg>
1470               limit the number of levels of directories to descend
1471
1472           --exclude <arg>
1473               leave out anything described by its argument
1474
1475           --missing
1476               perform the operations for files missing from workspace
1477
1478       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
1483       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
1490           --branch [ -b ] <arg>
1491               select branch cert for operation
1492
1493           --move-conflicting-paths / --no-move-conflicting-paths
1494               move conflicting, unversioned paths into '_MTN/resolutions' be‐
1495               fore proceeding with any workspace change
1496
1497           --revision [ -r ] <arg>
1498               select revision id for operation
1499

SEE ALSO

1501       info mtn and the documentation on http://www.monotone.ca/docs
1502

BUGS

1504       Please report bugs to https://code.monotone.ca/p/monotone/issues/.
1505

AUTHORS

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
1511       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 - 2023 by the monotone
1516       development team.
1517
1518
1519
1520monotone 1.1                      2023-07-20                       monotone(1)
Impressum