| 1 |
ftpcopyinstall(8) ftpcopyinstall(8) |
| 2 |
|
| 3 |
|
| 4 |
|
| 5 |
How to install ftpcopy |
| 6 |
This document describes how to download, compile, test and |
| 7 |
install ftpcopy. |
| 8 |
|
| 9 |
|
| 10 |
System requirements: |
| 11 |
The ftpcopy package is meant to run under UNIX and |
| 12 |
-lookalikes. |
| 13 |
|
| 14 |
If you want to run the self check you'll have to install a |
| 15 |
few additional software packages (see below), but they |
| 16 |
aren't needed to run ftpcopy. |
| 17 |
|
| 18 |
|
| 19 |
|
| 20 |
Create a /package directory: |
| 21 |
$ mkdir /package |
| 22 |
$ chmod 1755 /package |
| 23 |
$ cd /package |
| 24 |
You may use another directory. No program in the ftpcopy |
| 25 |
package cares where it is installed. /package is |
| 26 |
recommended. |
| 27 |
|
| 28 |
The latest published ftpcopy package is: |
| 29 |
|
| 30 |
http://www.ohse.de/uwe/ftpcopy/ftpcopy-0.6.7.tar.gz |
| 31 |
|
| 32 |
You can alternatively download it through FTP: |
| 33 |
|
| 34 |
ftp://www.ohse.de/uwe/ftpcopy/ftpcopy-0.6.7.tar.gz |
| 35 |
|
| 36 |
|
| 37 |
|
| 38 |
Unpack the package: |
| 39 |
$ gunzip ftpcopy-0.6.7.tar.gz |
| 40 |
$ tar -xpf ftpcopy-0.6.7.tar |
| 41 |
$ rm ftpcopy-0.6.7.tar |
| 42 |
$ cd web/ftpcopy-0.6.7 |
| 43 |
|
| 44 |
|
| 45 |
Compile and install the programs: |
| 46 |
$ package/install |
| 47 |
|
| 48 |
|
| 49 |
Where commands and documentation are installed: |
| 50 |
By default the binaries are installed in |
| 51 |
/package/web/ftpcopy-0.6.7/commmand. (replace /package/ |
| 52 |
by the directory where you you unpacked the ftpcopy |
| 53 |
distribution in). Symbolic links to the commands are |
| 54 |
created in /command/ and, for compatibility reasons, in |
| 55 |
/usr/local/bin. |
| 56 |
Manual pages are installed in |
| 57 |
/package/web/ftpcopy-0.6.7/doc. Symbolic links to the |
| 58 |
manual pages are created under /usr/local/man. |
| 59 |
|
| 60 |
If you don't like this then: |
| 61 |
$ package/compile && package/check |
| 62 |
$ cp command/* /whereever/you/want/bin |
| 63 |
$ cp doc/* /whereever/you/want/doc |
| 64 |
|
| 65 |
|
| 66 |
|
| 67 |
Self check: |
| 68 |
compile/install (or compile/check) try to run some |
| 69 |
automated tests is a few additional software packages are |
| 70 |
available. If these tests fail the software will not be |
| 71 |
install. If some or all of the needed packages are not |
| 72 |
found in $PATH then ftpcopy will be installed. |
| 73 |
|
| 74 |
|
| 75 |
|
| 76 |
Packages needed to run the self test: |
| 77 |
publicfile |
| 78 |
The self check needs a ftp server. The ftp server |
| 79 |
included in the publicfile package doesn't need any |
| 80 |
special entries in /etc/passwd and is highly |
| 81 |
secure. |
| 82 |
|
| 83 |
The self check expects to find the publicfile ftpd |
| 84 |
in /usr/local/publicfile/bin/ftpd. If you, for any |
| 85 |
reason, want to run the test manually, and |
| 86 |
publicfile is installed somewhere else, for example |
| 87 |
in /usr/bin, you may run |
| 88 |
make PUBLICFILE_FTPD=/usr/bin/ftpd check |
| 89 |
in the compile directory. |
| 90 |
|
| 91 |
See http://cr.yp.to/publicfile.html. |
| 92 |
|
| 93 |
|
| 94 |
ucspi-tcp |
| 95 |
The tcpserver program is needed to open a socket |
| 96 |
(127.0.0.1, port 50000) and to run the publicfile |
| 97 |
ftp server program. |
| 98 |
|
| 99 |
See http://cr.yp.to/ucspi-tcp.html. |
| 100 |
|
| 101 |
|
| 102 |
daemontools |
| 103 |
The supervise program is used to start and stop |
| 104 |
tcpserver. |
| 105 |
|
| 106 |
See http://cr.yp.to/daemontools.html. |
| 107 |
|
| 108 |
The tests take some time. Things are fine if they do not |
| 109 |
print anything. |
| 110 |
|
| 111 |
|
| 112 |
How to report success: (not mandatory) |
| 113 |
$ mail [email protected] <compile/auto-systype |
| 114 |
|
| 115 |
Please do not send this email if the self-check failed. |
| 116 |
Send an problem report to the mailing list instead. |
| 117 |
|
| 118 |
|
| 119 |
|
| 120 |
Cleaning up: |
| 121 |
If you are short on disk space you may remove the compile |
| 122 |
and src directories: |
| 123 |
$ rm -rf compile src |
| 124 |
|
| 125 |
|
| 126 |
|
| 127 |
Mailing list: |
| 128 |
To subscribe to the ftpcopy mailing list send a mail to |
| 129 |
[email protected]. The content is ignored. |
| 130 |
|
| 131 |
You do not need to subscribe to the mailing list, it is an |
| 132 |
open one. But, if you are not subscribe, make sure you |
| 133 |
mention this in the mail. |
| 134 |
|
| 135 |
Please include the ftpcopy version number, the operating |
| 136 |
system and it's version and any possible relevant output |
| 137 |
of the failing program. Please include compile/auto- |
| 138 |
systype in your posting. |
| 139 |
|
| 140 |
If your system is a GNU/Linux one then please include name |
| 141 |
and version of your distribution and your C library |
| 142 |
version number (as printed by ldd --version). |
| 143 |
|
| 144 |
|
| 145 |
|
| 146 |
SEE ALSO |
| 147 |
The homepage may be more up-to-date, see |
| 148 |
http://www.ohse.de/uwe/ftpcopy.html. |
| 149 |
|
| 150 |
|
| 151 |
|
| 152 |
ftpcopy 0.6.7 ftpcopyinstall(8) |