added new include/exclude options to man page
[rsync/rsync.git] / rsync.h
CommitLineData
c627d613
AT
1/*
2 Copyright (C) Andrew Tridgell 1996
3 Copyright (C) Paul Mackerras 1996
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18*/
19
20#define BLOCK_SIZE 700
21#define RSYNC_RSH_ENV "RSYNC_RSH"
7b8356d0 22
c627d613 23#define RSYNC_NAME "rsync"
f0fca04e 24#define RSYNCD_CONF "/etc/rsyncd.conf"
f0fca04e 25
c627d613
AT
26#define BACKUP_SUFFIX "~"
27
1b01b295
AT
28/* a non-zero CHAR_OFFSET makes the rolling sum stronger, but is
29 imcompatible with older versions :-( */
30#define CHAR_OFFSET 0
31
32
3333ffbd 33#define FLAG_DELETE (1<<0)
4fe159a8 34#define SAME_MODE (1<<1)
dc5ddbcc 35#define SAME_RDEV (1<<2)
4fe159a8
AT
36#define SAME_UID (1<<3)
37#define SAME_GID (1<<4)
38#define SAME_DIR (1<<5)
39#define SAME_NAME SAME_DIR
40#define LONG_NAME (1<<6)
41#define SAME_TIME (1<<7)
42
c627d613 43/* update this if you make incompatible changes */
7b1ce0d7 44#define PROTOCOL_VERSION 19
3ec4dd97 45#define MIN_PROTOCOL_VERSION 11
6ba9279f 46#define MAX_PROTOCOL_VERSION 30
c627d613 47
9486289c
AT
48#define RSYNC_PORT 873
49
d867229b 50#define SPARSE_WRITE_SIZE (1024)
dc5ddbcc 51#define WRITE_SIZE (32*1024)
34ccb63e 52#define CHUNK_SIZE (32*1024)
2f326946 53#define MAX_MAP_SIZE (1*1024*1024)
d6dead6b 54#define IO_BUFFER_SIZE (4096)
5dd7e031 55#define MAX_READ_BUFFER (1024*1024)
c627d613 56
874895d5 57#define MAX_ARGS 1000
f0fca04e 58
8d9dc9f9 59#define MPLEX_BASE 7
9486289c
AT
60#define FERROR 1
61#define FINFO 2
7bec6a5c 62
c627d613
AT
63#include "config.h"
64
24d95c03
AT
65#if HAVE_REMSH
66#define RSYNC_RSH "remsh"
67#else
68#define RSYNC_RSH "rsh"
69#endif
70
c627d613
AT
71#include <sys/types.h>
72#ifdef HAVE_UNISTD_H
73#include <unistd.h>
74#endif
75#include <stdio.h>
3591c066 76#include <stddef.h>
c627d613
AT
77
78#ifdef HAVE_SYS_PARAM_H
79#include <sys/param.h>
80#endif
81
d7b305fd
AT
82#ifdef HAVE_STDLIB_H
83#include <stdlib.h>
84#endif
85
fdd71e17
AT
86#ifdef HAVE_SYS_SOCKET_H
87#include <sys/socket.h>
88#endif
89
d7b305fd
AT
90#ifdef HAVE_STRING_H
91#include <string.h>
c627d613
AT
92#endif
93
94#ifdef HAVE_COMPAT_H
95#include <compat.h>
96#endif
97
98#ifdef HAVE_MALLOC_H
99#include <malloc.h>
100#endif
101
102#ifdef TIME_WITH_SYS_TIME
103#include <sys/time.h>
104#include <time.h>
105#else
106#ifdef HAVE_SYS_TIME_H
107#include <sys/time.h>
108#else
109#include <time.h>
110#endif
111#endif
112
113#ifdef HAVE_FCNTL_H
114#include <fcntl.h>
115#else
116#ifdef HAVE_SYS_FCNTL_H
117#include <sys/fcntl.h>
118#endif
119#endif
120
121#include <sys/stat.h>
122
94481d91
AT
123#ifdef HAVE_SYS_IOCTL_H
124#include <sys/ioctl.h>
125#endif
126
127#ifdef HAVE_SYS_FILIO_H
128#include <sys/filio.h>
129#endif
130
c627d613
AT
131#include <signal.h>
132#ifdef HAVE_SYS_WAIT_H
133#include <sys/wait.h>
134#endif
135#ifdef HAVE_CTYPE_H
136#include <ctype.h>
137#endif
138#ifdef HAVE_GRP_H
139#include <grp.h>
140#endif
141#include <errno.h>
142
bb0f7089 143#if defined(HAVE_MMAP) && defined(HAVE_MUNMAP)
c627d613 144#include <sys/mman.h>
bb0f7089 145#define USE_MMAP 1
7bec6a5c
AT
146#endif
147
c627d613
AT
148#ifdef HAVE_UTIME_H
149#include <utime.h>
150#endif
151
8bf73749
AT
152#ifdef HAVE_SYS_SELECT_H
153#include <sys/select.h>
154#endif
155
773f2bd4
AT
156#ifdef HAVE_SYS_MODE_H
157/* apparently AIX needs this for S_ISLNK */
05a6556d 158#ifndef S_ISLNK
773f2bd4
AT
159#include <sys/mode.h>
160#endif
05a6556d 161#endif
773f2bd4 162
c627d613
AT
163#ifdef HAVE_FNMATCH
164#include <fnmatch.h>
165#else
166#include "lib/fnmatch.h"
167#endif
168
169#ifdef HAVE_GETOPT_LONG
170#include <getopt.h>
171#else
172#include "lib/getopt.h"
173#endif
174
874895d5
AT
175#ifdef HAVE_GLOB
176#include <glob.h>
177#endif
178
f6c34742
AT
179/* these are needed for the uid/gid mapping code */
180#include <pwd.h>
181#include <grp.h>
182
9486289c 183#include <stdarg.h>
f0fca04e
AT
184#include <netinet/in.h>
185#include <arpa/inet.h>
186#include <netdb.h>
ff8b29b8 187#include <syslog.h>
6c8f5373 188#include <sys/file.h>
9486289c 189
cbbe4892
AT
190#ifndef S_IFLNK
191#define S_IFLNK 0120000
192#endif
c627d613
AT
193
194#ifndef S_ISLNK
195#define S_ISLNK(mode) (((mode) & S_IFLNK) == S_IFLNK)
196#endif
197
f0fca04e
AT
198#define BOOL int
199
c627d613
AT
200#ifndef uchar
201#define uchar unsigned char
202#endif
203
debb4505
AT
204#if HAVE_UNSIGNED_CHAR
205#define schar signed char
206#else
207#define schar char
208#endif
209
c627d613
AT
210#ifndef int32
211#if (SIZEOF_INT == 4)
212#define int32 int
213#elif (SIZEOF_LONG == 4)
214#define int32 long
215#elif (SIZEOF_SHORT == 4)
216#define int32 short
217#endif
218#endif
219
220#ifndef uint32
221#define uint32 unsigned int32
222#endif
223
bcacc18b
AT
224#if HAVE_OFF64_T
225#define OFF_T off64_t
226#define STRUCT_STAT struct stat64
227#else
228#define OFF_T off_t
229#define STRUCT_STAT struct stat
230#endif
231
232#if HAVE_OFF64_T
233#define int64 off64_t
234#elif (SIZEOF_LONG == 8)
3bee6733
AT
235#define int64 long
236#elif (SIZEOF_INT == 8)
237#define int64 int
238#elif HAVE_LONGLONG
71c46176
AT
239#define int64 long long
240#else
241#define int64 off_t
3bee6733 242#define NO_INT64
71c46176 243#endif
c627d613
AT
244
245#ifndef MIN
246#define MIN(a,b) ((a)<(b)?(a):(b))
247#endif
248
249#ifndef MAX
250#define MAX(a,b) ((a)>(b)?(a):(b))
251#endif
252
253/* the length of the md4 checksum */
ebb0a6f6 254#define MD4_SUM_LENGTH 16
c627d613
AT
255#define SUM_LENGTH 16
256
257#ifndef MAXPATHLEN
258#define MAXPATHLEN 1024
259#endif
260
0473e2a1
AT
261#ifndef INADDR_NONE
262#define INADDR_NONE 0xffffffff
263#endif
264
c627d613 265struct file_struct {
3333ffbd 266 unsigned flags;
3ec4dd97 267 time_t modtime;
bcacc18b 268 OFF_T length;
3ec4dd97
AT
269 mode_t mode;
270 ino_t inode;
271 dev_t dev;
272 dev_t rdev;
273 uid_t uid;
274 gid_t gid;
275 char *basename;
276 char *dirname;
277 char *basedir;
278 char *link;
2d0bb8eb 279 char *sum;
c627d613
AT
280};
281
282struct file_list {
283 int count;
284 int malloced;
3ec4dd97 285 struct file_struct **files;
c627d613
AT
286};
287
288struct sum_buf {
bcacc18b 289 OFF_T offset; /* offset in file of this chunk */
c627d613
AT
290 int len; /* length of chunk of file */
291 int i; /* index of this chunk */
292 uint32 sum1; /* simple checksum */
ebb0a6f6 293 char sum2[SUM_LENGTH]; /* checksum */
c627d613
AT
294};
295
296struct sum_struct {
bcacc18b 297 OFF_T flength; /* total file length */
c627d613
AT
298 int count; /* how many chunks */
299 int remainder; /* flength % block_length */
300 int n; /* block_length */
301 struct sum_buf *sums; /* points to info for each chunk */
302};
303
c6e7fcb4 304struct map_struct {
0b910560
AT
305 char *map,*p;
306 int fd,p_size,p_len;
bcacc18b 307 OFF_T size, p_offset;
c6e7fcb4 308};
c627d613 309
2b6b4d53
AT
310struct exclude_struct {
311 char *orig;
312 char *pattern;
313 int regular_exp;
314 int include;
315 int directory;
316 int local;
317};
318
319
3b3a2fbc
AT
320/* we need this function because of the silly way in which duplicate
321 entries are handled in the file lists - we can't change this
322 without breaking existing versions */
71c46176 323static inline int flist_up(struct file_list *flist, int i)
3b3a2fbc 324{
3ec4dd97 325 while (!flist->files[i]->basename) i++;
3b3a2fbc
AT
326 return i;
327}
328
d6e6ecbd
AT
329#if HAVE_DIRENT_H
330# include <dirent.h>
331#else
332# define dirent direct
333# if HAVE_SYS_NDIR_H
334# include <sys/ndir.h>
335# endif
336# if HAVE_SYS_DIR_H
337# include <sys/dir.h>
338# endif
339# if HAVE_NDIR_H
340# include <ndir.h>
341# endif
342#endif
3b3a2fbc 343
c627d613
AT
344#include "byteorder.h"
345#include "version.h"
346#include "proto.h"
347#include "md4.h"
348
349#if !HAVE_STRERROR
350extern char *sys_errlist[];
351#define strerror(i) sys_errlist[i]
352#endif
353
354#ifndef HAVE_STRCHR
355# define strchr index
356# define strrchr rindex
357#endif
358
c627d613
AT
359#ifndef HAVE_ERRNO_DECL
360extern int errno;
361#endif
362
363#ifndef HAVE_BCOPY
364#define bcopy(src,dest,n) memcpy(dest,src,n)
365#endif
366
367#ifndef HAVE_BZERO
368#define bzero(buf,n) memset(buf,0,n)
369#endif
370
cbbe4892 371#define SUPPORT_LINKS HAVE_READLINK
dc5ddbcc 372#define SUPPORT_HARD_LINKS HAVE_LINK
c627d613 373
8bf73749
AT
374#ifndef HAVE_LCHOWN
375#define lchown chown
376#endif
377
ac1eb754 378#define SIGNAL_CAST (RETSIGTYPE (*)())
720b47f2
AT
379
380#ifndef EWOULDBLOCK
381#define EWOULDBLOCK EAGAIN
382#endif
182dca5c 383
7b8356d0
AT
384#ifndef STDIN_FILENO
385#define STDIN_FILENO 0
386#endif
387
388#ifndef STDOUT_FILENO
389#define STDOUT_FILENO 1
390#endif
391
392#ifndef STDERR_FILENO
393#define STDERR_FILENO 2
394#endif
395
396#ifndef S_IWUSR
397#define S_IWUSR 0200
398#endif
399
1e9f155a
AT
400#ifndef S_ISBLK
401#define S_ISBLK(mode) (((mode) & (_S_IFMT)) == (_S_IFBLK))
402#endif
403
404#ifndef S_ISCHR
405#define S_ISCHR(mode) (((mode) & (_S_IFMT)) == (_S_IFCHR))
406#endif
407
a0b65b18
AT
408#ifndef S_ISSOCK
409#ifdef _S_IFSOCK
410#define S_ISSOCK(mode) (((mode) & (_S_IFMT)) == (_S_IFSOCK))
411#else
412#define S_ISSOCK(mode) (0)
413#endif
414#endif
415
416#ifndef S_ISFIFO
417#ifdef _S_IFIFO
418#define S_ISFIFO(mode) (((mode) & (_S_IFMT)) == (_S_IFIFO))
419#else
420#define S_ISFIFO(mode) (0)
421#endif
422#endif
423
1e9f155a
AT
424#ifndef S_ISDIR
425#define S_ISDIR(mode) (((mode) & (_S_IFMT)) == (_S_IFDIR))
426#endif
427
428#ifndef S_ISREG
429#define S_ISREG(mode) (((mode) & (_S_IFMT)) == (_S_IFREG))
430#endif
431
a0b65b18
AT
432
433#define IS_DEVICE(mode) (S_ISCHR(mode) || S_ISBLK(mode) || S_ISSOCK(mode) || S_ISFIFO(mode))
7bec6a5c 434