The lftp-wrapper Reference Manual

This is the lftp-wrapper Reference Manual, version 0.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Jul 13 20:48:47 2025 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 lftp-wrapper

Wrapper around the lftp program, used for a SFTP client.

Author

vindarel

Home Page

https://github.com/vindarel/lftp-wrapper

Source Control

(GIT https://github.com/vindarel/lftp-wrapper/)

Bug Tracker

https://github.com/vindarel/lftp-wrapper/issues/

License

WTFPL

Version

0.1

Dependencies
  • secret-values (system).
  • str (system).
  • termp (system).
  • trivial-types (system).
  • log4cl (system).
Source

lftp-wrapper.asd.

Child Component

src (module).


3 Modules

Modules are listed depth-first from the system components tree.


3.1 lftp-wrapper/src

Source

lftp-wrapper.asd.

Parent Component

lftp-wrapper (system).

Child Component

lftp.lisp (file).


4 Files

Files are sorted by type and then listed depth-first from the systems components trees.


4.1 Lisp


4.1.1 lftp-wrapper/lftp-wrapper.asd

Source

lftp-wrapper.asd.

Parent Component

lftp-wrapper (system).

ASDF Systems

lftp-wrapper.


4.1.2 lftp-wrapper/src/lftp.lisp

Source

lftp-wrapper.asd.

Parent Component

src (module).

Packages

lftp-wrapper.

Public Interface
Internals

5 Packages

Packages are listed by definition order.


5.1 lftp-wrapper

Source

lftp.lisp.

Use List

common-lisp.

Public Interface
Internals

6 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


6.1 Public Interface


6.1.1 Special variables

Special Variable: *devel*

If t, get FTP interactive errors

Package

lftp-wrapper.

Source

lftp.lisp.

Special Variable: *dry-run*

If T, don’t send the SFTP command.

Package

lftp-wrapper.

Source

lftp.lisp.

Special Variable: *ftp-hostname*

(s)FTP hostname to connect to (string).

Package

lftp-wrapper.

Source

lftp.lisp.

Special Variable: *ftp-login*

(s)FTP login (string).

Package

lftp-wrapper.

Source

lftp.lisp.

Special Variable: *show-passwords*

If non nil, print passwords in clear text on stdout when debugging commands.

Package

lftp-wrapper.

Source

lftp.lisp.

Special Variable: *version*
Package

lftp-wrapper.

Source

lftp.lisp.


6.1.2 Ordinary functions

Function: make-profile (&key login server port password)

Create a PROFILE instance by searching for credentials in environment variables or files.

The password is also read, but concealed.

Package

lftp-wrapper.

Source

lftp.lisp.


6.1.3 Generic functions

Generic Function: build-command (profile command &key dry-run)

run lftp for the sftp protocol.

If DRY-RUN is non nil, include the password in clear text and really run the command.

Currently done for PUT commands.

Package

lftp-wrapper.

Source

lftp.lisp.

Methods
Method: build-command (profile command &key dry-run)
Method: build-command (profile (command put) &key dry-run)
Generic Reader: hostname (object)
Package

lftp-wrapper.

Methods
Reader Method: hostname ((profile profile))

automatically generated reader method

Source

lftp.lisp.

Target Slot

hostname.

Generic Writer: (setf hostname) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf hostname) ((profile profile))

automatically generated writer method

Source

lftp.lisp.

Target Slot

hostname.

Generic Reader: login (object)
Package

lftp-wrapper.

Methods
Reader Method: login ((profile profile))

automatically generated reader method

Source

lftp.lisp.

Target Slot

login.

Generic Writer: (setf login) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf login) ((profile profile))

automatically generated writer method

Source

lftp.lisp.

Target Slot

login.

Generic Function: make-profile-from-plist (plist &key protocol)

Create a PROFILE instance with slots taken from PLIST. PLIST has the keys :server, :port, :login, :password etc.

Package

lftp-wrapper.

Source

lftp.lisp.

Methods
Method: make-profile-from-plist (plist &key protocol)
Generic Reader: password (object)
Generic Writer: (setf password) (object)
Package

lftp-wrapper.

Methods
Reader Method: password ((profile profile))
Writer Method: (setf password) ((profile profile))

The password is concealed. To see it, call ‘show-password’ on a profile.

Source

lftp.lisp.

Target Slot

password.

Generic Reader: port (object)
Package

lftp-wrapper.

Methods
Reader Method: port ((profile profile))

automatically generated reader method

Source

lftp.lisp.

Target Slot

port.

Generic Writer: (setf port) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf port) ((profile profile))

automatically generated writer method

Source

lftp.lisp.

Target Slot

port.

Generic Function: print-password (p &key stream)
Package

lftp-wrapper.

Methods
Method: print-password ((p profile) &key stream)

Print the password, revealed.

Source

lftp.lisp.

Generic Function: run (profile command &key dry-run)

Run COMMAND, using the login credentials in PROFILE.

If the output is:

NIL
NIL
0

then the command went fine.

Implemented to PUT files with sftp.

If *dry-run* is t, don’t actually run the LFTP command.

If *devel* is t, handle any error and re-signal it, so the developper gets the interactive debugger. When *devel* is NIL (the default), the error is logged on stderr.

Package

lftp-wrapper.

Source

lftp.lisp.

Methods
Method: run ((profile profile) command &key dry-run)
Generic Reader: server (object)
Package

lftp-wrapper.

Methods
Reader Method: server ((profile profile))

automatically generated reader method

Source

lftp.lisp.

Target Slot

server.

Generic Writer: (setf server) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf server) ((profile profile))

automatically generated writer method

Source

lftp.lisp.

Target Slot

server.


6.1.4 Standalone methods

Method: print-object ((o command) stream)
Source

lftp.lisp.

Method: print-object ((o put) stream)
Source

lftp.lisp.

Method: print-object ((p profile) stream)
Source

lftp.lisp.


6.1.5 Classes

Class: command
Package

lftp-wrapper.

Source

lftp.lisp.

Direct subclasses

put.

Direct methods

print-object.

Class: profile

LFTP profile.

Package

lftp-wrapper.

Source

lftp.lisp.

Direct subclasses

sftp-profile.

Direct methods
Direct slots
Slot: protocol
Initargs

:protocol

Readers

protocol.

Writers

(setf protocol).

Slot: hostname
Initform

lftp-wrapper:*ftp-hostname*

Initargs

:hostname

Readers

hostname.

Writers

(setf hostname).

Slot: login
Initform

lftp-wrapper:*ftp-login*

Initargs

:login

Readers

login.

Writers

(setf login).

Slot: port
Initargs

:port

Readers

port.

Writers

(setf port).

Slot: server
Initform

""

Initargs

:server

Readers

server.

Writers

(setf server).

Slot: password

The password is concealed. To see it, call ‘show-password’ on a profile.

Initform

""

Initargs

:password

Readers

password.

Writers

(setf password).

Class: put
Package

lftp-wrapper.

Source

lftp.lisp.

Direct superclasses

command.

Direct methods
Direct slots
Slot: cd

If set, CD into a directory on the target before PUT-ing or getting files.

Initargs

:cd

Readers

cd.

Writers

(setf cd).

Slot: local-filename

The filename on the host filesystem to send.

Initform

""

Initargs

:local-filename

Readers

local-filename.

Writers

(setf local-filename).

Class: sftp-profile
Package

lftp-wrapper.

Source

lftp.lisp.

Direct superclasses

profile.

Direct Default Initargs
InitargValue
:protocolsftp

6.2 Internals


6.2.1 Ordinary functions

Function: error-or-quit (msg)
Package

lftp-wrapper.

Source

lftp.lisp.

Function: find-ftp-login ()
Package

lftp-wrapper.

Source

lftp.lisp.

Function: find-ftp-password ()
Package

lftp-wrapper.

Source

lftp.lisp.

Function: find-ftp-port ()
Package

lftp-wrapper.

Source

lftp.lisp.

Function: find-ftp-server ()
Package

lftp-wrapper.

Source

lftp.lisp.


6.2.2 Generic functions

Generic Reader: cd (object)
Generic Writer: (setf cd) (object)
Package

lftp-wrapper.

Methods
Reader Method: cd ((put put))
Writer Method: (setf cd) ((put put))

If set, CD into a directory on the target before PUT-ing or getting files.

Source

lftp.lisp.

Target Slot

cd.

Generic Function: local-filename (filename)

Return a path where FILENAME is located on the filesystem. By default, use FILENAME.

Package

lftp-wrapper.

Source

lftp.lisp.

Methods
Reader Method: local-filename ((put put))

The filename on the host filesystem to send.

Target Slot

local-filename.

Method: local-filename (filename)
Generic Writer: (setf local-filename) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf local-filename) ((put put))

The filename on the host filesystem to send.

Source

lftp.lisp.

Target Slot

local-filename.

Generic Reader: protocol (object)
Package

lftp-wrapper.

Methods
Reader Method: protocol ((profile profile))

automatically generated reader method

Source

lftp.lisp.

Target Slot

protocol.

Generic Writer: (setf protocol) (object)
Package

lftp-wrapper.

Methods
Writer Method: (setf protocol) ((profile profile))

automatically generated writer method

Source

lftp.lisp.

Target Slot

protocol.


Appendix A Indexes


A.1 Concepts


A.2 Functions

Jump to:   (  
B   C   E   F   G   H   L   M   P   R   S  
Index Entry  Section

(
(setf cd): Private generic functions
(setf cd): Private generic functions
(setf hostname): Public generic functions
(setf hostname): Public generic functions
(setf local-filename): Private generic functions
(setf local-filename): Private generic functions
(setf login): Public generic functions
(setf login): Public generic functions
(setf password): Public generic functions
(setf password): Public generic functions
(setf port): Public generic functions
(setf port): Public generic functions
(setf protocol): Private generic functions
(setf protocol): Private generic functions
(setf server): Public generic functions
(setf server): Public generic functions

B
build-command: Public generic functions
build-command: Public generic functions
build-command: Public generic functions

C
cd: Private generic functions
cd: Private generic functions

E
error-or-quit: Private ordinary functions

F
find-ftp-login: Private ordinary functions
find-ftp-password: Private ordinary functions
find-ftp-port: Private ordinary functions
find-ftp-server: Private ordinary functions
Function, error-or-quit: Private ordinary functions
Function, find-ftp-login: Private ordinary functions
Function, find-ftp-password: Private ordinary functions
Function, find-ftp-port: Private ordinary functions
Function, find-ftp-server: Private ordinary functions
Function, make-profile: Public ordinary functions

G
Generic Function, (setf cd): Private generic functions
Generic Function, (setf hostname): Public generic functions
Generic Function, (setf local-filename): Private generic functions
Generic Function, (setf login): Public generic functions
Generic Function, (setf password): Public generic functions
Generic Function, (setf port): Public generic functions
Generic Function, (setf protocol): Private generic functions
Generic Function, (setf server): Public generic functions
Generic Function, build-command: Public generic functions
Generic Function, cd: Private generic functions
Generic Function, hostname: Public generic functions
Generic Function, local-filename: Private generic functions
Generic Function, login: Public generic functions
Generic Function, make-profile-from-plist: Public generic functions
Generic Function, password: Public generic functions
Generic Function, port: Public generic functions
Generic Function, print-password: Public generic functions
Generic Function, protocol: Private generic functions
Generic Function, run: Public generic functions
Generic Function, server: Public generic functions

H
hostname: Public generic functions
hostname: Public generic functions

L
local-filename: Private generic functions
local-filename: Private generic functions
local-filename: Private generic functions
login: Public generic functions
login: Public generic functions

M
make-profile: Public ordinary functions
make-profile-from-plist: Public generic functions
make-profile-from-plist: Public generic functions
Method, (setf cd): Private generic functions
Method, (setf hostname): Public generic functions
Method, (setf local-filename): Private generic functions
Method, (setf login): Public generic functions
Method, (setf password): Public generic functions
Method, (setf port): Public generic functions
Method, (setf protocol): Private generic functions
Method, (setf server): Public generic functions
Method, build-command: Public generic functions
Method, build-command: Public generic functions
Method, cd: Private generic functions
Method, hostname: Public generic functions
Method, local-filename: Private generic functions
Method, local-filename: Private generic functions
Method, login: Public generic functions
Method, make-profile-from-plist: Public generic functions
Method, password: Public generic functions
Method, port: Public generic functions
Method, print-object: Public standalone methods
Method, print-object: Public standalone methods
Method, print-object: Public standalone methods
Method, print-password: Public generic functions
Method, protocol: Private generic functions
Method, run: Public generic functions
Method, server: Public generic functions

P
password: Public generic functions
password: Public generic functions
port: Public generic functions
port: Public generic functions
print-object: Public standalone methods
print-object: Public standalone methods
print-object: Public standalone methods
print-password: Public generic functions
print-password: Public generic functions
protocol: Private generic functions
protocol: Private generic functions

R
run: Public generic functions
run: Public generic functions

S
server: Public generic functions
server: Public generic functions