Ran yodl2man on rsync.yo, and updated modification date.
[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
f7632fc6
AT
26#define URL_PREFIX "rsync://"
27
c627d613
AT
28#define BACKUP_SUFFIX "~"
29
1b01b295
AT
30/* a non-zero CHAR_OFFSET makes the rolling sum stronger, but is
31 imcompatible with older versions :-( */
32#define CHAR_OFFSET 0
33
34
3333ffbd 35#define FLAG_DELETE (1<<0)
4fe159a8 36#define SAME_MODE (1<<1)
dc5ddbcc 37#define SAME_RDEV (1<<2)
4fe159a8
AT
38#define SAME_UID (1<<3)
39#define SAME_GID (1<<4)
40#define SAME_DIR (1<<5)
41#define SAME_NAME SAME_DIR
42#define LONG_NAME (1<<6)
43#define SAME_TIME (1<<7)
44
c627d613 45/* update this if you make incompatible changes */
7b1ce0d7 46#define PROTOCOL_VERSION 19
3ec4dd97 47#define MIN_PROTOCOL_VERSION 11
6ba9279f 48#define MAX_PROTOCOL_VERSION 30
c627d613 49
9486289c
AT
50#define RSYNC_PORT 873
51
d867229b 52#define SPARSE_WRITE_SIZE (1024)
dc5ddbcc 53#define WRITE_SIZE (32*1024)
34ccb63e 54#define CHUNK_SIZE (32*1024)
4440b8aa 55#define MAX_MAP_SIZE (256*1024)
e3fe383a 56#define IO_BUFFER_SIZE (4092)
5dd7e031 57#define MAX_READ_BUFFER (1024*1024)
c627d613 58
874895d5 59#define MAX_ARGS 1000
f0fca04e 60
8d9dc9f9 61#define MPLEX_BASE 7
9486289c
AT
62#define FERROR 1
63#define FINFO 2
11a5a3c7 64#define FLOG 3
7bec6a5c 65
65417579
AT
66#include "errcode.h"
67
c627d613
AT
68#include "config.h"
69
24d95c03
AT
70#if HAVE_REMSH
71#define RSYNC_RSH "remsh"
72#else
73#define RSYNC_RSH "rsh"
74#endif
75
c627d613 76#include <sys/types.h>
6ed67e6d
AT
77
78#ifdef HAVE_GETOPT_LONG
79#include <getopt.h>
80#else
81#include "lib/getopt.h"
82#endif
83
c627d613
AT
84#ifdef HAVE_UNISTD_H
85#include <unistd.h>
86#endif
87#include <stdio.h>
3591c066 88#include <stddef.h>
c627d613
AT
89
90#ifdef HAVE_SYS_PARAM_H
91#include <sys/param.h>
92#endif
93
d7b305fd
AT
94#ifdef HAVE_STDLIB_H
95#include <stdlib.h>
96#endif
97
fdd71e17
AT
98#ifdef HAVE_SYS_SOCKET_H
99#include <sys/socket.h>
100#endif
101
d7b305fd
AT
102#ifdef HAVE_STRING_H
103#include <string.h>
c627d613
AT
104#endif
105
c627d613
AT
106#ifdef HAVE_MALLOC_H
107#include <malloc.h>
108#endif
109
110#ifdef TIME_WITH_SYS_TIME
111#include <sys/time.h>
112#include <time.h>
113#else
114#ifdef HAVE_SYS_TIME_H
115#include <sys/time.h>
116#else
117#include <time.h>
118#endif
119#endif
120
121#ifdef HAVE_FCNTL_H
122#include <fcntl.h>
123#else
124#ifdef HAVE_SYS_FCNTL_H
125#include <sys/fcntl.h>
126#endif
127#endif
128
129#include <sys/stat.h>
130
94481d91
AT
131#ifdef HAVE_SYS_IOCTL_H
132#include <sys/ioctl.h>
133#endif
134
135#ifdef HAVE_SYS_FILIO_H
136#include <sys/filio.h>
137#endif
138
c627d613
AT
139#include <signal.h>
140#ifdef HAVE_SYS_WAIT_H
141#include <sys/wait.h>
142#endif
143#ifdef HAVE_CTYPE_H
144#include <ctype.h>
145#endif
146#ifdef HAVE_GRP_H
147#include <grp.h>
148#endif
149#include <errno.h>
150
c627d613
AT
151#ifdef HAVE_UTIME_H
152#include <utime.h>
153#endif
154
8bf73749
AT
155#ifdef HAVE_SYS_SELECT_H
156#include <sys/select.h>
157#endif
158
773f2bd4
AT
159#ifdef HAVE_SYS_MODE_H
160/* apparently AIX needs this for S_ISLNK */
05a6556d 161#ifndef S_ISLNK
773f2bd4
AT
162#include <sys/mode.h>
163#endif
05a6556d 164#endif
773f2bd4 165
c627d613
AT
166#ifdef HAVE_FNMATCH
167#include <fnmatch.h>
168#else
169#include "lib/fnmatch.h"
170#endif
171
932be9aa 172#ifdef HAVE_GLOB_H
874895d5
AT
173#include <glob.h>
174#endif
175
f6c34742
AT
176/* these are needed for the uid/gid mapping code */
177#include <pwd.h>
178#include <grp.h>
179
9486289c 180#include <stdarg.h>
f0fca04e
AT
181#include <netinet/in.h>
182#include <arpa/inet.h>
183#include <netdb.h>
ff8b29b8 184#include <syslog.h>
6c8f5373 185#include <sys/file.h>
9486289c 186
e8f5b936
AT
187#if HAVE_DIRENT_H
188# include <dirent.h>
189#else
190# define dirent direct
191# if HAVE_SYS_NDIR_H
192# include <sys/ndir.h>
193# endif
194# if HAVE_SYS_DIR_H
195# include <sys/dir.h>
196# endif
197# if HAVE_NDIR_H
198# include <ndir.h>
199# endif
200#endif
201
202#ifdef HAVE_COMPAT_H
203#include <compat.h>
204#endif
205
206
f0fca04e
AT
207#define BOOL int
208
c627d613
AT
209#ifndef uchar
210#define uchar unsigned char
211#endif
212
debb4505
AT
213#if HAVE_UNSIGNED_CHAR
214#define schar signed char
215#else
216#define schar char
217#endif
218
c627d613
AT
219#ifndef int32
220#if (SIZEOF_INT == 4)
221#define int32 int
222#elif (SIZEOF_LONG == 4)
223#define int32 long
224#elif (SIZEOF_SHORT == 4)
225#define int32 short
8de330a3
AT
226#else
227/* I hope this works */
228#define int32 int
f3737e06 229#define LARGE_INT32
c627d613
AT
230#endif
231#endif
232
233#ifndef uint32
234#define uint32 unsigned int32
235#endif
236
bcacc18b
AT
237#if HAVE_OFF64_T
238#define OFF_T off64_t
239#define STRUCT_STAT struct stat64
240#else
241#define OFF_T off_t
242#define STRUCT_STAT struct stat
243#endif
244
245#if HAVE_OFF64_T
246#define int64 off64_t
247#elif (SIZEOF_LONG == 8)
3bee6733
AT
248#define int64 long
249#elif (SIZEOF_INT == 8)
250#define int64 int
251#elif HAVE_LONGLONG
71c46176
AT
252#define int64 long long
253#else
254#define int64 off_t
3bee6733 255#define NO_INT64
71c46176 256#endif
c627d613 257
c29ee43d
AT
258#if HAVE_SHORT_INO_T
259#define INO_T uint32
260#else
261#define INO_T ino_t
262#endif
263
c627d613
AT
264#ifndef MIN
265#define MIN(a,b) ((a)<(b)?(a):(b))
266#endif
267
268#ifndef MAX
269#define MAX(a,b) ((a)>(b)?(a):(b))
270#endif
271
272/* the length of the md4 checksum */
ebb0a6f6 273#define MD4_SUM_LENGTH 16
c627d613
AT
274#define SUM_LENGTH 16
275
276#ifndef MAXPATHLEN
277#define MAXPATHLEN 1024
278#endif
279
0473e2a1
AT
280#ifndef INADDR_NONE
281#define INADDR_NONE 0xffffffff
282#endif
283
c627d613 284struct file_struct {
3333ffbd 285 unsigned flags;
3ec4dd97 286 time_t modtime;
bcacc18b 287 OFF_T length;
3ec4dd97 288 mode_t mode;
c29ee43d 289 INO_T inode;
3ec4dd97
AT
290 dev_t dev;
291 dev_t rdev;
292 uid_t uid;
293 gid_t gid;
294 char *basename;
295 char *dirname;
296 char *basedir;
297 char *link;
2d0bb8eb 298 char *sum;
c627d613
AT
299};
300
4440b8aa 301
c627d613 302struct file_list {
a800434a
AT
303 int count;
304 int malloced;
305 struct file_struct **files;
c627d613
AT
306};
307
308struct sum_buf {
c29ee43d
AT
309 OFF_T offset; /* offset in file of this chunk */
310 int len; /* length of chunk of file */
311 int i; /* index of this chunk */
312 uint32 sum1; /* simple checksum */
313 char sum2[SUM_LENGTH]; /* checksum */
c627d613
AT
314};
315
316struct sum_struct {
bcacc18b 317 OFF_T flength; /* total file length */
c627d613
AT
318 int count; /* how many chunks */
319 int remainder; /* flength % block_length */
320 int n; /* block_length */
321 struct sum_buf *sums; /* points to info for each chunk */
322};
323
c6e7fcb4 324struct map_struct {
4440b8aa 325 char *p;
0b910560 326 int fd,p_size,p_len;
4440b8aa 327 OFF_T file_size, p_offset, p_fd_offset;
c6e7fcb4 328};
c627d613 329
2b6b4d53
AT
330struct exclude_struct {
331 char *orig;
332 char *pattern;
333 int regular_exp;
334 int include;
335 int directory;
336 int local;
337};
338
a800434a
AT
339struct stats {
340 int64 total_size;
341 int64 total_transferred_size;
342 int64 total_written;
343 int64 total_read;
344 int64 literal_data;
345 int64 matched_data;
346 int flist_size;
347 int num_files;
348 int num_transferred_files;
349};
350
2b6b4d53 351
3b3a2fbc
AT
352/* we need this function because of the silly way in which duplicate
353 entries are handled in the file lists - we can't change this
354 without breaking existing versions */
71c46176 355static inline int flist_up(struct file_list *flist, int i)
3b3a2fbc 356{
3ec4dd97 357 while (!flist->files[i]->basename) i++;
3b3a2fbc
AT
358 return i;
359}
360
c627d613
AT
361#include "byteorder.h"
362#include "version.h"
363#include "proto.h"
8de330a3 364#include "lib/mdfour.h"
c627d613
AT
365
366#if !HAVE_STRERROR
367extern char *sys_errlist[];
368#define strerror(i) sys_errlist[i]
369#endif
370
371#ifndef HAVE_STRCHR
372# define strchr index
373# define strrchr rindex
374#endif
375
c627d613
AT
376#ifndef HAVE_ERRNO_DECL
377extern int errno;
378#endif
379
cbbe4892 380#define SUPPORT_LINKS HAVE_READLINK
dc5ddbcc 381#define SUPPORT_HARD_LINKS HAVE_LINK
c627d613 382
8bf73749
AT
383#ifndef HAVE_LCHOWN
384#define lchown chown
385#endif
386
ac1eb754 387#define SIGNAL_CAST (RETSIGTYPE (*)())
720b47f2
AT
388
389#ifndef EWOULDBLOCK
390#define EWOULDBLOCK EAGAIN
391#endif
182dca5c 392
7b8356d0
AT
393#ifndef STDIN_FILENO
394#define STDIN_FILENO 0
395#endif
396
397#ifndef STDOUT_FILENO
398#define STDOUT_FILENO 1
399#endif
400
401#ifndef STDERR_FILENO
402#define STDERR_FILENO 2
403#endif
404
405#ifndef S_IWUSR
406#define S_IWUSR 0200
407#endif
408
b280a1f4
AT
409#ifndef _S_IFMT
410#define _S_IFMT 0170000
411#endif
412
413#ifndef _S_IFLNK
414#define _S_IFLNK 0120000
415#endif
416
417#ifndef S_ISLNK
418#define S_ISLNK(mode) (((mode) & (_S_IFMT)) == (_S_IFLNK))
419#endif
420
1e9f155a
AT
421#ifndef S_ISBLK
422#define S_ISBLK(mode) (((mode) & (_S_IFMT)) == (_S_IFBLK))
423#endif
424
425#ifndef S_ISCHR
426#define S_ISCHR(mode) (((mode) & (_S_IFMT)) == (_S_IFCHR))
427#endif
428
a0b65b18
AT
429#ifndef S_ISSOCK
430#ifdef _S_IFSOCK
431#define S_ISSOCK(mode) (((mode) & (_S_IFMT)) == (_S_IFSOCK))
432#else
433#define S_ISSOCK(mode) (0)
434#endif
435#endif
436
437#ifndef S_ISFIFO
438#ifdef _S_IFIFO
439#define S_ISFIFO(mode) (((mode) & (_S_IFMT)) == (_S_IFIFO))
440#else
441#define S_ISFIFO(mode) (0)
442#endif
443#endif
444
1e9f155a
AT
445#ifndef S_ISDIR
446#define S_ISDIR(mode) (((mode) & (_S_IFMT)) == (_S_IFDIR))
447#endif
448
449#ifndef S_ISREG
450#define S_ISREG(mode) (((mode) & (_S_IFMT)) == (_S_IFREG))
451#endif
452
a0b65b18
AT
453
454#define IS_DEVICE(mode) (S_ISCHR(mode) || S_ISBLK(mode) || S_ISSOCK(mode) || S_ISFIFO(mode))
7bec6a5c 455
22b19332
AT
456#ifndef ACCESSPERMS
457#define ACCESSPERMS 0777
458#endif
e08bfe12
AT
459
460/* handler for null strings in printf format */
461#define NS(s) ((s)?(s):"<NULL>")
462
463/* use magic gcc attributes to catch format errors */
464 void rprintf(int , const char *, ...)
465#ifdef __GNUC__
466 __attribute__ ((format (printf, 2, 3)))
467#endif
468;
7b3d4257
AT
469
470#ifdef REPLACE_INET_NTOA
471#define inet_ntoa rep_inet_ntoa
472#endif
5a788ade
AT
473
474
475#ifndef HAVE_STRLCPY
476size_t strlcpy(char *d, const char *s, size_t bufsize);
477#endif
478
479#ifndef HAVE_STRLCAT
480size_t strlcat(char *d, const char *s, size_t bufsize);
481#endif
482
a9766ef1 483#define exit_cleanup(code) _exit_cleanup(code, __FILE__, __LINE__)