Document an alternate way to achieve the effect of this script
[rsync/rsync.git] / rsync.h
CommitLineData
d622d4bf 1/*
a039749b 2 Copyright (C) by Andrew Tridgell 1996, 2000
c627d613 3 Copyright (C) Paul Mackerras 1996
736a6a29 4 Copyright (C) 2001, 2002 by Martin Pool <mbp@samba.org>
d622d4bf 5
c627d613
AT
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.
d622d4bf 10
c627d613
AT
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.
d622d4bf 15
c627d613
AT
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
0de40240 21
d41c7d02
DD
22#define False 0
23#define True 1
24
c627d613
AT
25#define BLOCK_SIZE 700
26#define RSYNC_RSH_ENV "RSYNC_RSH"
8dd99390 27#define RSYNC_RSH_IO_ENV "RSYNC_RSH_IO"
7b8356d0 28
c627d613 29#define RSYNC_NAME "rsync"
cd3fe9fb 30/* RSYNCD_SYSCONF is now set in config.h */
30e8c8e1 31#define RSYNCD_USERCONF "rsyncd.conf"
f0fca04e 32
5e71c444 33#define DEFAULT_LOCK_FILE "/var/run/rsyncd.lock"
f7632fc6
AT
34#define URL_PREFIX "rsync://"
35
c627d613
AT
36#define BACKUP_SUFFIX "~"
37
1b01b295 38/* a non-zero CHAR_OFFSET makes the rolling sum stronger, but is
6543dc0c 39 incompatible with older versions :-( */
1b01b295
AT
40#define CHAR_OFFSET 0
41
a5f9cff2
WD
42/* These flags are only used during the flist transfer. */
43
ec33e0e6 44#define XMIT_TOP_DIR (1<<0)
a5f9cff2
WD
45#define XMIT_SAME_MODE (1<<1)
46#define XMIT_EXTENDED_FLAGS (1<<2)
47#define XMIT_SAME_RDEV_pre28 XMIT_EXTENDED_FLAGS /* Only in protocols < 28 */
48#define XMIT_SAME_UID (1<<3)
49#define XMIT_SAME_GID (1<<4)
50#define XMIT_SAME_NAME (1<<5)
51#define XMIT_LONG_NAME (1<<6)
52#define XMIT_SAME_TIME (1<<7)
af107f6c 53#define XMIT_SAME_RDEV_MAJOR (1<<8)
a5f9cff2
WD
54#define XMIT_HAS_IDEV_DATA (1<<9)
55#define XMIT_SAME_DEV (1<<10)
af107f6c 56#define XMIT_RDEV_MINOR_IS_SMALL (1<<11)
a5f9cff2
WD
57
58/* These flags are used in the live flist data. */
59
ec33e0e6 60#define FLAG_TOP_DIR (1<<0)
a5f9cff2 61#define FLAG_HLINK_EOL (1<<1) /* generator only */
ae289aec 62#define FLAG_MOUNT_POINT (1<<2) /* sender only */
0dd046d3 63#define FLAG_NO_FUZZY (1<<2) /* generator only */
ec33e0e6 64#define FLAG_DEL_HERE (1<<3) /* receiver/generator */
0cc279e0 65#define FLAG_SENT (1<<3) /* sender only */
520cf417 66
c627d613 67/* update this if you make incompatible changes */
2b2ea368 68#define PROTOCOL_VERSION 29
063393d6
MP
69
70/* We refuse to interoperate with versions that are not in this range.
71 * Note that we assume we'll work with later versions: the onus is on
72 * people writing them to make sure that they don't send us anything
73 * we won't understand.
74 *
1b2db7ae
S
75 * Interoperation with old but supported protocol versions
76 * should cause a warning to be printed. At a future date
77 * the old protocol will become the minimum and
78 * compatibility code removed.
79 *
91c4da3f
S
80 * There are two possible explanations for the limit at
81 * MAX_PROTOCOL_VERSION: either to allow new major-rev versions that
82 * do not interoperate with us, and (more likely) so that we can
83 * detect an attempt to connect rsync to a non-rsync server, which is
84 * unlikely to begin by sending a byte between MIN_PROTOCL_VERSION and
85 * MAX_PROTOCOL_VERSION. */
86
3e491682
S
87#define MIN_PROTOCOL_VERSION 20
88#define OLD_PROTOCOL_VERSION 25
1b2db7ae 89#define MAX_PROTOCOL_VERSION 40
c627d613 90
9486289c
AT
91#define RSYNC_PORT 873
92
d867229b 93#define SPARSE_WRITE_SIZE (1024)
dc5ddbcc 94#define WRITE_SIZE (32*1024)
34ccb63e 95#define CHUNK_SIZE (32*1024)
61542c41 96#define MAX_MAP_SIZE (256*1024)
e3fe383a 97#define IO_BUFFER_SIZE (4092)
2b2ea368 98#define MAX_BLOCK_SIZE ((int32)1 << 29)
c627d613 99
e2d22fee
WD
100#define IOERR_GENERAL (1<<0) /* For backward compatibility, this must == 1 */
101#define IOERR_VANISHED (1<<1)
102
874895d5 103#define MAX_ARGS 1000
f0fca04e 104
e4977b0b
WD
105#define MAX_BASIS_DIRS 20
106
8d9dc9f9 107#define MPLEX_BASE 7
ff41a59f 108
7842418b
WD
109#define NO_FILTERS 0
110#define SERVER_FILTERS 1
111#define ALL_FILTERS 2
4762db4f 112
753b6b46 113#define XFLG_FATAL_ERRORS (1<<0)
3b2461cf
WD
114#define XFLG_OLD_PREFIXES (1<<1)
115#define XFLG_ANCHORED2ABS (1<<2)
4762db4f 116
38443188
WD
117#define PERMS_REPORT (1<<0)
118#define PERMS_SKIP_MTIME (1<<1)
5c6fc4a6 119
419896af
WD
120#define FULL_FLUSH 1
121#define NORMAL_FLUSH 0
122
a7260c40
WD
123#define PDIR_CREATE 1
124#define PDIR_DELETE 0
125
e341588a
WD
126/* Note: 0x00 - 0x7F are used for basis_dir[] indexes! */
127#define FNAMECMP_BASIS_DIR_LOW 0x00 /* Must remain 0! */
128#define FNAMECMP_BASIS_DIR_HIGH 0x7F
41cfde6b
WD
129#define FNAMECMP_FNAME 0x80
130#define FNAMECMP_PARTIAL_DIR 0x81
131#define FNAMECMP_BACKUP 0x82
0dd046d3 132#define FNAMECMP_FUZZY 0x83
41cfde6b 133
eb1accaa 134/* For calling delete_file() */
757e0a54
WD
135#define DEL_NO_RECURSE (1<<1)
136#define DEL_FORCE_RECURSE (1<<2) /* recurse even w/o --force */
137#define DEL_TERSE (1<<3)
eb1accaa 138
0cc279e0
WD
139/* For use by the itemize_changes code */
140#define ITEM_UPDATING (1<<0)
141#define ITEM_REPORT_CHECKSUM (1<<1)
142#define ITEM_REPORT_SIZE (1<<2)
143#define ITEM_REPORT_TIME (1<<3)
144#define ITEM_REPORT_PERMS (1<<4)
145#define ITEM_REPORT_OWNER (1<<5)
146#define ITEM_REPORT_GROUP (1<<6)
147#define ITEM_IS_NEW (1<<7)
148
9f7c5dab
WD
149#define ITEM_MISSING_DATA (1<<16) /* these are outside the transmitted flags */
150#define ITEM_DELETED (1<<17)
df0054ab 151
1dcf3b43
WD
152/* Log-message categories. FLOG and FCLIENT are only used on the daemon
153 * side for custom logging -- they don't get sent over the socket. */
154enum logcode { FERROR=1, FINFO=2, FLOG=3, FCLIENT=4 };
419896af
WD
155
156/* Messages types that are sent over the message channel. The logcode
157 * values must all be present here with identical numbers. */
158enum msgcode {
1dcf3b43
WD
159 MSG_DATA=0, /* raw data on the multiplexed stream */
160 MSG_ERROR=FERROR, MSG_INFO=FINFO, /* remote logging */
161 MSG_LOG=FLOG, MSG_FCLIENT=FCLIENT, /* sibling logging */
162 MSG_REDO=9, /* reprocess indicated flist index */
163 MSG_SUCCESS=100,/* successfully updated indicated flist index */
164 MSG_DELETED=101,/* successfully deleted a file on receiving side */
165 MSG_DONE=86 /* current phase is done */
419896af 166};
7bec6a5c 167
65417579
AT
168#include "errcode.h"
169
c627d613
AT
170#include "config.h"
171
e3217f14 172/* The default RSYNC_RSH is always set in config.h. */
24d95c03 173
c627d613 174#include <stdio.h>
4f5b0756 175#ifdef HAVE_SYS_TYPES_H
e95538ca
WD
176# include <sys/types.h>
177#endif
4f5b0756 178#ifdef HAVE_SYS_STAT_H
e95538ca
WD
179# include <sys/stat.h>
180#endif
4f5b0756 181#ifdef STDC_HEADERS
e95538ca
WD
182# include <stdlib.h>
183# include <stddef.h>
184#else
4f5b0756 185# ifdef HAVE_STDLIB_H
e95538ca
WD
186# include <stdlib.h>
187# endif
188#endif
4f5b0756
WD
189#ifdef HAVE_STRING_H
190# if !defined STDC_HEADERS && defined HAVE_MEMORY_H
e95538ca
WD
191# include <memory.h>
192# endif
193# include <string.h>
194#endif
4f5b0756 195#ifdef HAVE_STRINGS_H
e95538ca
WD
196# include <strings.h>
197#endif
4f5b0756 198#ifdef HAVE_UNISTD_H
e95538ca 199# include <unistd.h>
c627d613
AT
200#endif
201
4f5b0756 202#ifdef HAVE_SYS_PARAM_H
e95538ca 203#include <sys/param.h>
38b02c13 204#endif
59192f56 205
4f5b0756 206#if defined HAVE_MALLOC_H && (defined HAVE_MALLINFO || !defined HAVE_STDLIB_H)
59192f56 207#include <malloc.h>
d7b305fd
AT
208#endif
209
4f5b0756 210#ifdef HAVE_SYS_SOCKET_H
fdd71e17
AT
211#include <sys/socket.h>
212#endif
213
4f5b0756 214#ifdef TIME_WITH_SYS_TIME
c627d613
AT
215#include <sys/time.h>
216#include <time.h>
217#else
4f5b0756 218#ifdef HAVE_SYS_TIME_H
c627d613
AT
219#include <sys/time.h>
220#else
221#include <time.h>
222#endif
223#endif
224
4f5b0756 225#ifdef HAVE_FCNTL_H
c627d613
AT
226#include <fcntl.h>
227#else
4f5b0756 228#ifdef HAVE_SYS_FCNTL_H
c627d613
AT
229#include <sys/fcntl.h>
230#endif
231#endif
232
4f5b0756 233#ifdef HAVE_SYS_IOCTL_H
94481d91
AT
234#include <sys/ioctl.h>
235#endif
236
4f5b0756 237#ifdef HAVE_SYS_FILIO_H
94481d91
AT
238#include <sys/filio.h>
239#endif
240
c627d613 241#include <signal.h>
4f5b0756 242#ifdef HAVE_SYS_WAIT_H
c627d613
AT
243#include <sys/wait.h>
244#endif
4f5b0756 245#ifdef HAVE_CTYPE_H
c627d613
AT
246#include <ctype.h>
247#endif
4f5b0756 248#ifdef HAVE_GRP_H
c627d613
AT
249#include <grp.h>
250#endif
251#include <errno.h>
252
4f5b0756 253#ifdef HAVE_UTIME_H
c627d613
AT
254#include <utime.h>
255#endif
256
4f5b0756 257#ifdef HAVE_SYS_SELECT_H
8bf73749
AT
258#include <sys/select.h>
259#endif
260
4f5b0756 261#ifdef HAVE_SYS_MODE_H
773f2bd4 262/* apparently AIX needs this for S_ISLNK */
05a6556d 263#ifndef S_ISLNK
773f2bd4
AT
264#include <sys/mode.h>
265#endif
05a6556d 266#endif
773f2bd4 267
4f5b0756 268#ifdef HAVE_GLOB_H
874895d5
AT
269#include <glob.h>
270#endif
271
f6c34742
AT
272/* these are needed for the uid/gid mapping code */
273#include <pwd.h>
274#include <grp.h>
275
9486289c 276#include <stdarg.h>
f0fca04e
AT
277#include <netinet/in.h>
278#include <arpa/inet.h>
279#include <netdb.h>
ff8b29b8 280#include <syslog.h>
6c8f5373 281#include <sys/file.h>
9486289c 282
4f5b0756 283#ifdef HAVE_DIRENT_H
e8f5b936
AT
284# include <dirent.h>
285#else
286# define dirent direct
4f5b0756 287# ifdef HAVE_SYS_NDIR_H
e8f5b936
AT
288# include <sys/ndir.h>
289# endif
4f5b0756 290# ifdef HAVE_SYS_DIR_H
e8f5b936
AT
291# include <sys/dir.h>
292# endif
4f5b0756 293# ifdef HAVE_NDIR_H
e8f5b936
AT
294# include <ndir.h>
295# endif
296#endif
297
4f5b0756 298#ifdef MAJOR_IN_MKDEV
c39d6514 299#include <sys/mkdev.h>
4f5b0756 300# if !defined makedev && defined mkdev
73496a36
WD
301# define makedev mkdev
302# endif
4f5b0756 303#elif defined MAJOR_IN_SYSMACROS
f8ed564c 304#include <sys/sysmacros.h>
c39d6514
WD
305#endif
306
4f5b0756 307#ifdef HAVE_COMPAT_H
e8f5b936
AT
308#include <compat.h>
309#endif
310
1bfbf40b
MP
311#include <assert.h>
312
9935066b 313#include "lib/pool_alloc.h"
e8f5b936 314
f0fca04e
AT
315#define BOOL int
316
c627d613
AT
317#ifndef uchar
318#define uchar unsigned char
319#endif
320
4f5b0756 321#ifdef SIGNED_CHAR_OK
debb4505
AT
322#define schar signed char
323#else
324#define schar char
325#endif
326
43d0f38b
WD
327/* Find a variable that is either exactly 32-bits or longer.
328 * If some code depends on 32-bit truncation, it will need to
329 * take special action in a "#if SIZEOF_INT32 > 4" section. */
c627d613 330#ifndef int32
43d0f38b
WD
331#if SIZEOF_INT == 4
332# define int32 int
333# define SIZEOF_INT32 4
334#elif SIZEOF_LONG == 4
335# define int32 long
336# define SIZEOF_INT32 4
337#elif SIZEOF_SHORT == 4
338# define int32 short
339# define SIZEOF_INT32 4
340#elif SIZEOF_INT > 4
341# define int32 int
342# define SIZEOF_INT32 SIZEOF_INT
343#elif SIZEOF_LONG > 4
344# define int32 long
345# define SIZEOF_INT32 SIZEOF_LONG
8de330a3 346#else
43d0f38b 347# error Could not find a 32-bit integer variable
c627d613 348#endif
43d0f38b
WD
349#else
350# define SIZEOF_INT32 4
c627d613
AT
351#endif
352
353#ifndef uint32
354#define uint32 unsigned int32
355#endif
356
0dd046d3 357#if SIZEOF_OFF_T == 8 || !SIZEOF_OFF64_T || !defined HAVE_STRUCT_STAT64
bcacc18b
AT
358#define OFF_T off_t
359#define STRUCT_STAT struct stat
5b5f7e3b
WD
360#else
361#define OFF_T off64_t
362#define STRUCT_STAT struct stat64
363#define USE_STAT64_FUNCS 1
bcacc18b
AT
364#endif
365
d4198823
WD
366/* CAVEAT: on some systems, int64 will really be a 32-bit integer IFF
367 * that's the maximum size the file system can handle and there is no
368 * 64-bit type available. The rsync source must therefore take steps
369 * to ensure that any code that really requires a 64-bit integer has
370 * it (e.g. the checksum code uses two 32-bit integers for its 64-bit
371 * counter). */
d622d4bf
WD
372#if SIZEOF_OFF64_T == 8
373# define int64 off64_t
374# define SIZEOF_INT64 8
375#elif SIZEOF_LONG == 8
376# define int64 long
377# define SIZEOF_INT64 8
378#elif SIZEOF_INT == 8
379# define int64 int
380# define SIZEOF_INT64 8
381#elif SIZEOF_LONG_LONG == 8
382# define int64 long long
383# define SIZEOF_INT64 8
384#elif SIZEOF_OFF_T == 8
385# define int64 off_t
386# define SIZEOF_INT64 8
387#elif SIZEOF_INT > 8
388# define int64 int
389# define SIZEOF_INT64 SIZEOF_INT
390#elif SIZEOF_LONG > 8
391# define int64 long
392# define SIZEOF_INT64 SIZEOF_LONG
393#elif SIZEOF_LONG_LONG > 8
394# define int64 long long
395# define SIZEOF_INT64 SIZEOF_LONG_LONG
71c46176 396#else
736a6a29 397/* As long as it gets... */
d622d4bf
WD
398# define int64 off_t
399# define SIZEOF_INT64 SIZEOF_OFF_T
71c46176 400#endif
c627d613 401
6abd193f
MP
402/* Starting from protocol version 26, we always use 64-bit
403 * ino_t and dev_t internally, even if this platform does not
404 * allow files to have 64-bit inums. That's because the
405 * receiver needs to find duplicate (dev,ino) tuples to detect
406 * hardlinks, and it might have files coming from a platform
407 * that has 64-bit inums.
408 *
409 * The only exception is if we're on a platform with no 64-bit type at
410 * all.
411 *
412 * Because we use read_longint() to get these off the wire, if you
413 * transfer devices or hardlinks with dev or inum > 2**32 to a machine
414 * with no 64-bit types then you will get an overflow error. Probably
415 * not many people have that combination of machines, and you can
416 * avoid it by not preserving hardlinks or not transferring device
417 * nodes. It's not clear that any other behaviour is better.
418 *
419 * Note that if you transfer devices from a 64-bit-devt machine (say,
420 * Solaris) to a 32-bit-devt machine (say, Linux-2.2/x86) then the
421 * device numbers will be truncated. But it's a kind of silly thing
422 * to do anyhow.
b9df3bf2 423 *
33a2361c
WD
424 * FIXME: I don't think the code in flist.c has ever worked on a system
425 * where dev_t is a struct.
d622d4bf 426 */
33a2361c
WD
427
428struct idev {
d06f6328
WD
429 int64 inode;
430 int64 dev;
33a2361c 431};
c29ee43d 432
c627d613
AT
433#ifndef MIN
434#define MIN(a,b) ((a)<(b)?(a):(b))
435#endif
436
437#ifndef MAX
438#define MAX(a,b) ((a)>(b)?(a):(b))
439#endif
440
d41c7d02
DD
441#ifndef MAXHOSTNAMELEN
442#define MAXHOSTNAMELEN 256
443#endif
444
c627d613 445/* the length of the md4 checksum */
ebb0a6f6 446#define MD4_SUM_LENGTH 16
c627d613 447#define SUM_LENGTH 16
195bd906
S
448#define SHORT_SUM_LENGTH 2
449#define BLOCKSUM_BIAS 10
c627d613
AT
450
451#ifndef MAXPATHLEN
452#define MAXPATHLEN 1024
453#endif
454
52d3e106
S
455#ifndef NAME_MAX
456#define NAME_MAX 255
457#endif
458
0473e2a1
AT
459#ifndef INADDR_NONE
460#define INADDR_NONE 0xffffffff
461#endif
462
bda41fa5
WD
463#ifndef IN_LOOPBACKNET
464#define IN_LOOPBACKNET 127
465#endif
466
25bd9945 467#define GID_NONE ((gid_t)-1)
a60e2dca 468
520cf417
WD
469#define HL_CHECK_MASTER 0
470#define HL_SKIP 1
471
88a7fb3e 472struct hlink {
88a7fb3e 473 struct file_struct *next;
2b2ea368 474 int hlindex;
88a7fb3e
WD
475};
476
88a7fb3e
WD
477#define F_DEV link_u.idev->dev
478#define F_INODE link_u.idev->inode
479
520cf417 480#define F_HLINDEX link_u.links->hlindex
fe70ad26
WD
481#define F_NEXT link_u.links->next
482
c627d613 483struct file_struct {
80707c98 484 union {
af107f6c 485 dev_t rdev; /* The device number, if this is a device */
80707c98 486 char *sum; /* Only a normal file can have a checksum */
af107f6c 487 char *link; /* Points to symlink string, if a symlink */
80707c98 488 } u;
0596df00 489 OFF_T length;
f8057304
WD
490 char *basename; /* The current item's name (AKA filename) */
491 char *dirname; /* The directory info inside the transfer */
492 union {
493 char *root; /* Sender-side dir info outside transfer */
494 int depth; /* Receiver-side directory depth info */
495 } dir;
88a7fb3e
WD
496 union {
497 struct idev *idev;
498 struct hlink *links;
499 } link_u;
0596df00 500 time_t modtime;
88a7fb3e
WD
501 uid_t uid;
502 gid_t gid;
0596df00 503 mode_t mode;
5009de7d 504 uchar flags; /* this item MUST remain last */
c627d613
AT
505};
506
a85906c7
S
507/*
508 * Start the flist array at FLIST_START entries and grow it
509 * by doubling until FLIST_LINEAR then grow by FLIST_LINEAR
510 */
511#define FLIST_START (32 * 1024)
512#define FLIST_LINEAR (FLIST_START * 512)
b96efc2f 513
9935066b
S
514/*
515 * Extent size for allocation pools A minimum size of 128KB
516 * is needed to mmap them so that freeing will release the
517 * space to the OS.
518 *
519 * Larger sizes reduce leftover fragments and speed free calls
520 * (when they happen) Smaller sizes increase the chance of
521 * freed allocations freeing whole extents.
522 */
9935066b
S
523#define FILE_EXTENT (256 * 1024)
524#define HLINK_EXTENT (128 * 1024)
525
526#define WITH_HLINK 1
527#define WITHOUT_HLINK 0
3d382777 528
c627d613 529struct file_list {
2b2ea368 530 struct file_struct **files;
9935066b
S
531 alloc_pool_t file_pool;
532 alloc_pool_t hlink_pool;
2b2ea368
WD
533 int count;
534 int malloced;
f8057304 535 int low, high;
c627d613
AT
536};
537
a3221d2a
WD
538#define SUMFLG_SAME_OFFSET (1<<0)
539
c627d613 540struct sum_buf {
6ded1170 541 OFF_T offset; /**< offset in file of this chunk */
a06b419d 542 int32 len; /**< length of chunk of file */
6ded1170 543 uint32 sum1; /**< simple checksum */
a3221d2a 544 short flags; /**< flag bits */
6ded1170 545 char sum2[SUM_LENGTH]; /**< checksum */
c627d613
AT
546};
547
548struct sum_struct {
6ded1170 549 OFF_T flength; /**< total file length */
2b2ea368 550 struct sum_buf *sums; /**< points to info for each chunk */
15859584 551 int32 count; /**< how many chunks */
a06b419d
WD
552 int32 blength; /**< block_length */
553 int32 remainder; /**< flength % block_length */
da9d12f5 554 int s2length; /**< sum2_length */
c627d613
AT
555};
556
c6e7fcb4 557struct map_struct {
6a7cc46c
S
558 OFF_T file_size; /* File size (from stat) */
559 OFF_T p_offset; /* Window start */
560 OFF_T p_fd_offset; /* offset of cursor in fd ala lseek */
2b2ea368
WD
561 char *p; /* Window pointer */
562 int32 p_size; /* Largest window size we allocated */
563 int32 p_len; /* Latest (rounded) window size */
564 int32 def_window_size; /* Default window size */
565 int fd; /* File Descriptor */
566 int status; /* first errno from read errors */
c6e7fcb4 567};
c627d613 568
e2d22fee
WD
569#define MATCHFLG_WILD (1<<0) /* pattern has '*', '[', and/or '?' */
570#define MATCHFLG_WILD2 (1<<1) /* pattern has '**' */
571#define MATCHFLG_WILD2_PREFIX (1<<2) /* pattern starts with '**' */
572#define MATCHFLG_ABS_PATH (1<<3) /* path-match on absolute path */
669a3192
WD
573#define MATCHFLG_INCLUDE (1<<4) /* this is an include, not an exclude */
574#define MATCHFLG_DIRECTORY (1<<5) /* this matches only directories */
575#define MATCHFLG_CLEAR_LIST (1<<6) /* this item is the "!" token */
46fa6025
WD
576#define MATCHFLG_WORD_SPLIT (1<<7) /* split rules on whitespace */
577#define MATCHFLG_NO_INHERIT (1<<8) /* don't inherit these rules */
578#define MATCHFLG_NO_PREFIXES (1<<9) /* parse no prefixes from patterns */
579#define MATCHFLG_MERGE_FILE (1<<10)/* specifies a file to merge */
580#define MATCHFLG_PERDIR_MERGE (1<<11)/* merge-file is searched per-dir */
581#define MATCHFLG_EXCLUDE_SELF (1<<12)/* merge-file name should be excluded */
582#define MATCHFLG_FINISH_SETUP (1<<13)/* per-dir merge file needs setup */
53b417e4
WD
583#define MATCHFLG_NEGATE (1<<14)/* rule matches when pattern does not */
584#define MATCHFLG_CVS_IGNORE (1<<15)/* rule was -C or :C */
a427e893
WD
585#define MATCHFLG_SENDER_SIDE (1<<16)/* rule applies to the sending side */
586#define MATCHFLG_RECEIVER_SIDE (1<<17)/* rule applies to the receiving side */
7c8e23bd 587
3b2461cf 588#define MATCHFLGS_FROM_CONTAINER (MATCHFLG_ABS_PATH | MATCHFLG_INCLUDE \
a427e893
WD
589 | MATCHFLG_DIRECTORY | MATCHFLG_SENDER_SIDE \
590 | MATCHFLG_NEGATE | MATCHFLG_RECEIVER_SIDE)
3b2461cf 591
7842418b
WD
592struct filter_struct {
593 struct filter_struct *next;
2b6b4d53 594 char *pattern;
53b417e4 595 uint32 match_flags;
46fa6025
WD
596 union {
597 int slash_cnt;
7842418b 598 struct filter_list_struct *mergelist;
46fa6025 599 } u;
2b6b4d53
AT
600};
601
7842418b
WD
602struct filter_list_struct {
603 struct filter_struct *head;
604 struct filter_struct *tail;
ac1d2d33 605 char *debug_type;
63d03319
WD
606};
607
a800434a
AT
608struct stats {
609 int64 total_size;
610 int64 total_transferred_size;
611 int64 total_written;
612 int64 total_read;
613 int64 literal_data;
614 int64 matched_data;
d4198823
WD
615 int64 flist_buildtime;
616 int64 flist_xfertime;
a800434a
AT
617 int flist_size;
618 int num_files;
619 int num_transferred_files;
dc8293ff 620 int current_file_index;
a800434a
AT
621};
622
2b6b4d53 623
c627d613 624#include "byteorder.h"
8de330a3 625#include "lib/mdfour.h"
87f18b62 626#include "lib/wildmatch.h"
740819ef 627#include "lib/permstring.h"
e20a4f84 628#include "lib/addrinfo.h"
0de40240 629
58c29609
MP
630#include "proto.h"
631
0de40240 632/* We have replacement versions of these if they're missing. */
4f5b0756 633#ifndef HAVE_ASPRINTF
0de40240
MP
634int asprintf(char **ptr, const char *format, ...);
635#endif
636
4f5b0756 637#ifndef HAVE_VASPRINTF
0de40240
MP
638int vasprintf(char **ptr, const char *format, va_list ap);
639#endif
640
4f5b0756 641#if !defined HAVE_VSNPRINTF || !defined HAVE_C99_VSNPRINTF
6813fa7e
WD
642#define vsnprintf rsync_vsnprintf
643int vsnprintf(char *str, size_t count, const char *fmt, va_list args);
0de40240
MP
644#endif
645
4f5b0756 646#if !defined HAVE_SNPRINTF || !defined HAVE_C99_VSNPRINTF
6813fa7e 647#define snprintf rsync_snprintf
0de40240
MP
648int snprintf(char *str,size_t count,const char *fmt,...);
649#endif
650
651
4f5b0756 652#ifndef HAVE_STRERROR
c627d613
AT
653extern char *sys_errlist[];
654#define strerror(i) sys_errlist[i]
655#endif
656
4f5b0756 657#ifndef HAVE_STRCHR
c627d613
AT
658# define strchr index
659# define strrchr rindex
660#endif
661
4f5b0756 662#ifndef HAVE_ERRNO_DECL
c627d613
AT
663extern int errno;
664#endif
665
cbbe4892 666#define SUPPORT_LINKS HAVE_READLINK
dc5ddbcc 667#define SUPPORT_HARD_LINKS HAVE_LINK
c627d613 668
ac1eb754 669#define SIGNAL_CAST (RETSIGTYPE (*)())
720b47f2
AT
670
671#ifndef EWOULDBLOCK
672#define EWOULDBLOCK EAGAIN
673#endif
182dca5c 674
7b8356d0
AT
675#ifndef STDIN_FILENO
676#define STDIN_FILENO 0
677#endif
678
679#ifndef STDOUT_FILENO
680#define STDOUT_FILENO 1
681#endif
682
683#ifndef STDERR_FILENO
684#define STDERR_FILENO 2
685#endif
686
8120a98f
WD
687#ifndef S_IRUSR
688#define S_IRUSR 0400
689#endif
690
7b8356d0
AT
691#ifndef S_IWUSR
692#define S_IWUSR 0200
693#endif
694
b0d791bb
PG
695#ifndef ACCESSPERMS
696#define ACCESSPERMS 0777
697#endif
698
699#ifndef S_ISVTX
700#define S_ISVTX 0
701#endif
702
703#define CHMOD_BITS (S_ISUID | S_ISGID | S_ISVTX | ACCESSPERMS)
704
b280a1f4
AT
705#ifndef _S_IFMT
706#define _S_IFMT 0170000
707#endif
708
709#ifndef _S_IFLNK
710#define _S_IFLNK 0120000
711#endif
712
713#ifndef S_ISLNK
714#define S_ISLNK(mode) (((mode) & (_S_IFMT)) == (_S_IFLNK))
715#endif
716
1e9f155a
AT
717#ifndef S_ISBLK
718#define S_ISBLK(mode) (((mode) & (_S_IFMT)) == (_S_IFBLK))
719#endif
720
721#ifndef S_ISCHR
722#define S_ISCHR(mode) (((mode) & (_S_IFMT)) == (_S_IFCHR))
723#endif
724
a0b65b18
AT
725#ifndef S_ISSOCK
726#ifdef _S_IFSOCK
727#define S_ISSOCK(mode) (((mode) & (_S_IFMT)) == (_S_IFSOCK))
728#else
729#define S_ISSOCK(mode) (0)
730#endif
731#endif
732
733#ifndef S_ISFIFO
734#ifdef _S_IFIFO
735#define S_ISFIFO(mode) (((mode) & (_S_IFMT)) == (_S_IFIFO))
736#else
737#define S_ISFIFO(mode) (0)
738#endif
739#endif
740
1e9f155a
AT
741#ifndef S_ISDIR
742#define S_ISDIR(mode) (((mode) & (_S_IFMT)) == (_S_IFDIR))
743#endif
744
745#ifndef S_ISREG
746#define S_ISREG(mode) (((mode) & (_S_IFMT)) == (_S_IFREG))
747#endif
748
f0359dd0
AT
749/* work out what fcntl flag to use for non-blocking */
750#ifdef O_NONBLOCK
751# define NONBLOCK_FLAG O_NONBLOCK
4f5b0756 752#elif defined SYSV
f0359dd0 753# define NONBLOCK_FLAG O_NDELAY
d622d4bf 754#else
f0359dd0
AT
755# define NONBLOCK_FLAG FNDELAY
756#endif
757
d79c77ca
MP
758#ifndef INADDR_LOOPBACK
759#define INADDR_LOOPBACK 0x7f000001
760#endif
761
762#ifndef INADDR_NONE
763#define INADDR_NONE 0xffffffff
764#endif
a0b65b18
AT
765
766#define IS_DEVICE(mode) (S_ISCHR(mode) || S_ISBLK(mode) || S_ISSOCK(mode) || S_ISFIFO(mode))
7bec6a5c 767
5afd8aed
DD
768/* Initial mask on permissions given to temporary files. Mask off setuid
769 bits and group access because of potential race-condition security
770 holes, and mask other access because mode 707 is bizarre */
972a3619 771#define INITACCESSPERMS 0700
e08bfe12
AT
772
773/* handler for null strings in printf format */
719bc858 774#define NS(s) ((s)?safe_fname(s):"<NULL>")
e08bfe12 775
96a8ca6d 776#if !defined __GNUC__ || defined __APPLE__
999dfffc
MP
777/* Apparently the OS X port of gcc gags on __attribute__.
778 *
779 * <http://www.opensource.apple.com/bugs/X/gcc/2512150.html> */
d622d4bf 780#define __attribute__(x)
fb859e56
MP
781
782#endif
783
58cadc86
WD
784/* Convenient wrappers for malloc and realloc. Use them. */
785#define new(type) ((type *)malloc(sizeof(type)))
786#define new_array(type, num) ((type *)_new_array(sizeof(type), (num)))
787#define realloc_array(ptr, type, num) ((type *)_realloc_array((ptr), sizeof(type), (num)))
fb859e56 788
e08bfe12 789/* use magic gcc attributes to catch format errors */
ff41a59f 790 void rprintf(enum logcode , const char *, ...)
fb859e56 791 __attribute__((format (printf, 2, 3)))
e08bfe12 792;
7b3d4257 793
a039749b
MP
794/* This is just like rprintf, but it also tries to print some
795 * representation of the error code. Normally errcode = errno. */
796void rsyserr(enum logcode, int, const char *, ...)
fb859e56 797 __attribute__((format (printf, 3, 4)))
a039749b
MP
798 ;
799
4f5b0756 800#ifdef REPLACE_INET_NTOA
7b3d4257
AT
801#define inet_ntoa rep_inet_ntoa
802#endif
5a788ade 803
afbcc8f2
WD
804/* Make sure that the O_BINARY flag is defined. */
805#ifndef O_BINARY
806#define O_BINARY 0
807#endif
5a788ade 808
4f5b0756 809#ifndef HAVE_STRLCPY
5a788ade
AT
810size_t strlcpy(char *d, const char *s, size_t bufsize);
811#endif
812
4f5b0756 813#ifndef HAVE_STRLCAT
5a788ade
AT
814size_t strlcat(char *d, const char *s, size_t bufsize);
815#endif
816
82980a23
AT
817#ifndef WEXITSTATUS
818#define WEXITSTATUS(stat) ((int)(((stat)>>8)&0xFF))
819#endif
820
a9766ef1 821#define exit_cleanup(code) _exit_cleanup(code, __FILE__, __LINE__)
eecd22ff 822
4f5b0756 823#ifdef HAVE_GETEUID
b2bffbb2
WD
824#define MY_UID() geteuid()
825#else
826#define MY_UID() getuid()
827#endif
828
4f5b0756 829#ifdef HAVE_GETEGID
b2bffbb2
WD
830#define MY_GID() getegid()
831#else
832#define MY_GID() getgid()
833#endif
eecd22ff
MP
834
835extern int verbose;
d5d4b282 836
4f5b0756 837#ifndef HAVE_INET_NTOP
d622d4bf 838const char *inet_ntop(int af, const void *src, char *dst, size_t size);
4f5b0756 839#endif
8f694072 840
4f5b0756 841#ifndef HAVE_INET_PTON
bda41fa5 842int inet_pton(int af, const char *src, void *dst);
8f694072 843#endif
0f0ea7f7 844
f4a0483a
MP
845#ifdef MAINTAINER_MODE
846const char *get_panic_action(void);
847#endif
848
fb859e56 849#define UNUSED(x) x __attribute__((__unused__))
eca2adb4 850
c80b3d8c 851extern const char *io_write_phase, *io_read_phase;