Skip to content

Rust library to communicate with openssh-mux-server

License

Notifications You must be signed in to change notification settings

openssh-rust/openssh-mux-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openssh-mux-client

Rust

crate.io downloads

crate.io version

docs

Rust library to communicate with openssh-mux-server using ssh_format.

The entire crate is built upon official document on ssh multiplex protocol.

Currently, I have written a few test cases to make sure the

  • health check
  • session opening
  • remote port forwarding
  • graceful shutdown of the ssh multiplex server
  • local port forwarding

are working as intended, while features

  • dynamic forwarding

are implemented but not tested.

There are also two features that I didn't implement:

  • forward stdio (stdin + stdout) to remote port (not that useful)
  • closure of port forwarding (according to the [document], it is not implemented yet by ssh)
  • terminating the ssh multiplex server for the ssh implementation is buggy (the server does not reply with the Ok message before it terminates).

While it is extremely likely there are bugs in my code, I think it is ready for testing.

Development

To run tests, make sure you have bash, ssh and docker installed on your computer and run:

/path/to/repository/run_test.sh