More comments about IPv6 stuff.
[rsync/rsync.git] / rsync.h
... / ...
CommitLineData
1/*
2 Copyright (C) by Andrew Tridgell 1996, 2000
3 Copyright (C) Paul Mackerras 1996
4 Copyright (C) 2001, 2002 by Martin Pool <mbp@samba.org>
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19*/
20
21
22#define False 0
23#define True 1
24
25#define BLOCK_SIZE 700
26#define RSYNC_RSH_ENV "RSYNC_RSH"
27
28#define RSYNC_NAME "rsync"
29#define RSYNCD_CONF "/etc/rsyncd.conf"
30
31#define DEFAULT_LOCK_FILE "/var/run/rsyncd.lock"
32#define URL_PREFIX "rsync://"
33
34#define BACKUP_SUFFIX "~"
35
36/* a non-zero CHAR_OFFSET makes the rolling sum stronger, but is
37 incompatible with older versions :-( */
38#define CHAR_OFFSET 0
39
40
41#define FLAG_DELETE (1<<0)
42#define SAME_MODE (1<<1)
43#define SAME_RDEV (1<<2)
44#define SAME_UID (1<<3)
45#define SAME_GID (1<<4)
46#define SAME_DIR (1<<5)
47#define SAME_NAME SAME_DIR
48#define LONG_NAME (1<<6)
49#define SAME_TIME (1<<7)
50
51/* update this if you make incompatible changes */
52#define PROTOCOL_VERSION 26
53
54/* We refuse to interoperate with versions that are not in this range.
55 * Note that we assume we'll work with later versions: the onus is on
56 * people writing them to make sure that they don't send us anything
57 * we won't understand.
58 *
59 * There are two possible explanations for the limit at thirty: either
60 * to allow new major-rev versions that do not interoperate with us,
61 * and (more likely) so that we can detect an attempt to connect rsync
62 * to a non-rsync server, which is unlikely to begin by sending a byte
63 * between 15 and 30. */
64#define MIN_PROTOCOL_VERSION 15
65#define MAX_PROTOCOL_VERSION 30
66
67#define RSYNC_PORT 873
68
69#define SPARSE_WRITE_SIZE (1024)
70#define WRITE_SIZE (32*1024)
71#define CHUNK_SIZE (32*1024)
72#define MAX_MAP_SIZE (256*1024)
73#define IO_BUFFER_SIZE (4092)
74
75#define MAX_ARGS 1000
76
77#define MPLEX_BASE 7
78
79/* Log values. I *think* what these mean is: FLOG goes to the server
80 * logfile; FERROR and FINFO try to end up on the client, with
81 * different levels of filtering. */
82enum logcode {FNONE=0, FERROR=1, FINFO=2, FLOG=3 };
83
84#include "errcode.h"
85
86#include "config.h"
87
88#if HAVE_REMSH
89#define RSYNC_RSH "remsh"
90#else
91#define RSYNC_RSH "rsh"
92#endif
93
94#include <sys/types.h>
95
96#ifdef HAVE_UNISTD_H
97#include <unistd.h>
98#endif
99#include <stdio.h>
100#include <stddef.h>
101
102#ifdef HAVE_SYS_PARAM_H
103#include <sys/param.h>
104#endif
105
106#ifdef HAVE_STDLIB_H
107#include <stdlib.h>
108#endif
109
110#ifdef HAVE_SYS_SOCKET_H
111#include <sys/socket.h>
112#endif
113
114#ifdef HAVE_STRING_H
115#include <string.h>
116#endif
117
118#ifdef HAVE_MALLOC_H
119#include <malloc.h>
120#endif
121
122#ifdef TIME_WITH_SYS_TIME
123#include <sys/time.h>
124#include <time.h>
125#else
126#ifdef HAVE_SYS_TIME_H
127#include <sys/time.h>
128#else
129#include <time.h>
130#endif
131#endif
132
133#ifdef HAVE_FCNTL_H
134#include <fcntl.h>
135#else
136#ifdef HAVE_SYS_FCNTL_H
137#include <sys/fcntl.h>
138#endif
139#endif
140
141#include <sys/stat.h>
142
143#ifdef HAVE_SYS_IOCTL_H
144#include <sys/ioctl.h>
145#endif
146
147#ifdef HAVE_SYS_FILIO_H
148#include <sys/filio.h>
149#endif
150
151#include <signal.h>
152#ifdef HAVE_SYS_WAIT_H
153#include <sys/wait.h>
154#endif
155#ifdef HAVE_CTYPE_H
156#include <ctype.h>
157#endif
158#ifdef HAVE_GRP_H
159#include <grp.h>
160#endif
161#include <errno.h>
162
163#ifdef HAVE_UTIME_H
164#include <utime.h>
165#endif
166
167#ifdef HAVE_SYS_SELECT_H
168#include <sys/select.h>
169#endif
170
171#ifdef HAVE_SYS_MODE_H
172/* apparently AIX needs this for S_ISLNK */
173#ifndef S_ISLNK
174#include <sys/mode.h>
175#endif
176#endif
177
178#ifdef HAVE_FNMATCH
179#include <fnmatch.h>
180#else
181#include "lib/fnmatch.h"
182#endif
183
184#ifdef HAVE_GLOB_H
185#include <glob.h>
186#endif
187
188#ifdef HAVE_MALLOC_H
189# include <malloc.h>
190#endif
191
192/* these are needed for the uid/gid mapping code */
193#include <pwd.h>
194#include <grp.h>
195
196#include <stdarg.h>
197#include <netinet/in.h>
198#include <arpa/inet.h>
199#include <netdb.h>
200#include <syslog.h>
201#include <sys/file.h>
202
203#if HAVE_DIRENT_H
204# include <dirent.h>
205#else
206# define dirent direct
207# if HAVE_SYS_NDIR_H
208# include <sys/ndir.h>
209# endif
210# if HAVE_SYS_DIR_H
211# include <sys/dir.h>
212# endif
213# if HAVE_NDIR_H
214# include <ndir.h>
215# endif
216#endif
217
218#ifdef HAVE_COMPAT_H
219#include <compat.h>
220#endif
221
222
223#define BOOL int
224
225#ifndef uchar
226#define uchar unsigned char
227#endif
228
229#if HAVE_UNSIGNED_CHAR
230#define schar signed char
231#else
232#define schar char
233#endif
234
235#ifndef int32
236#if (SIZEOF_INT == 4)
237#define int32 int
238#elif (SIZEOF_LONG == 4)
239#define int32 long
240#elif (SIZEOF_SHORT == 4)
241#define int32 short
242#else
243/* I hope this works */
244#define int32 int
245#define LARGE_INT32
246#endif
247#endif
248
249#ifndef uint32
250#define uint32 unsigned int32
251#endif
252
253#if HAVE_OFF64_T
254#define OFF_T off64_t
255#define STRUCT_STAT struct stat64
256#else
257#define OFF_T off_t
258#define STRUCT_STAT struct stat
259#endif
260
261#if HAVE_OFF64_T
262#define int64 off64_t
263#elif (SIZEOF_LONG == 8)
264#define int64 long
265#elif (SIZEOF_INT == 8)
266#define int64 int
267#elif HAVE_LONGLONG
268#define int64 long long
269#else
270/* As long as it gets... */
271#define int64 off_t
272#define NO_INT64
273#endif
274
275/* We want to manipulate 64-bit inums. On some systems
276 * STRUCT_STAT.st_ino can be bigger than an ino_t depending on the
277 * combination of largefile feature macros. Rather than try to guess,
278 * we just internally store them in the largest know type. Hopefully
279 * it's enough. */
280#define INO_T int64
281
282#ifndef MIN
283#define MIN(a,b) ((a)<(b)?(a):(b))
284#endif
285
286#ifndef MAX
287#define MAX(a,b) ((a)>(b)?(a):(b))
288#endif
289
290#ifndef MAXHOSTNAMELEN
291#define MAXHOSTNAMELEN 256
292#endif
293
294/* the length of the md4 checksum */
295#define MD4_SUM_LENGTH 16
296#define SUM_LENGTH 16
297
298#ifndef MAXPATHLEN
299#define MAXPATHLEN 1024
300#endif
301
302#ifndef INADDR_NONE
303#define INADDR_NONE 0xffffffff
304#endif
305
306struct file_struct {
307 unsigned flags;
308 time_t modtime;
309 OFF_T length;
310 mode_t mode;
311 INO_T inode;
312 dev_t dev;
313 dev_t rdev;
314 uid_t uid;
315 gid_t gid;
316 char *basename;
317 char *dirname;
318 char *basedir;
319 char *link;
320 char *sum;
321};
322
323
324#define ARENA_SIZE (32 * 1024)
325
326struct string_area {
327 char *base;
328 char *end;
329 char *current;
330 struct string_area *next;
331};
332
333struct file_list {
334 int count;
335 int malloced;
336 struct file_struct **files;
337 struct string_area *string_area;
338};
339
340struct sum_buf {
341 OFF_T offset; /* offset in file of this chunk */
342 int len; /* length of chunk of file */
343 int i; /* index of this chunk */
344 uint32 sum1; /* simple checksum */
345 char sum2[SUM_LENGTH]; /* checksum */
346};
347
348struct sum_struct {
349 OFF_T flength; /* total file length */
350 int count; /* how many chunks */
351 int remainder; /* flength % block_length */
352 int n; /* block_length */
353 struct sum_buf *sums; /* points to info for each chunk */
354};
355
356struct map_struct {
357 char *p;
358 int fd,p_size,p_len;
359 OFF_T file_size, p_offset, p_fd_offset;
360};
361
362struct exclude_struct {
363 char *pattern;
364 int regular_exp;
365 int fnmatch_flags;
366 int include;
367 int directory;
368 int local;
369};
370
371struct stats {
372 int64 total_size;
373 int64 total_transferred_size;
374 int64 total_written;
375 int64 total_read;
376 int64 literal_data;
377 int64 matched_data;
378 int flist_size;
379 int num_files;
380 int num_transferred_files;
381};
382
383
384/* we need this function because of the silly way in which duplicate
385 entries are handled in the file lists - we can't change this
386 without breaking existing versions */
387static inline int flist_up(struct file_list *flist, int i)
388{
389 while (!flist->files[i]->basename) i++;
390 return i;
391}
392
393#include "byteorder.h"
394#include "proto.h"
395#include "lib/mdfour.h"
396#include "lib/permstring.h"
397#include "lib/addrinfo.h"
398
399/* We have replacement versions of these if they're missing. */
400#ifndef HAVE_ASPRINTF
401int asprintf(char **ptr, const char *format, ...);
402#endif
403
404#ifndef HAVE_VASPRINTF
405int vasprintf(char **ptr, const char *format, va_list ap);
406#endif
407
408#if !defined(HAVE_VSNPRINTF) && !defined(HAVE_C99_VSNPRINTF)
409int vsnprintf (char *str, size_t count, const char *fmt, va_list args);
410#endif
411
412#if !defined(HAVE_SNPRINTF) && !defined(HAVE_C99_VSNPRINTF)
413int snprintf(char *str,size_t count,const char *fmt,...);
414#endif
415
416
417#if !HAVE_STRERROR
418extern char *sys_errlist[];
419#define strerror(i) sys_errlist[i]
420#endif
421
422#ifndef HAVE_STRCHR
423# define strchr index
424# define strrchr rindex
425#endif
426
427#ifndef HAVE_ERRNO_DECL
428extern int errno;
429#endif
430
431#define SUPPORT_LINKS HAVE_READLINK
432#define SUPPORT_HARD_LINKS HAVE_LINK
433
434#ifndef HAVE_LCHOWN
435#define lchown chown
436#endif
437
438#define SIGNAL_CAST (RETSIGTYPE (*)())
439
440#ifndef EWOULDBLOCK
441#define EWOULDBLOCK EAGAIN
442#endif
443
444#ifndef STDIN_FILENO
445#define STDIN_FILENO 0
446#endif
447
448#ifndef STDOUT_FILENO
449#define STDOUT_FILENO 1
450#endif
451
452#ifndef STDERR_FILENO
453#define STDERR_FILENO 2
454#endif
455
456#ifndef S_IWUSR
457#define S_IWUSR 0200
458#endif
459
460#ifndef _S_IFMT
461#define _S_IFMT 0170000
462#endif
463
464#ifndef _S_IFLNK
465#define _S_IFLNK 0120000
466#endif
467
468#ifndef S_ISLNK
469#define S_ISLNK(mode) (((mode) & (_S_IFMT)) == (_S_IFLNK))
470#endif
471
472#ifndef S_ISBLK
473#define S_ISBLK(mode) (((mode) & (_S_IFMT)) == (_S_IFBLK))
474#endif
475
476#ifndef S_ISCHR
477#define S_ISCHR(mode) (((mode) & (_S_IFMT)) == (_S_IFCHR))
478#endif
479
480#ifndef S_ISSOCK
481#ifdef _S_IFSOCK
482#define S_ISSOCK(mode) (((mode) & (_S_IFMT)) == (_S_IFSOCK))
483#else
484#define S_ISSOCK(mode) (0)
485#endif
486#endif
487
488#ifndef S_ISFIFO
489#ifdef _S_IFIFO
490#define S_ISFIFO(mode) (((mode) & (_S_IFMT)) == (_S_IFIFO))
491#else
492#define S_ISFIFO(mode) (0)
493#endif
494#endif
495
496#ifndef S_ISDIR
497#define S_ISDIR(mode) (((mode) & (_S_IFMT)) == (_S_IFDIR))
498#endif
499
500#ifndef S_ISREG
501#define S_ISREG(mode) (((mode) & (_S_IFMT)) == (_S_IFREG))
502#endif
503
504/* work out what fcntl flag to use for non-blocking */
505#ifdef O_NONBLOCK
506# define NONBLOCK_FLAG O_NONBLOCK
507#elif defined(SYSV)
508# define NONBLOCK_FLAG O_NDELAY
509#else
510# define NONBLOCK_FLAG FNDELAY
511#endif
512
513#ifndef INADDR_LOOPBACK
514#define INADDR_LOOPBACK 0x7f000001
515#endif
516
517#ifndef INADDR_NONE
518#define INADDR_NONE 0xffffffff
519#endif
520
521#define IS_DEVICE(mode) (S_ISCHR(mode) || S_ISBLK(mode) || S_ISSOCK(mode) || S_ISFIFO(mode))
522
523#ifndef ACCESSPERMS
524#define ACCESSPERMS 0777
525#endif
526/* Initial mask on permissions given to temporary files. Mask off setuid
527 bits and group access because of potential race-condition security
528 holes, and mask other access because mode 707 is bizarre */
529#define INITACCESSPERMS 0700
530
531/* handler for null strings in printf format */
532#define NS(s) ((s)?(s):"<NULL>")
533
534/* use magic gcc attributes to catch format errors */
535 void rprintf(enum logcode , const char *, ...)
536#ifdef __GNUC__
537 __attribute__ ((format (printf, 2, 3)))
538#endif
539;
540
541/* This is just like rprintf, but it also tries to print some
542 * representation of the error code. Normally errcode = errno. */
543void rsyserr(enum logcode, int, const char *, ...)
544#ifdef __GNUC__
545 __attribute__ ((format (printf, 3, 4)))
546#endif
547 ;
548
549#ifdef REPLACE_INET_NTOA
550#define inet_ntoa rep_inet_ntoa
551#endif
552
553
554#ifndef HAVE_STRLCPY
555size_t strlcpy(char *d, const char *s, size_t bufsize);
556#endif
557
558#ifndef HAVE_STRLCAT
559size_t strlcat(char *d, const char *s, size_t bufsize);
560#endif
561
562#ifndef WEXITSTATUS
563#define WEXITSTATUS(stat) ((int)(((stat)>>8)&0xFF))
564#endif
565
566#define exit_cleanup(code) _exit_cleanup(code, __FILE__, __LINE__)
567
568
569extern int verbose;
570
571#ifndef HAVE_INET_NTOP
572const char *
573inet_ntop(int af, const void *src, char *dst, size_t size);
574#endif /* !HAVE_INET_NTOP */
575
576#ifndef HAVE_INET_PTON
577int isc_net_pton(int af, const char *src, void *dst);
578#endif