From f5cf90990d43eb6a4889e9290733376af45ee432 Mon Sep 17 00:00:00 2001 From: David Cowden <dcow@smallstep.com> Date: Tue, 16 Jun 2020 08:45:48 -0700 Subject: [PATCH] README: Link more things and style touch-up (1) change golang to Go (preferred brand name), (2) use module instead of library, and (3) style links. --- README.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 660324b..5592a2c 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,25 @@ # sshutil -A [single-dependency][gomod] utility package that provides a `net/http` style ssh server. +A [single-dependency][gomod] utility package that provides a [`net/http`][net-http] style SSH server. -`sshutil` is part of the [Smallstep][smallstep] crypto suite. +`sshutil` is part of the [Smallstep][smallstep] crypto suite ([step][], [step-ca][], etc.). [gomod]: https://github.com/smallstep/sshutil/blob/master/go.mod +[net-http]: https://golang.org/pkg/net/http/ [smallstep]: https://smallstep.com/docs +[step]: https://github.com/smallstep/cli +[step-ca]: https://github.com/smallstep/certificates ## Why sshutil? -The sshutil package depends solely on the Go `x/crypto` library. -Go's x/crypto/ssh package provides convenient support for both the [ssh wire protocol][rfc4253] and the [ssh authentication protocol][rfc4252]. +The sshutil package depends solely on the Go [`x/crypto`][crypto] module. +Go's [`x/crypto/ssh`][crypto-ssh] package provides convenient support for both the [ssh wire protocol][rfc4253] and the [ssh authentication protocol][rfc4252]. The authentication protocol implementation is scoped to single connections. A small, but tedious, amount of work is required to implement a full connection-tracking server. `sshutil` fills in the gap. +[crypto]: https://pkg.go.dev/golang.org/x/crypto +[crypto-ssh]: https://pkg.go.dev/golang.org/x/crypto/ssh [rfc4252]: https://tools.ietf.org/html/rfc4252 [rfc4253]: https://tools.ietf.org/html/rfc4253 -- GitLab