mirror of https://gogs.blitter.com/RLabs/xs
				
				
				
			Update 'README.md'
This commit is contained in:
		
							parent
							
								
									be7f84adcf
								
							
						
					
					
						commit
						43221cbba6
					
				
							
								
								
									
										27
									
								
								README.md
								
								
								
								
							
							
						
						
									
										27
									
								
								README.md
								
								
								
								
							| 
						 | 
				
			
			@ -74,18 +74,33 @@ Get source code
 | 
			
		|||
* $ cd $GOPATH/src/blitter.com/go/hkexsh
 | 
			
		||||
* $ go build ./... # install all dependent go pkgs
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
To build
 | 
			
		||||
--
 | 
			
		||||
* $ cd $GOPATH/src/blitter.com/go/hkexsh
 | 
			
		||||
* $ make clean all
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
To install
 | 
			
		||||
--
 | 
			
		||||
* $ sudo make install
 | 
			
		||||
 | 
			
		||||
An example init script (hkexshd.initrc) is provided. Consult your Linux distribution documentation for proper service/daemon installation. Default assumes installation in /usr/local/sbin (hkexshd, hkexpasswd) and /usr/local/bin (hkexsh/hkexcp symlink).
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
To uninstall
 | 
			
		||||
--
 | 
			
		||||
* $ sudo make uninstall
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
To set accounts & passwords:
 | 
			
		||||
--
 | 
			
		||||
* $ sudo touch /etc/hkexsh.passwd
 | 
			
		||||
* $ sudo hkexpasswd/hkexpasswd -u joebloggs
 | 
			
		||||
* $ <enter a password, enter again to confirm>
 | 
			
		||||
 | 
			
		||||
Running Clent and Server
 | 
			
		||||
 | 
			
		||||
Testing Client and Server from $GOPATH dev tree
 | 
			
		||||
--
 | 
			
		||||
In separate shells A and B:
 | 
			
		||||
* [A]$ cd hkexshd && sudo ./hkexshd &  # add -d for debugging
 | 
			
		||||
| 
						 | 
				
			
			@ -106,7 +121,7 @@ Setting up an 'authtoken' for scripted (password-free) logins
 | 
			
		|||
--
 | 
			
		||||
Use the -g option of hkexsh to request a token from the remote server, which will return a
 | 
			
		||||
hostname:token string. Place this string into $HOME/.hkexsh_id to allow logins without
 | 
			
		||||
entering a password (obviously, $HOME/.hkexsh_id on both server and client $HOME for the user
 | 
			
		||||
entering a password (obviously, $HOME/.hkexsh_id on both server and client for the user
 | 
			
		||||
should *not* be world-readable.)
 | 
			
		||||
 | 
			
		||||
File Copying using hkexcp
 | 
			
		||||
| 
						 | 
				
			
			@ -121,10 +136,10 @@ remote user. File operations are all performed as the remote user, so account pe
 | 
			
		|||
as expected.
 | 
			
		||||
 | 
			
		||||
Local (client) to remote (server) copy:
 | 
			
		||||
* cd hkexsh && ./hkexcp fileA /some/where/fileB /some/where/else/dirC joebloggs@host-or-ip:remoteDir
 | 
			
		||||
* hkexcp fileA /some/where/fileB /some/where/else/dirC joebloggs@host-or-ip:remoteDir
 | 
			
		||||
 | 
			
		||||
Remote (server) to local (client) copy:
 | 
			
		||||
* cd hekxsh && ./hkexcp joebloggs@host-or-ip:/remoteDirOrFile /some/where/local/Dir
 | 
			
		||||
* hkexcp joebloggs@host-or-ip:/remoteDirOrFile /some/where/local/Dir
 | 
			
		||||
 | 
			
		||||
NOTE: Renaming while copying is NOT supported (ie., like cp's 'cp /foo/bar/fileA ./fileB).
 | 
			
		||||
Put another way, the destination (whether local or remote) is ALWAYS a dir.
 | 
			
		||||
| 
						 | 
				
			
			@ -144,5 +159,5 @@ Syntax: hkexsh -T=<tunspec>{,<tunspec>...}
 | 
			
		|||
Example, tunnelling ssh through hkexsh
 | 
			
		||||
 | 
			
		||||
* [server side] $ sudo /usr/sbin/sshd -p 7002
 | 
			
		||||
* [client side] $ hkexsh -T=6002:7002 @server.hostname
 | 
			
		||||
* [client side] $ ssh user@localhost -p 6002
 | 
			
		||||
* [client side, term A] $ hkexsh -T=6002:7002 user@server
 | 
			
		||||
* [client side, term B] $ ssh user@localhost -p 6002
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue