mirror of
https://github.com/go-gitea/gitea.git
synced 2024-08-26 06:07:28 +02:00
* update github.com/blevesearch/bleve v2.0.2 -> v2.0.3 * github.com/denisenkom/go-mssqldb v0.9.0 -> v0.10.0 * github.com/editorconfig/editorconfig-core-go v2.4.1 -> v2.4.2 * github.com/go-chi/cors v1.1.1 -> v1.2.0 * github.com/go-git/go-billy v5.0.0 -> v5.1.0 * github.com/go-git/go-git v5.2.0 -> v5.3.0 * github.com/go-ldap/ldap v3.2.4 -> v3.3.0 * github.com/go-redis/redis v8.6.0 -> v8.8.2 * github.com/go-sql-driver/mysql v1.5.0 -> v1.6.0 * github.com/go-swagger/go-swagger v0.26.1 -> v0.27.0 * github.com/lib/pq v1.9.0 -> v1.10.1 * github.com/mattn/go-sqlite3 v1.14.6 -> v1.14.7 * github.com/go-testfixtures/testfixtures v3.5.0 -> v3.6.0 * github.com/issue9/identicon v1.0.1 -> v1.2.0 * github.com/klauspost/compress v1.11.8 -> v1.12.1 * github.com/mgechev/revive v1.0.3 -> v1.0.6 * github.com/microcosm-cc/bluemonday v1.0.7 -> v1.0.8 * github.com/niklasfasching/go-org v1.4.0 -> v1.5.0 * github.com/olivere/elastic v7.0.22 -> v7.0.24 * github.com/pelletier/go-toml v1.8.1 -> v1.9.0 * github.com/prometheus/client_golang v1.9.0 -> v1.10.0 * github.com/xanzy/go-gitlab v0.44.0 -> v0.48.0 * github.com/yuin/goldmark v1.3.3 -> v1.3.5 * github.com/6543/go-version v1.2.4 -> v1.3.1 * do github.com/lib/pq v1.10.0 -> v1.10.1 again ...
90 lines
2.8 KiB
Markdown
Vendored
90 lines
2.8 KiB
Markdown
Vendored
# ssh_config
|
|
|
|
This is a Go parser for `ssh_config` files. Importantly, this parser attempts
|
|
to preserve comments in a given file, so you can manipulate a `ssh_config` file
|
|
from a program, if your heart desires.
|
|
|
|
It's designed to be used with the excellent
|
|
[x/crypto/ssh](https://golang.org/x/crypto/ssh) package, which handles SSH
|
|
negotiation but isn't very easy to configure.
|
|
|
|
The `ssh_config` `Get()` and `GetStrict()` functions will attempt to read values
|
|
from `$HOME/.ssh/config` and fall back to `/etc/ssh/ssh_config`. The first
|
|
argument is the host name to match on, and the second argument is the key you
|
|
want to retrieve.
|
|
|
|
```go
|
|
port := ssh_config.Get("myhost", "Port")
|
|
```
|
|
|
|
Certain directives can occur multiple times for a host (such as `IdentityFile`),
|
|
so you should use the `GetAll` or `GetAllStrict` directive to retrieve those
|
|
instead.
|
|
|
|
```go
|
|
files := ssh_config.GetAll("myhost", "IdentityFile")
|
|
```
|
|
|
|
You can also load a config file and read values from it.
|
|
|
|
```go
|
|
var config = `
|
|
Host *.test
|
|
Compression yes
|
|
`
|
|
|
|
cfg, err := ssh_config.Decode(strings.NewReader(config))
|
|
fmt.Println(cfg.Get("example.test", "Port"))
|
|
```
|
|
|
|
Some SSH arguments have default values - for example, the default value for
|
|
`KeyboardAuthentication` is `"yes"`. If you call Get(), and no value for the
|
|
given Host/keyword pair exists in the config, we'll return a default for the
|
|
keyword if one exists.
|
|
|
|
### Manipulating SSH config files
|
|
|
|
Here's how you can manipulate an SSH config file, and then write it back to
|
|
disk.
|
|
|
|
```go
|
|
f, _ := os.Open(filepath.Join(os.Getenv("HOME"), ".ssh", "config"))
|
|
cfg, _ := ssh_config.Decode(f)
|
|
for _, host := range cfg.Hosts {
|
|
fmt.Println("patterns:", host.Patterns)
|
|
for _, node := range host.Nodes {
|
|
// Manipulate the nodes as you see fit, or use a type switch to
|
|
// distinguish between Empty, KV, and Include nodes.
|
|
fmt.Println(node.String())
|
|
}
|
|
}
|
|
|
|
// Print the config to stdout:
|
|
fmt.Println(cfg.String())
|
|
```
|
|
|
|
## Spec compliance
|
|
|
|
Wherever possible we try to implement the specification as documented in
|
|
the `ssh_config` manpage. Unimplemented features should be present in the
|
|
[issues][issues] list.
|
|
|
|
Notably, the `Match` directive is currently unsupported.
|
|
|
|
[issues]: https://github.com/kevinburke/ssh_config/issues
|
|
|
|
## Errata
|
|
|
|
This is the second [comment-preserving configuration parser][blog] I've written, after
|
|
[an /etc/hosts parser][hostsfile]. Eventually, I will write one for every Linux
|
|
file format.
|
|
|
|
[blog]: https://kev.inburke.com/kevin/more-comment-preserving-configuration-parsers/
|
|
[hostsfile]: https://github.com/kevinburke/hostsfile
|
|
|
|
## Donating
|
|
|
|
Donations free up time to make improvements to the library, and respond to
|
|
bug reports. You can send donations via Paypal's "Send Money" feature to
|
|
kev@inburke.com. Donations are not tax deductible in the USA.
|