Categorygithub.com/mikkeloscar/sshconfig
modulepackage
0.1.1
Repository: https://github.com/mikkeloscar/sshconfig.git
Documentation: pkg.go.dev

# README

OpenSSH config parser for golang

Go Reference Go Report Card Coverage Status

Parses the config usually found in ~/.ssh/config or /etc/ssh/ssh_config. Only Host, HostName, User, Port, IdentityFile, HostKeyAlgorithms, ProxyCommand, LocalForward, RemoteForward and DynamicForward is implemented at this point.

OpenSSH Reference.

Usage

Example usage

package main

import (
    "fmt"

    "github.com/mikkeloscar/sshconfig"
)

func main() {
    hosts, err := ParseSSHConfig("/path/to/ssh_config")
    if err != nil {
        fmt.Println(err)
    }

    for _, host := range hosts {
       fmt.Printf("Hostname: %s", host.HostName)
    }
}

LICENSE

Copyright (C) 2022 Mikkel Oscar Lyderik Larsen & Contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

# Functions

MustParse must parse the SSH config given by path or it will panic.
MustParseSSHConfig must parse the SSH config given by path or it will panic Deprecated: Use MustParse instead.
NewDynamicForward returns DForward object parsed from DynamicForward string.
NewForward returns Forward object parsed from LocalForward or RemoteForward string.
Parse parses a SSH config given by path.
ParseFS parses a SSH config given by path contained in fsys.
ParseSSHConfig parses a SSH config given by path.

# Structs

DynamicForward defines a single dynamic port forward entry.
Forward defines a single port forward entry.
SSHHost defines a single host entry in a ssh config.