GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
NSPATCH(1) User Contributed Perl Documentation NSPATCH(1)

nspatch - run `nsdiff | nsupdate` with error handling

nspatch [-hVv] [-r count] -- [nsdiff options] -- [nsupdate options]

The nspatch utility runs `"nsdiff | nsupdate"` and checks that both programs complete successfully. It suppresses their output unless there is an error, in a manner suitable for running from cron.

The nsupdate script produced by nsdiff includes a prerequisite check to detect and fail if there is a concurrent update. These failures are detected by nspatch which retries the update.

Rather than using a pipe, nspatch uses temporary files to store the output of nsdiff and nsupdate.

-h
Display this documentation.
-V
Display version information.
-r count
If the update fails because of a concurrent update, nspatch will retry up to count times. The default retry count is 2.
-v
Turn on verbose mode, so the output from nsdiff and nsupdate is printed even if they are successful. (By default it is suppressed.)

The verbose option is passed on to nsdiff. If nspatch is not given the -v option, it passes the -v '' option to nsdiff. If nspatch is given the -v option, it passes the -v 'qr' option to nsdiff.

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

"TMPDIR"
Location for temporary files.

  This is nspatch-1.82 <https://dotat.at/prog/nsdiff/>

  Written by Tony Finch <fanf2@cam.ac.uk> <dot@dotat.at>
  at Cambridge University Information Services.
  You may do anything with this. It has no warranty.
  <https://creativecommons.org/publicdomain/zero/1.0/>

nsdiff(1), nsupdate(1), cron(8)
2020-07-03 perl v5.32.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.