From 73eadf7534fa3e8e7640eff9e15923afe4d895b0 Mon Sep 17 00:00:00 2001 From: Russtopia Date: Sat, 2 Jul 2022 12:00:12 -0700 Subject: [PATCH 1/4] Update 'README.md' --- README.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e62a3c5..ccadb25 100644 --- a/README.md +++ b/README.md @@ -105,17 +105,15 @@ As of this time (Oct 2018) Kyber is one of the candidate algorithms submitted to ### Get source code ``` -$ go get -u blitter.com/go/xs -$ cd $GOPATH/src/blitter.com/go/xs -$ go build ./... # install all dependent go pkgs +$ git clone https://gogs.blitter.com/RLabs/xs ``` ### To build ``` -$ cd $GOPATH/src/blitter.com/go/xs -$ make clean all +$ cd xs +$ make clean && make ``` ### To install, uninstall, re-install @@ -146,6 +144,7 @@ The make system assumes installation in /usr/local/sbin (xsd, xspasswd) and /usr ``` $ sudo rc-config [start | restart | stop] xsd +# .. or sudo /etc/init.d/xsd [start | restart stop] ``` ### To set accounts & passwords: @@ -214,7 +213,7 @@ NOTE: Renaming while copying (eg., 'cp /foo/bar/fileA ./fileB') is NOT supported If the 'pv' pipeview utility is available (http://www.ivarch.com/programs/pv.shtml) file transfer progress and bandwidth control will be available (suppress the former with the -q option, set the latter with -L <bytes_per_second>). -Special care should be taken when doing client->server copies: since the tarpipe (should) always succeed at least sending data to the remote side, a destination with no write permission will not return a nonzero status and the client closes its end after sending all data, giving the server no opportunity to send an error code to the client. +Special care should be taken when doing client → server copies: since the tarpipe (should) always succeed at least sending data to the remote side, a destination with no write permission will not return a nonzero status and the client closes its end after sending all data, giving the server no opportunity to send an error code to the client. It is recommended to test beforehand if the server-side destination is writable (and optionally if the destination already exists, if one does not want to clobber an existing path) by: ``` @@ -226,7 +225,7 @@ Perhaps in future a more complex handshake will be devised to allow the client t ### Tunnels -Simple tunnels (client -> server, no reverse tunnels for now) are supported. +Simple tunnels (client → server, no reverse tunnels for now) are supported. Syntax: xs -T=<tunspec>{,<tunspec>...} .. where <tunspec> is <localport:remoteport> From 41769660cce27ded09971e010d6dff14502aeee0 Mon Sep 17 00:00:00 2001 From: Russtopia Date: Sat, 2 Jul 2022 12:01:15 -0700 Subject: [PATCH 2/4] =?UTF-8?q?Bump=20version=20=E2=86=92=200.9.5.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 3b178e4..319723c 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -VERSION := 0.9.4 +VERSION := 0.9.5.1 .PHONY: lint vis clean common client server passwd subpkgs install uninstall reinstall ## Tag version of binaries with build info wrt. From 42ad33065bc61671fbc326d5e3cb7cb7f3f52c73 Mon Sep 17 00:00:00 2001 From: Russtopia Date: Sat, 2 Jul 2022 12:44:37 -0700 Subject: [PATCH 3/4] Update 'README.md' --- README.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ccadb25..feb8ca3 100644 --- a/README.md +++ b/README.md @@ -102,6 +102,19 @@ As of this time (Oct 2018) Kyber is one of the candidate algorithms submitted to * [blitter.com/go/mtwist](https://gogs.blitter.com/RLabs/mtwist) // 64-bit Mersenne Twister PRNG * [blitter.com/go/cryptmt](https://gogs.blitter.com/RLabs/cryptmt) // CryptMTv1 stream cipher + +### Installing + +As of Go 1.8, one can directly use `go install` to get the client `xs` and server `xsd` binaries; however it is not recommended, as `xsd` requires root and for general use should be in one of the system directories, akin to other daemons. If one insists, the following will work to place them in $HOME/go/bin: + +``` +$ go install blitter.com/go/xs@latest +$ go install blitter.com/go/xsd@latest +``` + +(NOTE the `-v` option for binaries obtained in this manner will be blank; another reason to build them yourself locally using the steps below.) + + ### Get source code ``` @@ -116,7 +129,7 @@ $ cd xs $ make clean && make ``` -### To install, uninstall, re-install +### To install, uninstall, re-install (xsd server) ``` $ sudo make [install | uninstall | reinstall] @@ -147,7 +160,7 @@ $ sudo rc-config [start | restart | stop] xsd # .. or sudo /etc/init.d/xsd [start | restart stop] ``` -### To set accounts & passwords: +### To set accounts & passwords (DEPRECATED: `-s` is now true by default) ``` $ sudo touch /etc/xs.passwd From f24d4d8fdb400c8de059d5237842b0fa5b6e56d1 Mon Sep 17 00:00:00 2001 From: Russtopia Date: Sat, 2 Jul 2022 12:51:18 -0700 Subject: [PATCH 4/4] Update 'README.md' --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index feb8ca3..ef6d2cc 100644 --- a/README.md +++ b/README.md @@ -108,11 +108,11 @@ As of this time (Oct 2018) Kyber is one of the candidate algorithms submitted to As of Go 1.8, one can directly use `go install` to get the client `xs` and server `xsd` binaries; however it is not recommended, as `xsd` requires root and for general use should be in one of the system directories, akin to other daemons. If one insists, the following will work to place them in $HOME/go/bin: ``` -$ go install blitter.com/go/xs@latest -$ go install blitter.com/go/xsd@latest +$ go install blitter.com/go/xs/xs@latest +$ go install blitter.com/go/xs/xsd@latest ``` -(NOTE the `-v` option for binaries obtained in this manner will be blank; another reason to build them yourself locally using the steps below.) +(NOTE the `-v` (version) option for binaries obtained in this manner will be blank; another reason to build them yourself locally using the steps below.) ### Get source code