nspatch(1)

1NSPATCH(1)            User Contributed Perl Documentation           NSPATCH(1)
2
3
4

NAME

6       nspatch - run `nsdiff | nsupdate` with error handling
7

SYNOPSIS

9       nspatch [-hVv] [-r count]
10               -- [nsdiff options] -- [nsupdate options]
11

DESCRIPTION

13       The nspatch utility runs `"nsdiff | nsupdate"` and checks that both
14       programs complete successfully. It suppresses their output unless there
15       is an error, in a manner suitable for running from cron.
16
17       The nsupdate script produced by nsdiff includes a prerequisite check to
18       detect and fail if there is a concurrent update. These failures are
19       detected by nspatch which retries the update.
20
21       Rather than using a pipe, nspatch uses temporary files to store the
22       output of nsdiff and nsupdate.
23

OPTIONS

25       -h  Display this documentation.
26
27       -V  Display version information.
28
29       -r count
30           If the update fails because of a concurrent update, nspatch will
31           retry up to count times. The default retry count is 2.
32
33       -v  Turn on verbose mode, so the output from nsdiff and nsupdate is
34           printed even if they are successful. (By default it is suppressed.)
35
36           The verbose option is passed on to nsdiff. If nspatch is not given
37           the -v option, it passes the -v '' option to nsdiff. If nspatch is
38           given the -v option, it passes the -v 'qr' option to nsdiff.
39

EXIT STATUS

41       The nspatch utility returns 0 if no change is required or if the update
42       is successful, or 1 if there is an error.
43

ENVIRONMENT

45       "TMPDIR"
46           Location for temporary files.
47

VERSION

49         This is nspatch-1.81 <https://dotat.at/prog/nsdiff/>
50
51         Written by Tony Finch <fanf2@cam.ac.uk> <dot@dotat.at>
52         at Cambridge University Information Services.
53         You may do anything with this. It has no warranty.
54         <https://creativecommons.org/publicdomain/zero/1.0/>
55