ftp: github.com/jlaffaye/ftp Index | Files

package ftp

import "github.com/jlaffaye/ftp"

Package ftp implements a FTP client as described in RFC 959.

A textproto.Error is returned for errors at the protocol level.

Index

Package Files

ftp.go parse.go scanner.go status.go

Constants

const (
    StatusInitiating    = 100
    StatusRestartMarker = 110
    StatusReadyMinute   = 120
    StatusAlreadyOpen   = 125
    StatusAboutToSend   = 150

    StatusCommandOK             = 200
    StatusCommandNotImplemented = 202
    StatusSystem                = 211
    StatusDirectory             = 212
    StatusFile                  = 213
    StatusHelp                  = 214
    StatusName                  = 215
    StatusReady                 = 220
    StatusClosing               = 221
    StatusDataConnectionOpen    = 225
    StatusClosingDataConnection = 226
    StatusPassiveMode           = 227
    StatusLongPassiveMode       = 228
    StatusExtendedPassiveMode   = 229
    StatusLoggedIn              = 230
    StatusLoggedOut             = 231
    StatusLogoutAck             = 232
    StatusRequestedFileActionOK = 250
    StatusPathCreated           = 257

    StatusUserOK             = 331
    StatusLoginNeedAccount   = 332
    StatusRequestFilePending = 350

    StatusNotAvailable             = 421
    StatusCanNotOpenDataConnection = 425
    StatusTransfertAborted         = 426
    StatusInvalidCredentials       = 430
    StatusHostUnavailable          = 434
    StatusFileActionIgnored        = 450
    StatusActionAborted            = 451
    Status452                      = 452

    StatusBadCommand              = 500
    StatusBadArguments            = 501
    StatusNotImplemented          = 502
    StatusBadSequence             = 503
    StatusNotImplementedParameter = 504
    StatusNotLoggedIn             = 530
    StatusStorNeedAccount         = 532
    StatusFileUnavailable         = 550
    StatusPageTypeUnknown         = 551
    StatusExceededStorage         = 552
    StatusBadFileName             = 553
)

FTP status codes, defined in RFC 959

type Entry Uses

type Entry struct {
    Name string
    Type EntryType
    Size uint64
    Time time.Time
}

Entry describes a file and is returned by List().

type EntryType Uses

type EntryType int

EntryType describes the different types of an Entry.

const (
    EntryTypeFile EntryType = iota
    EntryTypeFolder
    EntryTypeLink
)

The differents types of an Entry

type Response Uses

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

Response represents a data-connection

func (*Response) Close Uses

func (r *Response) Close() error

Close implements the io.Closer interface on a FTP data connection. After the first call, Close will do nothing and return nil.

func (*Response) Read Uses

func (r *Response) Read(buf []byte) (int, error)

Read implements the io.Reader interface on a FTP data connection.

func (*Response) SetDeadline Uses

func (r *Response) SetDeadline(t time.Time) error

SetDeadline sets the deadlines associated with the connection.

type ServerConn Uses

type ServerConn struct {
    // Do not use EPSV mode
    DisableEPSV bool
    // contains filtered or unexported fields
}

ServerConn represents the connection to a remote FTP server. It should be protected from concurrent accesses.

func Connect Uses

func Connect(addr string) (*ServerConn, error)

Connect is an alias to Dial, for backward compatibility

func Dial Uses

func Dial(addr string) (*ServerConn, error)

Dial is like DialTimeout with no timeout

func DialTimeout Uses

func DialTimeout(addr string, timeout time.Duration) (*ServerConn, error)

DialTimeout initializes the connection to the specified ftp server address.

It is generally followed by a call to Login() as most FTP commands require an authenticated user.

func (*ServerConn) ChangeDir Uses

func (c *ServerConn) ChangeDir(path string) error

ChangeDir issues a CWD FTP command, which changes the current directory to the specified path.

func (*ServerConn) ChangeDirToParent Uses

func (c *ServerConn) ChangeDirToParent() error

ChangeDirToParent issues a CDUP FTP command, which changes the current directory to the parent directory. This is similar to a call to ChangeDir with a path set to "..".

func (*ServerConn) CurrentDir Uses

func (c *ServerConn) CurrentDir() (string, error)

CurrentDir issues a PWD FTP command, which Returns the path of the current directory.

func (*ServerConn) Delete Uses

func (c *ServerConn) Delete(path string) error

Delete issues a DELE FTP command to delete the specified file from the remote FTP server.

func (*ServerConn) FileSize Uses

func (c *ServerConn) FileSize(path string) (int64, error)

FileSize issues a SIZE FTP command, which Returns the size of the file

func (*ServerConn) List Uses

func (c *ServerConn) List(path string) (entries []*Entry, err error)

List issues a LIST FTP command.

func (*ServerConn) Login Uses

func (c *ServerConn) Login(user, password string) error

Login authenticates the client with specified user and password.

"anonymous"/"anonymous" is a common user/password scheme for FTP servers that allows anonymous read-only accounts.

func (*ServerConn) Logout Uses

func (c *ServerConn) Logout() error

Logout issues a REIN FTP command to logout the current user.

func (*ServerConn) MakeDir Uses

func (c *ServerConn) MakeDir(path string) error

MakeDir issues a MKD FTP command to create the specified directory on the remote FTP server.

func (*ServerConn) NameList Uses

func (c *ServerConn) NameList(path string) (entries []string, err error)

NameList issues an NLST FTP command.

func (*ServerConn) NoOp Uses

func (c *ServerConn) NoOp() error

NoOp issues a NOOP FTP command. NOOP has no effects and is usually used to prevent the remote FTP server to close the otherwise idle connection.

func (*ServerConn) Quit Uses

func (c *ServerConn) Quit() error

Quit issues a QUIT FTP command to properly close the connection from the remote FTP server.

func (*ServerConn) RemoveDir Uses

func (c *ServerConn) RemoveDir(path string) error

RemoveDir issues a RMD FTP command to remove the specified directory from the remote FTP server.

func (*ServerConn) RemoveDirRecur Uses

func (c *ServerConn) RemoveDirRecur(path string) error

RemoveDirRecur deletes a non-empty folder recursively using RemoveDir and Delete

func (*ServerConn) Rename Uses

func (c *ServerConn) Rename(from, to string) error

Rename renames a file on the remote FTP server.

func (*ServerConn) Retr Uses

func (c *ServerConn) Retr(path string) (*Response, error)

Retr issues a RETR FTP command to fetch the specified file from the remote FTP server.

The returned ReadCloser must be closed to cleanup the FTP data connection.

func (*ServerConn) RetrFrom Uses

func (c *ServerConn) RetrFrom(path string, offset uint64) (*Response, error)

RetrFrom issues a RETR FTP command to fetch the specified file from the remote FTP server, the server will not send the offset first bytes of the file.

The returned ReadCloser must be closed to cleanup the FTP data connection.

func (*ServerConn) Stor Uses

func (c *ServerConn) Stor(path string, r io.Reader) error

Stor issues a STOR FTP command to store a file to the remote FTP server. Stor creates the specified file with the content of the io.Reader.

Hint: io.Pipe() can be used if an io.Writer is required.

func (*ServerConn) StorFrom Uses

func (c *ServerConn) StorFrom(path string, r io.Reader, offset uint64) error

StorFrom issues a STOR FTP command to store a file to the remote FTP server. Stor creates the specified file with the content of the io.Reader, writing on the server will start at the given file offset.

Hint: io.Pipe() can be used if an io.Writer is required.

Package ftp imports 8 packages (graph) and is imported by 27 packages. Updated 2017-11-07. Refresh now. Tools for package owners.