This file is indexed.

/usr/share/doc/monotone/html/Using-packets.html is in monotone-doc 1.1-7.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>monotone documentation: Using packets</title>

<meta name="description" content="monotone documentation: Using packets">
<meta name="keywords" content="monotone documentation: Using packets">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="General-Index.html#General-Index" rel="index" title="General Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Advanced-Uses.html#Advanced-Uses" rel="up" title="Advanced Uses">
<link href="Bisecting.html#Bisecting" rel="next" title="Bisecting">
<link href="Exporting-to-GIT.html#Exporting-to-GIT" rel="prev" title="Exporting to GIT">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="texinfo.css">


</head>

<body lang="en">
<a name="Using-packets"></a>
<div class="header">
<p>
Next: <a href="Bisecting.html#Bisecting" accesskey="n" rel="next">Bisecting</a>, Previous: <a href="Exporting-to-GIT.html#Exporting-to-GIT" accesskey="p" rel="prev">Exporting to GIT</a>, Up: <a href="Advanced-Uses.html#Advanced-Uses" accesskey="u" rel="up">Advanced Uses</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="General-Index.html#General-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Using-packets-1"></a>
<h3 class="section">3.18 Using packets</h3>

<p>Suppose you made changes to your database, and want to send those
changes to someone else but for some reason you cannot use netsync.  Or
maybe you want to extract and inject individual revisions automatically
via an external program. In this case, you can convert the information
into packets. Packets are a convenient way to represent revisions and
other database contents as plain text with wrapped lines &ndash; just what
you need if you want to send them in the body of an email.
</p>
<p>This is a tutorial on how to transfer single revisions between
databases by dumping them from one database to a text file and then
reading the dump into a second database.
</p>
<p>We will create two databases, A and B, then create a few revisions in
A, and transfer part of them to B.
</p>
<p>First we initialize the databases (we assume you have a key for
commits already):
</p>
<div class="smallexample">
<pre class="smallexample">$ mtn -d A db init
$ mtn -d B db init
</pre></div>

<p>Now set up a branch in A:
</p>
<div class="smallexample">
<pre class="smallexample">$ mtn -d A setup -b test test
</pre></div>

<p>And let&rsquo;s put some revisions in that branch:
</p>
<div class="smallexample">
<pre class="smallexample">$ cd test/
$ cat &gt; file
xyz
^D
$ mtn add file
$ mtn ci -m &quot;One&quot;    <i>You may need to select a key and type a passphrase here</i>
$ cat &gt; file2
file 2 getting in
^D
$ cat &gt; file
ERASE
^D
$ mtn add file2
$ mtn ci -m &quot;Two&quot;
$ cat &gt; file
THIRD
^D
$ mtn ci -m &quot;Three&quot;
</pre></div>

<p>OK, that&rsquo;s enough.  Let&rsquo;s see what we have:
</p>
<div class="smallexample">
<pre class="smallexample">$ cd ..
$ mtn -d A automate select i: | mtn -d A automate toposort -@-
a423db0ad651c74e41ab2529eca6f17513ccf714
d14e89582ad9030e1eb62f563c8721be02ca0b65
151f1fb125f19ebe11eb8bfe3a5798fcbea4e736
</pre></div>

<p>Three revisions! Let&rsquo;s transfer the first one to the database B. First we
get the meta-information on that revision:
</p>
<div class="smallexample">
<pre class="smallexample">$ mtn -d A automate get_revision a423db0ad651c74e41ab2529eca6f17513ccf714
format_version &quot;1&quot;

new_manifest [b6dbdbbe0e7f41e44d9b72f9fe29b1f1a4f47f18]

old_revision []

add_dir &quot;&quot;

add_file &quot;file&quot;
 content [8714e0ef31edb00e33683f575274379955b3526c]
</pre></div>

<p>OK, one file was added in this revision. We&rsquo;ll transfer it. Now, <em>ORDER MATTERS</em>!
We should transfer:
</p>
<ol>
<li> the key used to sign things
</li><li> The file data (fdata) and file deltas (fdeltas), if any
</li><li> The release data (rdata)
</li><li> The certs
</li></ol>

<p>In that order. This is because certs make reference to revision data
and keys, and revision data makes reference to file data and file
deltas.
</p>
<div class="smallexample">
<pre class="smallexample">mtn -d A pubkey johndoe@domain.com &gt; KEY_PACKETS
mtn -d A automate packet_for_fdata 8714e0ef31edb00e33683f575274379955b3526c &gt; PACKETS
mtn -d A automate packet_for_rdata a423db0ad651c74e41ab2529eca6f17513ccf714 &gt;&gt; PACKETS
mtn -d A automate packets_for_certs a423db0ad651c74e41ab2529eca6f17513ccf714 &gt;&gt; PACKETS
mtn -d B read KEY_PACKETS PACKETS
</pre></div>

<p>Database B now contains revision
a423db0ad651c74e41ab2529eca6f17513ccf714. You may want to check the
PACKETS file to see what the packets look like.
</p>
<p>Now let&rsquo;s transfer one more revision:
</p>
<div class="smallexample">
<pre class="smallexample">mtn -d A automate get_revision d14e89582ad9030e1eb62f563c8721be02ca0b65
format_version &quot;1&quot;

new_manifest [48a03530005d46ed9c31c8f83ad96c4fa22b8b28]

old_revision [a423db0ad651c74e41ab2529eca6f17513ccf714]

add_file &quot;file2&quot;
 content [d2178687226560032947c1deacb39d16a16ea5c6]

patch &quot;file&quot;
 from [8714e0ef31edb00e33683f575274379955b3526c]
   to [8b52d96d4fab6c1e56d6364b0a2673f4111b228e]
</pre></div>

<p>From what we see, in this revision we have one new file and one patch, so we do the
same we did before for them:
</p>
<div class="smallexample">
<pre class="smallexample">mtn -d A automate packet_for_fdata d2178687226560032947c1deacb39d16a16ea5c6 &gt; PACKETS2
mtn -d A automate packet_for_fdelta
8714e0ef31edb00e33683f575274379955b3526c 8b52d96d4fab6c1e56d6364b0a2673f4111b228e &gt;&gt; PACKETS2
mtn -d A automate packet_for_rdata d14e89582ad9030e1eb62f563c8721be02ca0b65 &gt;&gt; PACKETS2
mtn -d A automate packets_for_certs d14e89582ad9030e1eb62f563c8721be02ca0b65 &gt;&gt; PACKETS2
mtn -d B read &lt; PACKETS2
</pre></div>

<p>Fine. The two revisions should be in the second database now.
Let&rsquo;s take a look at what&rsquo;s in each database:
</p>
<div class="smallexample">
<pre class="smallexample">$ mtn -d A automate select i: | mtn -d A automate toposort -@-
a423db0ad651c74e41ab2529eca6f17513ccf714
d14e89582ad9030e1eb62f563c8721be02ca0b65
151f1fb125f19ebe11eb8bfe3a5798fcbea4e736

$ mtn -d B automate select i: | mtn -d B automate toposort -@-
a423db0ad651c74e41ab2529eca6f17513ccf714
d14e89582ad9030e1eb62f563c8721be02ca0b65
</pre></div>

<p>Good! B has the two first revisions (as expected), and A has all
three. We can checkout from B:
</p>
<div class="smallexample">
<pre class="smallexample">$ mtn -d B co -b test test-B
$ ls test-B
file file2  _MTN
$ more test-B/file
ERASE
$ more test-B/file2
file 2 getting in
</pre></div>

<p>And that&rsquo;s it! The revisions were successfully transferred.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Bisecting.html#Bisecting" accesskey="n" rel="next">Bisecting</a>, Previous: <a href="Exporting-to-GIT.html#Exporting-to-GIT" accesskey="p" rel="prev">Exporting to GIT</a>, Up: <a href="Advanced-Uses.html#Advanced-Uses" accesskey="u" rel="up">Advanced Uses</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="General-Index.html#General-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>