Next: , Previous: Working Copy, Up: Command Reference



5.3 Network

monotone serve address collection
monotone pull address collection
monotone push address collection
monotone sync address collection
These commands operate the “netsync” protocol built into monotone. This is a custom protocol for rapidly synchronizing two monotone databases using a hash tree index. The protocol is “peer to peer”, but requires one peer to listen for incoming connections (the server) and the other peer (the client) to connect to the server.

The network address specified in each case should be the same: a host name to listen on, or connect to, optionally followed by a colon and a port number. The collection parameter indicates a set of branches to exchange; every branch for which collection is a prefix will be indexed and made available for synchronization.

For example, supposing bob and alice wish to synchronize their net.venge.monotone.win32 and net.venge.monotone.i18n branches. Supposing alice's computer has hostname alice.someisp.com, then alice might run:

          $ monotone serve alice.someisp.com net.venge.monotone
     

And bob might run

          $ monotone sync alice.someisp.com net.venge.monotone
     

When the operation completes, all branches beginning with net.venge.monotone will be synchronized between alice and bob's databases.