Subversion Repositories

?revision_form?Rev ?revision_input??revision_submit??revision_endform?

Rev 2 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 magnus 1
.\"                                      Hey, EMACS: -*- nroff -*-
2
.\" First parameter, NAME, should be all caps
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4
.\" other parameters are allowed: see man(7), man(1)
5
.TH LSFTP 1 "Aug 21 2002" lsftp "lsh manuals"
6
.\" Please adjust this date whenever revising the manpage.
7
.\"
8
.\" Some roff macros, for reference:
9
.\" .nh        disable hyphenation
10
.\" .hy        enable hyphenation
11
.\" .ad l      left justify
12
.\" .ad b      justify to both left and right margins
13
.\" .nf        disable filling
14
.\" .fi        enable filling
15
.\" .br        insert line break
16
.\" .sp <n>    insert n+1 empty lines
17
.\" for manpage-specific macros, see man(7)
18
.SH NAME
19
lsftp \- lsh's sftp client
20
.SH SYNOPSIS
21
.B lsftp
22
.RI [ transport-options ] [-- " command" ...]
23
.SH DESCRIPTION
24
This manual page documents briefly the
25
.B lsftp
26
command.
27
This manual page was written for the Debian distribution
28
because the original program does not have a manual page.
29
Instead, it has documentation in the GNU Info format; see below.
30
.PP
31
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
32
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
33
.\" respectively.
34
\fBlsftp\fP is a program that connects to a remote sftp server, and can be
35
used to upload download files \['a] la FTP. When invoked with no command arguments,
36
lsftp enters interactive mode, much like \fBftp (1)\fP. However, when the
37
\fI--\fP argument and subsequent commands are passed to lsftp, lsftp simply
38
executes those commands and exits.
39
.SH OPTIONS
40
This program follows the usual GNU command line syntax, with long
41
options starting with two dashes (`-').
42
A summary of options is included below.
43
For a complete description, see the Info files.
44
.TP
45
.B \-\-help
46
Show summary of options.
47
.TP
48
.B \-\-version
49
Show version of program.
50
.SH COMMANDS
51
.TP
52
.B cd \fIdirectory\fP
53
Change the current directory on the remote server to \fIdirectory\fP.
54
.TP
55
.B rm \fIfilespec\fP
56
Removes files or directories. To delete directories, the \-r option needs to be
57
specified. The rm command doesn't accept wildcards by default, to enable these
58
you must specify the \-g option.
59
.TP
60
.B delete
61
Alias for \fBrm\fP.
62
.TP
63
.B mkdir \fIdir\fP
64
Make directory \fIdir\fP.
65
.TP
66
.B about
67
Display information about lsftp.
68
.TP
69
.B help
70
Displays a list of commands.
71
.TP
72
.B ?
73
Alias for \fBhelp\fP.
74
.TP
75
.B longhelp
76
Displays the list of commands with detailed information about each command.
77
.TP
78
.B ls \fIfilespec\fP
79
List remote files and folders.
80
.TP
81
.B list
82
Alias for \fBls\fP.
83
.TP
84
.B dir
85
(Another) Alias for \fBls\fP.
86
.TP
87
.B pwd
88
Print the current working directory.
89
.TP
90
.B quit
91
Quit lsftp.
92
.TP
93
.B exit
94
Quit lsftp.
95
.TP
96
.B set [\fIvar=value\fP]
97
Sets or shows variables. Without an argument, \fIset\fP displays the current variable state. With
98
a \fIvar=value\fP argument, \fBset\fP sets the appropriate variable in the environment.
99
.TP
100
.B mail
101
Runs the \fBmail (1)\fP command.
102
.TP
103
.B umask [\fIvalue\fP]
104
Sets or displays the remote umask.
105
.TP
106
.B jobs
107
Prints information about currently running jobs.
108
.TP
109
.B open \fIsite\fP
110
Open a sftp connection to \fIsite\fP.
111
.TP
112
.B close
113
Close the current connection.
114
.TP
115
.B mv \fIold\-filename\fP \fInew\-filename\fP
116
Rename file \fIold\-filename\fP to \fInew\-filename\fP.
117
.TP
118
.B rename
119
Alias for \fBmv\fP.
120
.TP
121
.B ln \fIfile\fP \fIlink\fP
122
Make \fIlink\fP a symlink to \fIfile\fP.
123
.TP
124
.B get \fIremote\-file\fP
125
Retrieve \fIremote\-file\fP on the remote system to the local system.
126
.TP
127
.B put \fIlocal\-file\fP
128
Send \fIlocal\-file\fP on the local system to the remote system.
129
.TP
130
.B chown \fIuid\fP \fIfile\fP
131
Change the ownership of \fIfile\fP to be owned by the user represented by
132
\fIuid\fP.
133
.TP
134
.B chgrp \fIgid\fP \fIfile\fP
135
Change the group ownership of \fIfile\fP to be owned by the group represented by
136
\fIgid\fP.
137
.TP
138
.B lcd \fIdir\fP
139
Change the current local directory to \fIdir\fP.
140
.TP
141
.B lrm \fIfile\fP
142
Remove \fIfile\fP from the \fBlocal\fP system.
143
.TP
144
.B ldelete
145
Alias for \fBlrm\fP.
146
.TP
147
.B lls
148
List files on the local system.
149
.TP
150
.B llist
151
Alias for \fBlls\fP.
152
.TP
153
.B lpwd
154
Print the current local working directory.
155
.TP
156
.B ! \fIcommand\fP
157
Executes \fIcommand\fP in a shell on the local system.
158
.SH ENVIRONMENT
159
.TP
160
.B LSFTP_RSH
161
The program to use for the SSH tunnel. If the variable is not set, lsftp
162
defaults to using lshg.
163
.TP
164
.B LSFTP_BEFORE_ARGS
165
.TP
166
.B LSFTP_AFTER_ARGS
167
.SH SEE ALSO
168
.BR lshc (1),
169
.BR mail (1),
170
.BR lshd (8),
171
.BR lshg (8).
172
.BR
173
The programs are documented fully by
174
.IR "Lsh" ,
175
available via the Info system.
176
.SH AUTHOR
177
This manual page was written by Timshel Knoll <timshel@debian.org>,
178
for the Debian GNU/Linux system (but may be used by others).