On Wed, Aug 30, 2017 at 04:18:14PM +0200, Pino Toscano wrote:
Mention which format URIs follow, with a small example on escaping
special characters.
---
fish/guestfish.pod | 10 ++++++++++
1 file changed, 10 insertions(+)
diff --git a/fish/guestfish.pod b/fish/guestfish.pod
index c3f684563..1201176e9 100644
--- a/fish/guestfish.pod
+++ b/fish/guestfish.pod
@@ -1225,6 +1225,16 @@ The equivalent API command would be:
><fs> add /disk protocol:ssh
server:tcp:example.com [username:user]
+Note that the URIs follow the syntax of
+L<RFC
3986|https://tools.ietf.org/html/rfc3986>: in particular, there
+are restrictions on the allowed characters for the various components
+of the URI. Characters such as C<:>, C<@>, and C</> B<must> be
+percent-encoded:
+
+ $ guestfish -a ssh://user:pass%40word@example.com/disk.img
+
+In this case, the password is C<pass@word>.
+
I agree the only good fix here is to document it.
ACK.
Rich.
--
Richard Jones, Virtualization Group, Red Hat
http://people.redhat.com/~rjones
Read my programming and virtualization blog:
http://rwmj.wordpress.com
libguestfs lets you edit virtual machines. Supports shell scripting,
bindings from many languages.
http://libguestfs.org