sftp

Documentation

Index

• Constants
• type Handler
  • func NewHandler(sc *ssh.ServerConn, fs *filesystem.Filesystem) *Handler
  • func (h *Handler) Filecmd(request *sftp.Request) error
  • func (h *Handler) Filelist(request *sftp.Request) (sftp.ListerAt, error)
  • func (h *Handler) Fileread(request *sftp.Request) (io.ReaderAt, error)
  • func (h *Handler) Filewrite(request *sftp.Request) (io.WriterAt, error)
  • func (h *Handler) Handlers() sftp.Handlers
• type ListerAt
  • func (l ListerAt) ListAt(f []os.FileInfo, offset int64) (int, error)
• type SFTPServer
  • func New(m *server.Manager) *SFTPServer
  • func (c *SFTPServer) AcceptInbound(conn net.Conn, config *ssh.ServerConfig)
  • func (c *SFTPServer) Run() error

Constants

const (
	PermissionFileRead        = "file.read"
	PermissionFileReadContent = "file.read-content"
	PermissionFileCreate      = "file.create"
	PermissionFileUpdate      = "file.update"
	PermissionFileDelete      = "file.delete"
)

const (
	// Extends the default SFTP server to return a quota exceeded error to the client.
	//
	// @see https://tools.ietf.org/id/draft-ietf-secsh-filexfer-13.txt
	ErrSSHQuotaExceeded = fxerr(15)
)

Types

type Handler

type Handler struct {
	// contains filtered or unexported fields
}

func NewHandler

func NewHandler(sc *ssh.ServerConn, fs *filesystem.Filesystem) *Handler

Returns a new connection handler for the SFTP server. This allows a given user to access the underlying filesystem.

func (*Handler) Filecmd

func (h *Handler) Filecmd(request *sftp.Request) error

Filecmd hander for basic SFTP system calls related to files, but not anything to do with reading or writing to those files.

func (*Handler) Filelist

func (h *Handler) Filelist(request *sftp.Request) (sftp.ListerAt, error)

Filelist is the handler for SFTP filesystem list calls. This will handle calls to list the contents of a directory as well as perform file/folder stat calls.

func (*Handler) Fileread

func (h *Handler) Fileread(request *sftp.Request) (io.ReaderAt, error)

Fileread creates a reader for a file on the system and returns the reader back.

func (*Handler) Filewrite

func (h *Handler) Filewrite(request *sftp.Request) (io.WriterAt, error)

Filewrite handles the write actions for a file on the system.

func (*Handler) Handlers

func (h *Handler) Handlers() sftp.Handlers

Returns the sftp.Handlers for this struct.

type ListerAt

type ListerAt []os.FileInfo

func (ListerAt) ListAt

func (l ListerAt) ListAt(f []os.FileInfo, offset int64) (int, error)

Returns the number of entries copied and an io.EOF error if we made it to the end of the file list. Take a look at the pkg/sftp godoc for more information about how this function should work.

type SFTPServer

type SFTPServer struct {
	BasePath string
	ReadOnly bool
	Listen   string
	// contains filtered or unexported fields
}

func New

func New(m *server.Manager) *SFTPServer

func (*SFTPServer) AcceptInbound

func (c *SFTPServer) AcceptInbound(conn net.Conn, config *ssh.ServerConfig)

Handles an inbound connection to the instance and determines if we should serve the request or not.

func (*SFTPServer) Run

func (c *SFTPServer) Run() error

Starts the SFTP server and add a persistent listener to handle inbound SFTP connections.