mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-26 16:18:31 +00:00
Now that its only consumer is gone (sysinstall), remove libftpio as well.
This commit is contained in:
Nathan Whitehorn
parent
f8a0d2f658
commit
b2e855ac7a
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=225952
@ -39,7 +39,18 @@
|
||||
# done
|
||||
|
||||
# 20110930: sysinstall removed
|
||||
OLD_FILES+=usr/sbin/sysinstall usr/share/man/man8/sysinstall.8.gz
|
||||
OLD_FILES+=usr/sbin/sysinstall
|
||||
OLD_FILES+=usr/share/man/man8/sysinstall.8.gz
|
||||
OLD_FILES+=usr/lib/libftpio.a
|
||||
OLD_FILES+=usr/lib/libftpio.so
|
||||
OLD_LIBS+=usr/lib/libftpio.so.8
|
||||
.if ${TARGET_ARCH} == "amd64" || ${TARGET_ARCH} == "powerpc64"
|
||||
OLD_FILES+=usr/lib32/libftpio.a
|
||||
OLD_FILES+=usr/lib32/libftpio.so
|
||||
OLD_LIBS+=usr/lib32/libftpio.so.8
|
||||
.endif
|
||||
OLD_FILES+=usr/include/ftpio.h
|
||||
OLD_FILES+=usr/share/man/man3/ftpio.3.gz
|
||||
# 20110915: rename congestion control manpages
|
||||
OLD_FILES+=usr/share/man/man4/cc.4.gz
|
||||
OLD_FILES+=usr/share/man/man9/cc.9.gz
|
||||
|
||||
@ -70,7 +70,6 @@ SUBDIR= ${SUBDIR_ORDERED} \
|
||||
${_libefi} \
|
||||
libexpat \
|
||||
libfetch \
|
||||
libftpio \
|
||||
libgeom \
|
||||
${_libgpib} \
|
||||
${_libgssapi} \
|
||||
|
||||
@ -1,34 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
.include <bsd.own.mk>
|
||||
|
||||
LIB= ftpio
|
||||
SHLIB_MAJOR= 8
|
||||
|
||||
SRCS= ftpio.c ftperr.c
|
||||
INCS= ftpio.h
|
||||
CFLAGS+= -I${.CURDIR} -Wall
|
||||
MAN= ftpio.3
|
||||
CLEANFILES= ftperr.c
|
||||
|
||||
.if ${MK_INET6_SUPPORT} != "no"
|
||||
CFLAGS+= -DINET6
|
||||
.endif
|
||||
|
||||
WARNS?= 2
|
||||
|
||||
ftperr.c: ftp.errors
|
||||
@echo '#include <stdio.h>' > ${.TARGET}
|
||||
@echo '#include "ftpio.h"' >> ${.TARGET}
|
||||
@echo "struct ftperr ftpErrList[] = {" \ >> ${.TARGET}
|
||||
@cat ${.ALLSRC} \
|
||||
| grep -v ^# \
|
||||
| sort \
|
||||
| while read NUM STRING; do \
|
||||
echo " { $${NUM}, \"$${STRING}\" },"; \
|
||||
done >> ${.TARGET}
|
||||
@echo "};" >> ${.TARGET}
|
||||
@echo -n "int const ftpErrListLength = " >> ${.TARGET}
|
||||
@echo "sizeof(ftpErrList) / sizeof(*ftpErrList);" >> ${.TARGET}
|
||||
|
||||
.include <bsd.lib.mk>
|
||||
@ -1,45 +0,0 @@
|
||||
# $FreeBSD$
|
||||
#
|
||||
# This list is taken from RFC 959.
|
||||
# It probably needs a going over.
|
||||
#
|
||||
110 Restart marker reply
|
||||
120 Service ready in a few minutes
|
||||
125 Data connection already open; transfer starting
|
||||
150 File status okay; about to open data connection
|
||||
200 Command okay
|
||||
202 Command not implemented, superfluous at this site
|
||||
211 System status, or system help reply
|
||||
212 Directory status
|
||||
213 File status
|
||||
214 Help message
|
||||
215 Set system type
|
||||
220 Service ready for new user
|
||||
221 Service closing control connection
|
||||
225 Data connection open; no transfer in progress
|
||||
226 Requested file action successful
|
||||
227 Entering Passive Mode
|
||||
229 Entering Extended Passive Mode
|
||||
230 User logged in, proceed
|
||||
250 Requested file action okay, completed
|
||||
257 File/directory created
|
||||
331 User name okay, need password
|
||||
332 Need account for login
|
||||
350 Requested file action pending further information
|
||||
421 Service not available, closing control connection
|
||||
425 Can't open data connection
|
||||
426 Connection closed; transfer aborted
|
||||
450 File unavailable (e.g., file busy)
|
||||
451 Requested action aborted: local error in processing
|
||||
452 Insufficient storage space in system
|
||||
500 Syntax error, command unrecognized
|
||||
501 Syntax error in parameters or arguments
|
||||
502 Command not implemented
|
||||
503 Bad sequence of commands
|
||||
504 Command not implemented for that parameter
|
||||
530 Not logged in
|
||||
532 Need account for storing files
|
||||
550 File unavailable (e.g., file not found, no access)
|
||||
551 Requested action aborted. Page type unknown
|
||||
552 Exceeded storage allocation
|
||||
553 File name not allowed
|
||||
@ -1,260 +0,0 @@
|
||||
.\" Copyright (c) 1996 Jordan Hubbard <jkh@FreeBSD.org>
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY JORDAN HUBBARD ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd June 17, 1996
|
||||
.Dt FTPIO 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm ftpLogin ,
|
||||
.Nm ftpChdir ,
|
||||
.Nm ftpErrno ,
|
||||
.Nm ftpGetModtime ,
|
||||
.Nm ftpGetSize ,
|
||||
.Nm ftpGet ,
|
||||
.Nm ftpPut ,
|
||||
.Nm ftpBinary ,
|
||||
.Nm ftpPassive ,
|
||||
.Nm ftpVerbose ,
|
||||
.Nm ftpGetURL ,
|
||||
.Nm ftpPutURL ,
|
||||
.Nm ftpLoginAf ,
|
||||
.Nm ftpGetURLAf ,
|
||||
.Nm ftpPutURLAf
|
||||
.Nd FTPIO user library
|
||||
.Sh SYNOPSIS
|
||||
.In ftpio.h
|
||||
.Ft FILE *
|
||||
.Fn ftpLogin "char *host" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
|
||||
.Ft int
|
||||
.Fn ftpChdir "FILE *stream" "char *dirname"
|
||||
.Ft int
|
||||
.Fn ftpErrno "FILE *stream"
|
||||
.Ft const char *
|
||||
.Fn ftpErrString "int errno"
|
||||
.Ft time_t
|
||||
.Fn ftpGetModtime "FILE *stream" "char *file"
|
||||
.Ft off_t
|
||||
.Fn ftpGetSize "FILE *stream" "char *file"
|
||||
.Ft FILE *
|
||||
.Fn ftpGet "FILE *stream" "char *file" "off_t *seekto"
|
||||
.Ft FILE *
|
||||
.Fn ftpPut "FILE *stream" "char *file"
|
||||
.Ft int
|
||||
.Fn ftpAscii "FILE *stream"
|
||||
.Ft int
|
||||
.Fn ftpBinary "FILE *stream"
|
||||
.Ft int
|
||||
.Fn ftpPassive "FILE *stream" "int status"
|
||||
.Ft void
|
||||
.Fn ftpVerbose "FILE *stream" "int status"
|
||||
.Ft FILE *
|
||||
.Fn ftpGetURL "char *url" "char *user" "char *passwd" "int *retcode"
|
||||
.Ft FILE *
|
||||
.Fn ftpPutURL "char *url" "char *user" "char *passwd" "int *retcode"
|
||||
.Ft FILE *
|
||||
.Fn ftpLoginAf "char *host" "int af" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
|
||||
.Ft FILE *
|
||||
.Fn ftpGetURLAf "char *url" "int af" "char *user" "char *passwd" "int *retcode"
|
||||
.Ft FILE *
|
||||
.Fn ftpPutURLAf "char *url" "int af" "char *user" "char *passwd" "int *retcode"
|
||||
.Sh DESCRIPTION
|
||||
These functions implement a high-level library for managing FTP connections.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpLogin
|
||||
function attempts to log in using the supplied
|
||||
.Fa user ,
|
||||
.Fa passwd ,
|
||||
.Fa ftp_port
|
||||
(if passed as 0,
|
||||
.Fa ftp_port
|
||||
defaults to the standard ftp port of 21) and
|
||||
.Fa verbose
|
||||
fields.
|
||||
If it is successful, a
|
||||
standard stream descriptor is returned which should be passed to
|
||||
subsequent FTP operations.
|
||||
On failure, NULL is returned and
|
||||
.Fa retcode
|
||||
will have the error code returned by the foreign server.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpChdir
|
||||
function attempts to issue a server CD command to the directory named in
|
||||
.Fa dir .
|
||||
On success, zero is returned.
|
||||
On failure, the error code from the server.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpErrno
|
||||
function returns the server failure code for the last operation (useful for
|
||||
seeing more about what happened if you are familiar with FTP error codes).
|
||||
The
|
||||
.Fn ftpErrString
|
||||
function returns a human readable version of the supplied server failure code.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpGet
|
||||
function attempts to retrieve the file named by the
|
||||
.Fa file
|
||||
argument (which is assumed to be relative to the FTP server's current directory,
|
||||
see
|
||||
.Fn ftpChdir )
|
||||
and returns a new FILE* pointer for the file or NULL on failure.
|
||||
If
|
||||
.Fa seekto
|
||||
is non-NULL, the contents of the integer it points to will be used
|
||||
as a restart point for the file, that is to say that the stream
|
||||
returned will point
|
||||
.Fa *seekto
|
||||
bytes into the file gotten (this is handy for restarting failed
|
||||
transfers efficiently).
|
||||
If the seek operation fails, the value
|
||||
of
|
||||
.Fa *seekto
|
||||
will be zero'd.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpGetModtime
|
||||
function returns the last modification time of the file named by the
|
||||
.Fa file
|
||||
argument.
|
||||
If the file could not be opened or stat'd, 0 is returned.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpGetSize
|
||||
function returns the size in bytes of the file named by the
|
||||
.Fa file
|
||||
argument.
|
||||
If the file could not be opened or stat'd, -1 is returned.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpPut
|
||||
function attempts to create a new file named by the
|
||||
.Fa file
|
||||
argument (which is assumed to be relative to the FTP server's current directory,
|
||||
see
|
||||
.Fn ftpChdir )
|
||||
and returns a new
|
||||
.Fa stream
|
||||
pointer for the file or NULL on failure.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpAscii
|
||||
function sets
|
||||
.Tn ASCII
|
||||
mode for the current server connection named by
|
||||
.Fa stream .
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpBinary
|
||||
function sets binary mode for the current server connection named by
|
||||
.Fa stream .
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpPassive
|
||||
function sets passive mode (for firewalls) for the current server connection
|
||||
named by
|
||||
.Fa stream
|
||||
to boolean value
|
||||
.Fa status .
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpVerbose
|
||||
function sets the verbosity mode for the current server connection named by
|
||||
.Fa stream
|
||||
to boolean value
|
||||
.Fa status .
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpGetURL
|
||||
function attempts to retrieve the file named by the supplied
|
||||
.Fa URL
|
||||
and can be considered equivalent to the combined
|
||||
.Fn ftpLogin ,
|
||||
.Fn ftpChdir
|
||||
and
|
||||
.Fn ftpGet
|
||||
operations except that no server
|
||||
.Fa stream
|
||||
is ever returned - the connection to the server closes when
|
||||
the file has been completely read.
|
||||
Use the lower-level routines
|
||||
if multiple gets are required as it will be far more efficient.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpPutURL
|
||||
function attempts to create the file named by the supplied
|
||||
.Fa URL
|
||||
and can be considered equivalent to the combined
|
||||
.Fn ftpLogin ,
|
||||
.Fn ftpChdir
|
||||
and
|
||||
.Fn ftpPut
|
||||
operations except that no server stream is ever returned - the connection
|
||||
to the server closes when the file has been completely written.
|
||||
Use the
|
||||
lower-level routines if multiple puts are required as it will be far more
|
||||
efficient.
|
||||
.Pp
|
||||
The
|
||||
.Fn ftpLoginAf ,
|
||||
.Fn ftpGetURLAf ,
|
||||
.Fn ftpPutURLAf
|
||||
functions are same as
|
||||
.Fn ftpLogin ,
|
||||
.Fn ftpGetURL ,
|
||||
.Fn ftpPutURL
|
||||
except that they are able to specify address family
|
||||
.Fa af .
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width FTP_PASSIVE_MODE -offset 3n
|
||||
.It Ev FTP_TIMEOUT
|
||||
Maximum time, in seconds, to wait for a response
|
||||
from the peer before aborting an
|
||||
.Tn FTP
|
||||
connection.
|
||||
.It Ev FTP_PASSIVE_MODE
|
||||
If defined, forces the use of passive mode, unless equal
|
||||
to ``NO'' or ``no'' in which case active mode is forced.
|
||||
If defined, the setting of this variable always overrides any calls to
|
||||
.Fn ftpPassive .
|
||||
.El
|
||||
.Sh HISTORY
|
||||
Started life as Poul-Henning Kamp's ftp driver for the system installation
|
||||
utility, later significantly mutated into a more general form as an
|
||||
extension of stdio by Jordan Hubbard.
|
||||
Also incorporates some ideas and
|
||||
extensions from Jean-Marc Zucconi.
|
||||
.Sh AUTHORS
|
||||
.An Jordan Hubbard ,
|
||||
.An Poul-Henning Kamp
|
||||
and
|
||||
.An Jean-Marc Zucconi
|
||||
.Sh BUGS
|
||||
I am sure you can get this thing's internal state machine confused if
|
||||
you really work at it, but so far it has proven itself pretty robust in
|
||||
all my tests.
|
||||
1069
lib/libftpio/ftpio.c
1069
lib/libftpio/ftpio.c
File diff suppressed because it is too large
Load Diff
@ -1,71 +0,0 @@
|
||||
#ifndef _FTP_H_INCLUDE
|
||||
#define _FTP_H_INCLUDE
|
||||
|
||||
#include <sys/types.h>
|
||||
#include <sys/cdefs.h>
|
||||
#include <stdio.h>
|
||||
#include <time.h>
|
||||
|
||||
/*
|
||||
* ----------------------------------------------------------------------------
|
||||
* "THE BEER-WARE LICENSE" (Revision 42):
|
||||
* <phk@FreeBSD.org> wrote this file. As long as you retain this notice you
|
||||
* can do whatever you want with this stuff. If we meet some day, and you think
|
||||
* this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
|
||||
* ----------------------------------------------------------------------------
|
||||
*
|
||||
* Major Changelog:
|
||||
*
|
||||
* Jordan K. Hubbard
|
||||
* 17 Jan 1996
|
||||
*
|
||||
* Turned inside out. Now returns xfers as new file ids, not as a special
|
||||
* `state' of FTP_t
|
||||
*
|
||||
* $FreeBSD$
|
||||
*/
|
||||
|
||||
/* Internal housekeeping data structure for FTP sessions */
|
||||
typedef struct {
|
||||
enum { init, isopen, quit } con_state;
|
||||
int fd_ctrl;
|
||||
int addrtype;
|
||||
char *host;
|
||||
char *file;
|
||||
int error;
|
||||
int is_binary;
|
||||
int is_passive;
|
||||
int is_verbose;
|
||||
} *FTP_t;
|
||||
|
||||
/* Structure we use to match FTP error codes with readable strings */
|
||||
struct ftperr {
|
||||
const int num;
|
||||
const char *string;
|
||||
};
|
||||
|
||||
__BEGIN_DECLS
|
||||
extern struct ftperr ftpErrList[];
|
||||
extern int const ftpErrListLength;
|
||||
|
||||
/* Exported routines - deal only with FILE* type */
|
||||
extern FILE *ftpLogin(char *host, char *user, char *passwd, int port, int verbose, int *retcode);
|
||||
extern int ftpChdir(FILE *fp, char *dir);
|
||||
extern int ftpErrno(FILE *fp);
|
||||
extern off_t ftpGetSize(FILE *fp, char *file);
|
||||
extern FILE *ftpGet(FILE *fp, char *file, off_t *seekto);
|
||||
extern FILE *ftpPut(FILE *fp, char *file);
|
||||
extern int ftpAscii(FILE *fp);
|
||||
extern int ftpBinary(FILE *fp);
|
||||
extern int ftpPassive(FILE *fp, int status);
|
||||
extern void ftpVerbose(FILE *fp, int status);
|
||||
extern FILE *ftpGetURL(char *url, char *user, char *passwd, int *retcode);
|
||||
extern FILE *ftpPutURL(char *url, char *user, char *passwd, int *retcode);
|
||||
extern time_t ftpGetModtime(FILE *fp, char *s);
|
||||
extern const char *ftpErrString(int error);
|
||||
extern FILE *ftpLoginAf(char *host, int af, char *user, char *passwd, int port, int verbose, int *retcode);
|
||||
extern FILE *ftpGetURLAf(char *url, int af, char *user, char *passwd, int *retcode);
|
||||
extern FILE *ftpPutURLAf(char *url, int af, char *user, char *passwd, int *retcode);
|
||||
__END_DECLS
|
||||
|
||||
#endif /* _FTP_H_INCLUDE */
|
||||
Loading…
Reference in New Issue
Block a user