Updated sample command lines to use valid ipv6 syntax.
Also:
- Added note that large transfers will fail.
- Reformatted lines > 80 characters.
Change-Id: I24494699b1f138c90574aad6adbafb4caedc559a
diff --git a/fuchsia/README.md b/fuchsia/README.md
index 9919efb..83e60da 100644
--- a/fuchsia/README.md
+++ b/fuchsia/README.md
@@ -1,24 +1,38 @@
# OpenSSH on Fuchsia
## Server
-OpenSSH's sshd is run by default at start-up. It's listening on IPv4 and IPv6. The username it expects is `fuchsia`.
-An SSH key is generated at build time and included in `authorized-keys`. An `ssh_config` referencing that key is also
-generated. The easiest way to ssh to your Fuchsia device named `foo-bar-baz-wib` is:
+OpenSSH's sshd is run by default at start-up. It's listening on IPv4 and IPv6.
+The username it expects is `fuchsia`.
+
+An SSH key is generated at build time and included in `authorized-keys`. An
+`ssh_config` referencing that key is also generated. The easiest way to ssh to
+your default Fuchsia device is:
+
```
-ssh -F $FUCHSIA_BUILD_DIR/ssh-keys/ssh_config $(netaddr --fuchsia foo-bar-baz-wib)
+ssh -F $FUCHSIA_BUILD_DIR/ssh-keys/ssh_config \
+ $($FUCHSIA_OUT_DIR/build-magenta/tools/netaddr --fuchsia)
```
-Similarly you can `scp` or `sftp` using the same config file:
+Similarly you can `scp` or `sftp` using the same config file. Note that
+scp and sftp require the ipv6 address to be in square brackets, unlike ssh.
+
```
-sftp -F $FUCHSIA_BUILD_DIR/ssh-keys/ssh_config $(netaddr --fuchsia foo-bar-baz-wib)
+sftp -F $FUCHSIA_BUILD_DIR/ssh-keys/ssh_config \
+ [$($FUCHSIA_OUT_DIR/build-magenta/tools/netaddr --fuchsia)]
+
scp -F $FUCHSIA_BUILD_DIR/ssh-keys/ssh_config \
/local/path/file.txt \
- $(netaddr --fuchsia foo-bar-baz-wib):/remote/path/file.txt
+ [$($FUCHSIA_OUT_DIR/build-magenta/tools/netaddr --fuchsia)]:/remote/path
```
-*NOTE*: There remain some serious issues with the shell terminal handling. Escape characters in the prompt are printed
-verbatim. Enter must be pressed twice to run a command.
+*NOTE 1*: Transfers of large files will stall and eventually fail. The cause is
+being investigated.
+
+*NOTE 2*: There remain some serious issues with the shell terminal handling.
+Escape characters in the prompt are printed verbatim. Enter must be pressed
+twice to run a command.
## Client
+
The clients are built but don't work yet.