mirror of
				https://gogs.blitter.com/RLabs/xs
				synced 2024-08-14 10:26:42 +00:00 
			
		
		
		
	Compare commits
	
		
			No commits in common. "f24d4d8fdb400c8de059d5237842b0fa5b6e56d1" and "819b359306b1e69d87f7f135b732f01b3852a2d1" have entirely different histories.
		
	
	
		
			f24d4d8fdb
			...
			819b359306
		
	
		
					 2 changed files with 10 additions and 22 deletions
				
			
		
							
								
								
									
										2
									
								
								Makefile
									
										
									
									
									
								
							
							
						
						
									
										2
									
								
								Makefile
									
										
									
									
									
								
							|  | @ -1,4 +1,4 @@ | ||||||
| VERSION := 0.9.5.1 | VERSION := 0.9.4 | ||||||
| .PHONY: lint vis clean common client server passwd subpkgs install uninstall reinstall | .PHONY: lint vis clean common client server passwd subpkgs install uninstall reinstall | ||||||
| 
 | 
 | ||||||
| ## Tag version of binaries with build info wrt.
 | ## Tag version of binaries with build info wrt.
 | ||||||
|  |  | ||||||
							
								
								
									
										30
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										30
									
								
								README.md
									
										
									
									
									
								
							|  | @ -102,34 +102,23 @@ 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/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 | * [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/xs@latest |  | ||||||
| $ go install blitter.com/go/xs/xsd@latest |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| (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 | ### Get source code | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
| $ git clone https://gogs.blitter.com/RLabs/xs | $ go get -u blitter.com/go/xs | ||||||
|  | $ cd $GOPATH/src/blitter.com/go/xs | ||||||
|  | $ go build ./... # install all dependent go pkgs | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| 
 | 
 | ||||||
| ### To build | ### To build | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
| $ cd xs | $ cd $GOPATH/src/blitter.com/go/xs | ||||||
| $ make clean && make | $ make clean all | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ### To install, uninstall, re-install (xsd server) | ### To install, uninstall, re-install | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
| $ sudo make [install | uninstall | reinstall] | $ sudo make [install | uninstall | reinstall] | ||||||
|  | @ -157,10 +146,9 @@ The make system assumes installation in /usr/local/sbin (xsd, xspasswd) and /usr | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
| $ sudo rc-config [start | restart | stop] xsd | $ sudo rc-config [start | restart | stop] xsd | ||||||
| # .. or sudo /etc/init.d/xsd [start | restart stop] |  | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ### To set accounts & passwords (DEPRECATED: `-s` is now true by default) | ### To set accounts & passwords: | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
| $ sudo touch /etc/xs.passwd | $ sudo touch /etc/xs.passwd | ||||||
|  | @ -226,7 +214,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>). | 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: | 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: | ||||||
| 
 | 
 | ||||||
| ``` | ``` | ||||||
|  | @ -238,7 +226,7 @@ Perhaps in future a more complex handshake will be devised to allow the client t | ||||||
| 
 | 
 | ||||||
| ### Tunnels | ### 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>...} | Syntax: xs -T=<tunspec>{,<tunspec>...} | ||||||
| .. where <tunspec> is <localport:remoteport> | .. where <tunspec> is <localport:remoteport> | ||||||
|  |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue