.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "NSVI 1p"
.TH NSVI 1p 2024-04-21 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
nsvi \- transfer a zone, edit it, then upload the edits
.SH SYNOPSIS
.IX Header "SYNOPSIS"
nsvi [\fB\-01cCdDghvV\fR] [\fB\-k\fR \fIkeyfile\fR] [\fB\-y\fR [\fIhmac\fR:]\fIname\fR:\fIkey\fR]
     [\fB\-S\fR \fImode\fR|\fInum\fR] [\fB\-s\fR \fIserver\fR] <\fIzone\fR>
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBnsvi\fR program makes an AXFR request for the zone, runs your
editor so you can make whatever changes you require, then it runs
\&\fBnsdiff\fR | \fBnsupdate\fR to push those changes to the server.
.PP
Automatically-maintained DNSSEC records are stripped from the zone
before it is passed to your editor, and you do not need to manually
adjust the SOA serial number.
.SH OPTIONS
.IX Header "OPTIONS"
Most \fBnsvi\fR options are passed to \fBnsdiff\fR and some to \fBnsupdate\fR.
.IP \fB\-h\fR 4
.IX Item "-h"
Display this documentation.
.IP \fB\-V\fR 4
.IX Item "-V"
Display version information.
.IP \fB\-v\fR 4
.IX Item "-v"
Verbose mode.
.IP \fB\-n\fR 4
.IX Item "-n"
Interactive confirmation.
.Sp
When you quit the editor, you will be shown the changes, then asked
whether to make the update (press \fBU\fR or \fBY\fR), edit again (press
\&\fBE\fR or \fBR\fR), or quit (press another key).
.IP \fB\-01cCdD\fR 4
.IX Item "-01cCdD"
.PD 0
.IP "\fB\-S\fR \fBmode\fR|\fInum\fR" 4
.IX Item "-S mode|num"
.PD
These options are passed to \fBnsdiff\fR.
For details see the nsdiff manual.
.IP "\fB\-s\fR \fIserver\fR[#\fIport\fR]" 4
.IX Item "-s server[#port]"
Transfer the zone from the server given in this option, and send the
update request to the same place. You can specify the server host name
or IP address, optionally followed by a "#" and the port number.
.Sp
If you do not use the \fB\-s\fR option, the zone will be transferred
from \fIlocalhost\fR, and \fBnsvi\fR will use \fBnsupdate\fR \fB\-l\fR to update
the zone.
.IP \fB\-g\fR 4
.IX Item "-g"
Passed to \fBnsupdate\fR to use GSS-TSIG for UPDATE.
.IP "\fB\-k\fR \fIkeyfile\fR" 4
.IX Item "-k keyfile"
TSIG key file, passed to \fBdig\fR, \fBnsdiff\fR, and \fBnsupdate\fR.
.IP "\fB\-y\fR [\fIhmac\fR:]\fIname\fR:\fIkey\fR" 4
.IX Item "-y [hmac:]name:key"
Literal TSIG key, passed to \fBdig\fR, \fBnsdiff\fR, and \fBnsupdate\fR.
.SH ENVIRONMENT
.IX Header "ENVIRONMENT"
.IP \fBTMPDIR\fR 4
.IX Item "TMPDIR"
Location for temporary files.
.IP \fBVISUAL\fR 4
.IX Item "VISUAL"
.PD 0
.IP \fBEDITOR\fR 4
.IX Item "EDITOR"
.PD
Which editor to use. \f(CW$VISUAL\fR is used if it is set,
otherwise \f(CW$EDITOR\fR, otherwise \fBvi\fR.
.SH VERSION
.IX Header "VERSION"
.Vb 1
\&  This is nsvi\-1.85 <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.
.Ve
.SH ACKNOWLEDGMENTS
.IX Header "ACKNOWLEDGMENTS"
Thanks to Tristan Le Guern for the \fB\-n\fR option and Mantas Mikulėnas
for the \fB\-g\fR option. Thanks to David McBride and Petr Menšík for
providing useful feedback.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBnsdiff\fR\|(1), \fBnsupdate\fR\|(1), \fBdig\fR\|(1).