xref: /netbsd/usr.bin/ftp/ftp_var.h (revision 6a8b577c)
1 /*	$NetBSD: ftp_var.h,v 1.86 2021/09/10 21:52:17 rillig Exp $	*/
2 
3 /*-
4  * Copyright (c) 1996-2009 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Luke Mewburn.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 /*
33  * Copyright (c) 1985, 1989, 1993, 1994
34  *	The Regents of the University of California.  All rights reserved.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  * 1. Redistributions of source code must retain the above copyright
40  *    notice, this list of conditions and the following disclaimer.
41  * 2. Redistributions in binary form must reproduce the above copyright
42  *    notice, this list of conditions and the following disclaimer in the
43  *    documentation and/or other materials provided with the distribution.
44  * 3. Neither the name of the University nor the names of its contributors
45  *    may be used to endorse or promote products derived from this software
46  *    without specific prior written permission.
47  *
48  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
49  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
51  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
52  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
53  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
54  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
55  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
56  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
57  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
58  * SUCH DAMAGE.
59  *
60  *	@(#)ftp_var.h	8.4 (Berkeley) 10/9/94
61  */
62 
63 /*
64  * Copyright (C) 1997 and 1998 WIDE Project.
65  * All rights reserved.
66  *
67  * Redistribution and use in source and binary forms, with or without
68  * modification, are permitted provided that the following conditions
69  * are met:
70  * 1. Redistributions of source code must retain the above copyright
71  *    notice, this list of conditions and the following disclaimer.
72  * 2. Redistributions in binary form must reproduce the above copyright
73  *    notice, this list of conditions and the following disclaimer in the
74  *    documentation and/or other materials provided with the distribution.
75  * 3. Neither the name of the project nor the names of its contributors
76  *    may be used to endorse or promote products derived from this software
77  *    without specific prior written permission.
78  *
79  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
80  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
81  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
82  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
83  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
84  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
85  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
86  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
87  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
88  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
89  * SUCH DAMAGE.
90  */
91 
92 /*
93  * FTP global variables.
94  */
95 
96 #ifdef SMALL
97 #undef	NO_EDITCOMPLETE
98 #define	NO_EDITCOMPLETE
99 #undef	NO_PROGRESS
100 #define	NO_PROGRESS
101 #endif
102 
103 #include <sys/param.h>
104 
105 #include <netinet/in.h>
106 #include <arpa/inet.h>
107 
108 #include <poll.h>
109 
110 #include <setjmp.h>
111 #include <stringlist.h>
112 
113 #ifndef NO_EDITCOMPLETE
114 #include <histedit.h>
115 #endif /* !NO_EDITCOMPLETE */
116 
117 #include "extern.h"
118 #include "progressbar.h"
119 
120 /*
121  * Format of command table.
122  */
123 struct cmd {
124 	const char	*c_name;	/* name of command */
125 	const char	*c_help;	/* help string */
126 	char		c_bell;		/* give bell when command completes */
127 	char		c_conn;		/* must be connected to use command */
128 	char		c_proxy;	/* proxy server may execute */
129 #ifndef NO_EDITCOMPLETE
130 	const char	*c_complete;	/* context sensitive completion list */
131 #endif /* !NO_EDITCOMPLETE */
132 	void		(*c_handler)(int, char **); /* function to call */
133 };
134 
135 #define MAX_C_NAME	12		/* maximum length of cmd.c_name */
136 
137 /*
138  * Format of macro table
139  */
140 struct macel {
141 	char	 mac_name[9];	/* macro name */
142 	char	*mac_start;	/* start of macro in macbuf */
143 	char	*mac_end;	/* end of macro in macbuf */
144 };
145 
146 /*
147  * Format of option table
148  */
149 struct option {
150 	const char	*name;
151 	char		*value;
152 };
153 
154 /*
155  * Indices to features[]; an array containing status of remote server
156  * features; -1 not known (FEAT failed), 0 absent, 1 present.
157  */
158 enum {
159 	FEAT_FEAT = 0,		/* FEAT, OPTS */
160 	FEAT_MDTM,		/* MDTM */
161 	FEAT_MLST,		/* MLSD, MLST */
162 	FEAT_REST_STREAM,	/* RESTart STREAM */
163 	FEAT_SIZE,		/* SIZE */
164 	FEAT_TVFS,		/* TVFS (not used) */
165 	FEAT_max
166 };
167 
168 
169 /*
170  * Global defines
171  */
172 #define	FTPBUFLEN	(4 * MAXPATHLEN)
173 #define	MAX_IN_PORT_T	0xffffU
174 
175 #define	HASHBYTES	1024	/* default mark for `hash' command */
176 #define	DEFAULTINCR	1024	/* default increment for `rate' command */
177 
178 #define	FTP_PORT	21	/* default if ! getservbyname("ftp/tcp") */
179 #define	HTTP_PORT	80	/* default if ! getservbyname("http/tcp") */
180 #define	HTTPS_PORT	443	/* default if ! getservbyname("https/tcp") */
181 #ifndef	GATE_PORT
182 #define	GATE_PORT	21	/* default if ! getservbyname("ftpgate/tcp") */
183 #endif
184 #ifndef	GATE_SERVER
185 #define	GATE_SERVER	""	/* default server */
186 #endif
187 
188 #define	DEFAULTPAGER	"more"	/* default pager if $PAGER isn't set */
189 #define	DEFAULTPROMPT	"ftp> "	/* default prompt  if `set prompt' is empty */
190 #define	DEFAULTRPROMPT	""	/* default rprompt if `set rprompt' is empty */
191 
192 #define	TMPFILE		"ftpXXXXXXXXXX"
193 
194 
195 #ifndef	GLOBAL
196 #define	GLOBAL	extern
197 #endif
198 
199 /*
200  * Options and other state info.
201  */
202 GLOBAL	int	trace;		/* trace packets exchanged */
203 GLOBAL	int	hash;		/* print # for each buffer transferred */
204 GLOBAL	int	mark;		/* number of bytes between hashes */
205 GLOBAL	int	sendport;	/* use PORT/LPRT cmd for each data connection */
206 GLOBAL	int	connected;	/* 1 = connected to server, -1 = logged in */
207 GLOBAL	int	interactive;	/* interactively prompt on m* cmds */
208 GLOBAL	int	confirmrest;	/* confirm rest of current m* cmd */
209 GLOBAL	int	ftp_debug;	/* debugging level */
210 GLOBAL	int	bell;		/* ring bell on cmd completion */
211 GLOBAL	int	doglob;		/* glob local file names */
212 GLOBAL	int	autologin;	/* establish user account on connection */
213 GLOBAL	int	proxy;		/* proxy server connection active */
214 GLOBAL	int	proxflag;	/* proxy connection exists */
215 GLOBAL	int	gatemode;	/* use gate-ftp */
216 GLOBAL	const char *gateserver;	/* server to use for gate-ftp */
217 GLOBAL	int	sunique;	/* store files on server with unique name */
218 GLOBAL	int	runique;	/* store local files with unique name */
219 GLOBAL	int	mcase;		/* map upper to lower case for mget names */
220 GLOBAL	int	ntflag;		/* use ntin ntout tables for name translation */
221 GLOBAL	int	mapflag;	/* use mapin mapout templates on file names */
222 GLOBAL	int	preserve;	/* preserve modification time on files */
223 GLOBAL	int	code;		/* return/reply code for ftp command */
224 GLOBAL	int	crflag;		/* if 1, strip car. rets. on ascii gets */
225 GLOBAL	int	passivemode;	/* passive mode enabled */
226 GLOBAL	int	activefallback;	/* fall back to active mode if passive fails */
227 GLOBAL	char   *altarg;		/* argv[1] with no shell-like preprocessing  */
228 GLOBAL	char	ntin[17];	/* input translation table */
229 GLOBAL	char	ntout[17];	/* output translation table */
230 GLOBAL	char	mapin[MAXPATHLEN]; /* input map template */
231 GLOBAL	char	mapout[MAXPATHLEN]; /* output map template */
232 GLOBAL	char	typename[32];	/* name of file transfer type */
233 GLOBAL	int	type;		/* requested file transfer type */
234 GLOBAL	int	curtype;	/* current file transfer type */
235 GLOBAL	char	structname[32];	/* name of file transfer structure */
236 GLOBAL	int	stru;		/* file transfer structure */
237 GLOBAL	char	formname[32];	/* name of file transfer format */
238 GLOBAL	int	form;		/* file transfer format */
239 GLOBAL	char	modename[32];	/* name of file transfer mode */
240 GLOBAL	int	mode;		/* file transfer mode */
241 GLOBAL	char	bytename[32];	/* local byte size in ascii */
242 GLOBAL	int	bytesize;	/* local byte size in binary */
243 GLOBAL	int	anonftp;	/* automatic anonymous login */
244 GLOBAL	int	dirchange;	/* remote directory changed by cd command */
245 GLOBAL	int	flushcache;	/* set HTTP cache flush headers with request */
246 GLOBAL	int	rate_get;	/* maximum get xfer rate */
247 GLOBAL	int	rate_get_incr;	/* increment for get xfer rate */
248 GLOBAL	int	rate_put;	/* maximum put xfer rate */
249 GLOBAL	int	rate_put_incr;	/* increment for put xfer rate */
250 GLOBAL	int	retry_connect;	/* seconds between retrying connection */
251 GLOBAL	const char *tmpdir;	/* temporary directory */
252 GLOBAL	int	epsv4;		/* use EPSV/EPRT on IPv4 connections */
253 GLOBAL	int	epsv4bad;	/* EPSV doesn't work on the current server */
254 GLOBAL	int	epsv6;		/* use EPSV/EPRT on IPv6 connections */
255 GLOBAL	int	epsv6bad;	/* EPSV doesn't work on the current server */
256 GLOBAL	int	editing;	/* command line editing enabled */
257 GLOBAL	int	features[FEAT_max];	/* remote FEATures supported */
258 
259 #ifndef NO_EDITCOMPLETE
260 GLOBAL	EditLine *el;		/* editline(3) status structure */
261 GLOBAL	History  *hist;		/* editline(3) history structure */
262 GLOBAL	char	 *cursor_pos;	/* cursor position we're looking for */
263 GLOBAL	size_t	  cursor_argc;	/* location of cursor in margv */
264 GLOBAL	size_t	  cursor_argo;	/* offset of cursor in margv[cursor_argc] */
265 #endif /* !NO_EDITCOMPLETE */
266 
267 GLOBAL	char   *hostname;	/* name of host connected to */
268 GLOBAL	int	unix_server;	/* server is unix, can use binary for ascii */
269 GLOBAL	int	unix_proxy;	/* proxy is unix, can use binary for ascii */
270 GLOBAL	char	localcwd[MAXPATHLEN];	/* local dir */
271 GLOBAL	char	remotecwd[MAXPATHLEN];	/* remote dir */
272 GLOBAL	int	remcwdvalid;		/* remotecwd has been updated */
273 GLOBAL	char   *username;	/* name of user logged in as. (dynamic) */
274 
275 GLOBAL	sa_family_t family;	/* address family to use for connections */
276 GLOBAL	const char *ftpport;	/* port number to use for FTP connections */
277 GLOBAL	const char *httpport;	/* port number to use for HTTP connections */
278 #ifdef WITH_SSL
279 GLOBAL	const char *httpsport;	/* port number to use for HTTPS connections */
280 #endif
281 GLOBAL	const char *gateport;	/* port number to use for gateftp connections */
282 GLOBAL	struct addrinfo *bindai; /* local address to bind as */
283 
284 GLOBAL	char   *outfile;	/* filename to output URLs to */
285 GLOBAL	int	restartautofetch; /* restart auto-fetch */
286 
287 GLOBAL	char	line[FTPBUFLEN]; /* input line buffer */
288 GLOBAL	char	*stringbase;	/* current scan point in line buffer */
289 GLOBAL	char	argbuf[FTPBUFLEN]; /* argument storage buffer */
290 GLOBAL	char	*argbase;	/* current storage point in arg buffer */
291 GLOBAL	StringList *marg_sl;	/* stringlist containing margv */
292 GLOBAL	int	margc;		/* count of arguments on input line */
293 #define	margv (marg_sl->sl_str)	/* args parsed from input line */
294 GLOBAL	int     cpend;		/* flag: if != 0, then pending server reply */
295 GLOBAL	int	mflag;		/* flag: if != 0, then active multi command */
296 
297 GLOBAL	int	options;	/* used during socket creation */
298 
299 GLOBAL	int	sndbuf_size;	/* socket send buffer size */
300 GLOBAL	int	rcvbuf_size;	/* socket receive buffer size */
301 
302 GLOBAL	int	macnum;		/* number of defined macros */
303 GLOBAL	struct macel macros[16];
304 GLOBAL	char	macbuf[4096];
305 
306 GLOBAL	char	*localhome;		/* local home directory */
307 GLOBAL	char	*localname;		/* local user name */
308 GLOBAL	char	 netrc[MAXPATHLEN];	/* path to .netrc file */
309 GLOBAL	char	 reply_string[BUFSIZ];	/* first line of previous reply */
310 GLOBAL	void	(*reply_callback)(const char *);
311 					/*
312 					 * function to call for each line in
313 					 * the server's reply except for the
314 					 * first (`xxx-') and last (`xxx ')
315 					 */
316 
317 GLOBAL	volatile sig_atomic_t	sigint_raised;
318 
319 GLOBAL	FILE	*cin;
320 GLOBAL	FILE	*cout;
321 GLOBAL	int	 data;
322 
323 extern	struct cmd	cmdtab[];
324 extern	struct option	optiontab[];
325 
326 
327 #define	EMPTYSTRING(x)	((x) == NULL || (*(x) == '\0'))
328 #define	FREEPTR(x)	if ((x) != NULL) { free(x); (x) = NULL; }
329 
330 #ifdef BSD4_4
331 # define HAVE_STRUCT_SOCKADDR_IN_SIN_LEN	1
332 #endif
333 
334 #ifdef NO_LONG_LONG
335 # define STRTOLL(x,y,z)	strtol(x,y,z)
336 #else
337 # define STRTOLL(x,y,z)	strtoll(x,y,z)
338 #endif
339 
340 #ifdef NO_DEBUG
341 #define DPRINTF(...)	(void)0
342 #define DWARN(...)	(void)0
343 #else
344 #define DWFTP(a)	do a; while (0)
345 #define DPRINTF(...)	DWFTP(if (ftp_debug) (void)fprintf(ttyout, __VA_ARGS__))
346 #define DWARN(...)	DWFTP(if (ftp_debug) warn(__VA_ARGS__))
347 #endif
348 
349 #define STRorNULL(s)	((s) ? (s) : "<null>")
350 
351 #ifdef NO_USAGE
352 void xusage(void);
353 #define UPRINTF(...)	xusage()
354 #else
355 #define UPRINTF(...)	(void)fprintf(ttyout, __VA_ARGS__)
356 #endif
357