summaryrefslogtreecommitdiff
path: root/tickets/3802012a45ca4b7fb7d1aa3f3cda1775/Maildir/new/1483003508.M497097P5123Q1.hrun
blob: 284efca0f0d7f2bafd41b2cc83a501ddd69d3abb (plain)
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
Return-Path: <obnam-dev-bounces@obnam.org>
X-Original-To: distix@pieni.net
Delivered-To: distix@pieni.net
Received: from bagpuss.pepperfish.net (bagpuss.pepperfish.net [148.251.8.16])
	(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by pieni.net (Postfix) with ESMTPS id 756AB203D9
	for <distix@pieni.net>; Thu, 29 Dec 2016 10:23:37 +0100 (CET)
Received: from platypus.pepperfish.net (unknown [10.112.100.20])
	by bagpuss.pepperfish.net (Postfix) with ESMTP id 1EA1AB91;
	Thu, 29 Dec 2016 09:23:37 +0000 (GMT)
Received: from ip6-localhost ([::1] helo=platypus.pepperfish.net)
	by platypus.pepperfish.net with esmtp (Exim 4.80 #2 (Debian))
	id 1cMWvw-0002NY-VS; Thu, 29 Dec 2016 09:23:37 +0000
Received: from inmail0 ([10.112.100.10] helo=mx0.pepperfish.net)
 by platypus.pepperfish.net with esmtp (Exim 4.80 #2 (Debian))
 id 1cMWvv-0002NM-8r
 for <obnam-dev@obnam.org>; Thu, 29 Dec 2016 09:23:35 +0000
Received: from pieni.net ([95.142.166.37] ident=postfix)
 by mx0.pepperfish.net with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256)
 (Exim 4.80) (envelope-from <liw@liw.fi>) id 1cMWvs-0007fI-9a
 for obnam-dev@obnam.org; Thu, 29 Dec 2016 09:23:35 +0000
Received: from exolobe3.liw.fi (82-181-57-241.bb.dnainternet.fi
 [82.181.57.241])
 (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by pieni.net (Postfix) with ESMTPSA id AC09B203D9;
 Thu, 29 Dec 2016 10:23:24 +0100 (CET)
Received: from exolobe3 (localhost [127.0.0.1])
 by exolobe3.liw.fi (Postfix) with ESMTPS id 3EDFC1200C3;
 Thu, 29 Dec 2016 11:23:23 +0200 (EET)
Date: Thu, 29 Dec 2016 11:23:22 +0200
From: Lars Wirzenius <liw@liw.fi>
To: Paul Waring <paul@xk7.net>
Message-ID: <20161229092322.nx4voms6soafx65g@exolobe3>
References: <5e1732e1-ad95-ae51-5328-2896962371ea@xk7.net>
MIME-Version: 1.0
In-Reply-To: <5e1732e1-ad95-ae51-5328-2896962371ea@xk7.net>
User-Agent: NeoMutt/20161126 (1.7.1)
X-Pepperfish-Transaction: e8f9-2afc-3e79-6c87
X-Spam-Score: -2.9
X-Spam-Score-int: -28
X-Spam-Bar: --
X-Scanned-By: pepperfish.net, Thu, 29 Dec 2016 09:23:35 +0000
X-Spam-Report: Content analysis details: (-2.9 points)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 PPF_USER_AGENT_MUTT    User-Agent: contains Mutt (Mutt isn't a spam
 tool) -0.5 PPF_USER_AGENT         User-Agent: exists
 0.5 PPF_MESSAGEID_NODOTS   Message-Id contains no dots after the @
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-ACL-Warn: message may be spam
X-Scan-Signature: 158c4740c279b904d023a01a6041c5ee
Cc: obnam-dev@obnam.org
Subject: Re: Improving error message when restoring on a different client
X-BeenThere: obnam-dev@obnam.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Obnam development discussions <obnam-dev-obnam.org>
List-Unsubscribe: <http://listmaster.pepperfish.net/cgi-bin/mailman/listinfo/obnam-dev-obnam.org>,
 <mailto:obnam-dev-request@obnam.org?subject=unsubscribe>
List-Archive: <http://listmaster.pepperfish.net/pipermail/obnam-dev-obnam.org>
List-Post: <mailto:obnam-dev@obnam.org>
List-Help: <mailto:obnam-dev-request@obnam.org?subject=help>
List-Subscribe: <http://listmaster.pepperfish.net/cgi-bin/mailman/listinfo/obnam-dev-obnam.org>,
 <mailto:obnam-dev-request@obnam.org?subject=subscribe>
Content-Type: multipart/mixed; boundary="===============0407934741661972598=="
Mime-version: 1.0
Sender: obnam-dev-bounces@obnam.org
Errors-To: obnam-dev-bounces@obnam.org


--===============0407934741661972598==
Content-Type: multipart/signed; micalg=pgp-sha512;
 protocol="application/pgp-signature"; boundary="2xd5ww3wbatfbgqs"
Content-Disposition: inline


--2xd5ww3wbatfbgqs
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Dec 28, 2016 at 08:35:45PM +0000, Paul Waring wrote:
> I recently tried restoring backups of client A on another machine B using
> the following command from the obnam documentation.
>=20
> obnam mount -r /path/to/repository --to ~/restore/
>=20
> The error message I received was:
>=20
> ERROR: R24424X: Repository client B does not exist
>=20
> I had no idea what R24424X was or why obnam would be telling me that clie=
nt
> B didn't exist when I wanted to restore client A (I keep one client per
> repository, which may not be a typical use case).

The R.....X codes are Obnam's error codes. They're reasonably stable
and automatically generated. It's there to make it easier to grep for
errors. Some day it'll be useful to understand log files from users
who use a non-English locale, as the error code will be unchanged.

See obnamlib/structurederror.py for details. In short, each error
message is a class (subclass of obnamlib.StructuredError) and the
class contains the error text (or template).

The manual has an automatically generated list of error codes and
message:
http://code.liw.fi/obnam/manual/ci/obnam-manual.en.html#appendix-error-mess=
ages

This particular error message is "generic", i.e., used for all obnam
commands that need to access the repository as a client, but the
client name isn't found (possibly becuase, as in your case, the
client name is automatically chosen from the computer hostname, and
the user didn't know about it). Thus, I'd like the error message text
to be suitable for them. Possibly something like:

    "Client B does not exist in the repository. Use --client-name A to
    choose client name, and 'obnam clients' to see which exist."

Improving the manual would be a good thing as well.

> Alternatively, perhaps it might be worth documenting the use of
> --client-name in the 'Restoring from backups' section of the manual? I am
> happy to improve the docs, but I have no idea where to start with the cod=
e.

Patch for error messsage or manual or both warmly welcome. Thank you.

--=20
I want to build worthwhile things that might last. --joeyh

--2xd5ww3wbatfbgqs
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEETNTnrewG6wEE1EJ3bC+mFux6IDEFAlhk1gkACgkQbC+mFux6
IDGqUBAAut3+KGf1a5PW4gDfy20AMIYnbS96c/D61yQoZUrDA0lPwgZ9UqsmkTpQ
4HFo65gVTkkjPo1f9pQ/GVpmphcXpW2jtrLW7Ixem7fKg0zRt7nUGw86nG+/NZMA
fqKJsjBBGLJ+ZJ5iYtzEd09wgyXxMamM0t0WYx+OXFJjBHUIIhfFz9q73FrxSaYQ
/dz398vi7D5w9Tl8ZUxW5V8ii44BHQgdL1VikVn8ORYFukZ3UMwMjYJDeETi4ATe
Ets5zAjm4xwdLZxkrqdWQml66i8++aQNkRbEFtE0eNy4CS5Qv40ijJC7l352hgg6
e8CJ6l5q+vRj7KE0Lqhg1mM7nzSmODUFjdpzLKqI+5n9ZsMQhHUp9sSfB+kSvv6I
Se/qu7nf+qh67sn3hPzoH9DpHznvh19nioWsoAqvpPH0MJ5I1Cs6lVwLmX9iWedA
lMBUMLlYXA2sPOtoRfOLg2wR3OtxdRVMWcIyQEFpb6V+OCEuSb5Gz5Xk9GyaFQ5Y
70kcAgo8SdFddwXVyHdz5lUrfO/a9ZCoTBu7F4JCHke548Iy9Z8gw7IjtVoJD7lN
oU4OntXz/8y5Y5Bew1iIZ7itL+nqdLN14HXsiYPlk4GEi/7NmmlfPF6tTWtl+2by
KlS16T7aDajQmgLTUteuTj/u18zcScuqEz7nTq6BTz8s8A4xFD8=
=O8PH
-----END PGP SIGNATURE-----

--2xd5ww3wbatfbgqs--


--===============0407934741661972598==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
obnam-dev mailing list
obnam-dev@obnam.org
http://listmaster.pepperfish.net/cgi-bin/mailman/listinfo/obnam-dev-obnam.org

--===============0407934741661972598==--