modulepackage
0.0.0-20200810150023-f8fe831cf830
Repository: https://github.com/gopherj/go-scp.git
Documentation: pkg.go.dev
# README
Copy files over SCP with Go
This package makes it very easy to copy files over scp in Go. It uses the golang.org/x/crypto/ssh package to establish a secure connection to a remote server in order to copy the files via the SCP protocol.
Example usage
package main
import (
"fmt"
scp "github.com/bramvdbogaerde/go-scp"
"github.com/bramvdbogaerde/go-scp/auth"
"golang.org/x/crypto/ssh"
"os"
)
func main() {
// Use SSH key authentication from the auth package
// we ignore the host key in this example, please change this if you use this library
clientConfig, _ := auth.PrivateKey("username", "/path/to/rsa/key", ssh.InsecureIgnoreHostKey())
// For other authentication methods see ssh.ClientConfig and ssh.AuthMethod
// Create a new SCP client
client := scp.NewClient("example.com:22", &clientConfig)
// Connect to the remote server
err := client.Connect()
if err != nil {
fmt.Println("Couldn't establish a connection to the remote server ", err)
return
}
// Open a file
f, _ := os.Open("/path/to/local/file")
// Close client connection after the file has been copied
defer client.Close()
// Close the file after it has been copied
defer f.Close()
// Finaly, copy the file over
// Usage: CopyFile(fileReader, remotePath, permission)
err = client.CopyFile(f, "/home/server/test.txt", "0655")
if err != nil {
fmt.Println("Error while copying file ", err)
}
}
License
This library is licensed under the Mozilla Public License 2.0.
A copy of the license is provided in the LICENSE.txt
file.
Copyright (c) 2020 Bram Vandenbogaerde
# Packages
Copyright (c) 2020 Bram Vandenbogaerde
* You may use, distribute or modify this code under the
* terms of the Mozilla Public License 2.0, which is distributed
* along with the source code.
# Functions
Returns a new scp.Client with provided host and ssh.clientConfig It has a default timeout of one minute.
Returns a new scp.Client with provides host, ssh.ClientConfig and timeout.
Creates a new client configurer.
Reads from the given reader (assuming it is the output of the remote) and parses it into a Response structure.
# Structs
No description provided by the author
A struct containing all the configuration options used by an scp client.
There are tree types of responses that the remote can send back: ok, warning and error
The difference between warning and error is that the connection is not closed by the remote, however, a warning can indicate a file transfer failure (such as invalid destination directory) and such be handled as such.