DESCRIPTION

will be generated. You may view the +manual page with: nroff -man .

| less'. A +typical entry in a Makefile or Makefile.am is: + +DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\ +manpages/docbook.xsl +XP=xsltproc -''-nonet + +manpage.1: manpage.dbk + $(XP) $(DB2MAN) $< + +The xsltproc binary is found in the xsltproc package. The +XSL files are in docbook-xsl. Please remember that if you +create the nroff version in one of the debian/rules file +targets (such as build), you will need to include xsltproc +and docbook-xsl in your Build-Depends control field. + +--> + + + FIRSTNAME"> + SURNAME"> + + November 27, 2006"> + + SECTION"> + heiko@schlittermann.de"> + + UPDATE-SERIAL"> + + + Debian"> + GNU"> + GPL"> +]> + + + +

+ &dhemail; +

+ + &dhfirstname; + &dhsurname; + + + 2003 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + program to do something + + + + &dhpackage; + + + + + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; and bar + commands. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in the &gnu; + Info format; see below. + + &dhpackage; is a program that... + + + + OPTIONS + + These programs follow the usual &gnu; command line syntax, + with long options starting with two dashes (`-'). A summary of + options is included below. For a complete description, see the + Info files. + + + + + + + + Show summary of options. + + + + + + + + Show version of program. + + + + + + SEE ALSO + + bar (1), baz (1). + + The programs are documented fully by The Rise and + Fall of a Fooish Bar available via the + Info system. + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; system (but may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the &gnu; General Public License, Version 2 any + later version published by the Free Software Foundation. + + + On Debian systems, the complete text of the GNU General Public + License can be found in /usr/share/common-licenses/GPL. + + + + + diff -r 000000000000 -r 99443200522e debian/menu.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/menu.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,2 @@ +?package(update-serial):needs="X11|text|vc|wm" section="Apps/see-menu-manual"\ + title="update-serial" command="/usr/bin/update-serial" diff -r 000000000000 -r 99443200522e debian/postinst.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/postinst.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,41 @@ +#!/bin/sh +# postinst script for update-serial +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `configure' +# * `abort-upgrade' +# * `abort-remove' `in-favour' +# +# * `abort-remove' +# * `abort-deconfigure' `in-favour' +# `removing' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + + +case "$1" in + configure) + ;; + + abort-upgrade|abort-remove|abort-deconfigure) + ;; + + *) + echo "postinst called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + + diff -r 000000000000 -r 99443200522e debian/postrm.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/postrm.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,39 @@ +#!/bin/sh +# postrm script for update-serial +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `remove' +# * `purge' +# * `upgrade' +# * `failed-upgrade' +# * `abort-install' +# * `abort-install' +# * `abort-upgrade' +# * `disappear' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + + +case "$1" in + purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear) + ;; + + *) + echo "postrm called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + + diff -r 000000000000 -r 99443200522e debian/preinst.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/preinst.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,37 @@ +#!/bin/sh +# preinst script for update-serial +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `install' +# * `install' +# * `upgrade' +# * `abort-upgrade' +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + + +case "$1" in + install|upgrade) + ;; + + abort-upgrade) + ;; + + *) + echo "preinst called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + + diff -r 000000000000 -r 99443200522e debian/prerm.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/prerm.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,40 @@ +#!/bin/sh +# prerm script for update-serial +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `remove' +# * `upgrade' +# * `failed-upgrade' +# * `remove' `in-favour'

+# * `deconfigure' `in-favour' +# `removing' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + + +case "$1" in + remove|upgrade|deconfigure) + ;; + + failed-upgrade) + ;; + + *) + echo "prerm called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + + diff -r 000000000000 -r 99443200522e debian/rules --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/rules Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,98 @@ +#!/usr/bin/make -f +# -*- makefile -*- +# Sample debian/rules that uses debhelper. +# This file was originally written by Joey Hess and Craig Small. +# As a special exception, when this file is copied by dh-make into a +# dh-make output file, you may use that output file without restriction. +# This special exception was added by Craig Small in version 0.37 of dh-make. + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + + + + +CFLAGS = -Wall -g + +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CFLAGS += -O0 +else + CFLAGS += -O2 +endif + +configure: configure-stamp +configure-stamp: + dh_testdir + # Add here commands to configure the package. + + touch configure-stamp + + +build: build-stamp + +build-stamp: configure-stamp + dh_testdir + + # Add here commands to compile the package. + $(MAKE) + #docbook-to-man debian/update-serial.sgml > update-serial.1 + + touch $@ + +clean: + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + + # Add here commands to clean up after the build process. + -$(MAKE) clean + + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs + + # Add here commands to install the package into debian/update-serial. + $(MAKE) DESTDIR=$(CURDIR)/debian/update-serial prefix=/usr install + + +# Build architecture-independent files here. +binary-indep: build install +# We have nothing to do by default. + +# Build architecture-dependent files here. +binary-arch: build install + dh_testdir + dh_testroot + dh_installchangelogs + dh_installdocs + dh_installexamples +# dh_install +# dh_installmenu +# dh_installdebconf +# dh_installlogrotate +# dh_installemacsen +# dh_installpam +# dh_installmime +# dh_python +# dh_installinit +# dh_installcron +# dh_installinfo + dh_installman + dh_link + dh_strip + dh_compress + dh_fixperms +# dh_perl +# dh_makeshlibs + dh_installdeb + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure diff -r 000000000000 -r 99443200522e debian/update-serial-default.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/update-serial-default.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,10 @@ +# Defaults for update-serial initscript +# sourced by /etc/init.d/update-serial +# installed at /etc/default/update-serial by the maintainer scripts + +# +# This is a POSIX shell fragment +# + +# Additional options that are passed to the Daemon. +DAEMON_OPTS="" diff -r 000000000000 -r 99443200522e debian/update-serial.doc-base.EX --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/update-serial.doc-base.EX Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,22 @@ +Document: update-serial +Title: Debian update-serial Manual +Author: +Abstract: This manual describes what update-serial is + and how it can be used to + manage online manuals on Debian systems. +Section: unknown + +Format: debiandoc-sgml +Files: /usr/share/doc/update-serial/update-serial.sgml.gz + +Format: postscript +Files: /usr/share/doc/update-serial/update-serial.ps.gz + +Format: text +Files: /usr/share/doc/update-serial/update-serial.text.gz + +Format: HTML +Index: /usr/share/doc/update-serial/html/index.html +Files: /usr/share/doc/update-serial/html/*.html + + diff -r 000000000000 -r 99443200522e debian/watch.ex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/debian/watch.ex Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,22 @@ +# Example watch control file for uscan +# Rename this file to "watch" and then you can run the "uscan" command +# to check for upstream updates and more. +# See uscan(1) for format + +# Compulsory line, this is a version 3 file +version=3 + +# Uncomment to examine a Webpage +# +#http://www.example.com/downloads.php update-serial-(.*)\.tar\.gz + +# Uncomment to examine a Webserver directory +#http://www.example.com/pub/update-serial-(.*)\.tar\.gz + +# Uncommment to examine a FTP server +#ftp://ftp.example.com/pub/update-serial-(.*)\.tar\.gz debian uupdate + +# Uncomment to find new files on sourceforge, for debscripts >= 2.9 +# http://sf.net/update-serial/update-serial-(.*)\.tar\.gz + + diff -r 000000000000 -r 99443200522e update-serial --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/update-serial Fri Jan 18 21:41:31 2008 +0000 @@ -0,0 +1,121 @@ +#! /usr/bin/perl +# (c) 1998 Heiko Schlittermann +# Update the serial numbers in zone files +# The serial number needs to match a specified pattern (see +# the line marked w/ PATTERN. +# +# ToDo: +# . test against an md5 sum, not just the date of the stamp file +# . FIXME: handle `/' in file names (currently only working in +# the current directory) +# . optionally reload the named + +use File::Basename; +use File::Copy; +my $ME = basename $0; +my @tmpfiles; +my $verbose = 0; +my $opt_yes = 0; + +sub cleanup() { unlink @tmpfiles; } +END { cleanup(); } + +$ARGV[0] eq "-y" and $opt_yes = 1, shift; +@Zones = @ARGV ? @ARGV : ; + + +MAIN: { + my $changed; + my ($dd, $mm, $yy) =(localtime())[3..5]; + my $date; + $mm++; + + foreach ($dd, $mm) { s/^\d$/0$&/; } + $yy += 1900; + $date = "$yy$mm$dd"; + + + while ($file = shift @Zones) { + local (*I, *O); + my $done = 0; + + my $new = "$file.$$.tmp"; + my $bak = "$file.bak"; + my $stamp = dirname($file) . "/.stamp/" . basename($file); + + $file =~ /(\.bak|~)$/ and next; + $file !~ /\./ and next; + + $verbose && print "$file:"; + + + if (-f $stamp && ((stat($stamp))[9] >= (stat($file))[9])) { + $verbose && print " fresh, skipping.\n"; + next; + } + + $done = 0; + push @tmpfiles, $new; + open(*I, "<$file") or die("Can't open < $file: $!\n"); + open(*O, ">$new") or die("Can't open > $new: $!\n"); + + while () { + /^\s+((\d+)(\d{2}))\s*;\s*serial/i and do { # PATTERN + my ($sdate, $scount, $serial) = ($2, $3, $1); + $done = 1; + print " [$file] serial $sdate$scount"; + + if ($date eq $sdate) { $scount++; } + else { $sdate = $date; $scount = "00"; } + + print " bumping to $sdate$scount"; + s/$serial/$sdate$scount/; + + }; + print O; + } + + close(O); close(I); + + if ($done) { + # copy($file, $bak) or die("Can't copy $file -> $bak: $!\n"); + + open(I, "<$new") or die("Can't open <$new: $!\n"); + open(O, ">$file") or die("Can't open >$file: $!\n"); + while () { print O or die("Can't write to $file: $!\n"); } + close(I) or die("Can't close $new: $!\n"); + close(O) or die("Can't close $file: $!\n"); + + unlink $new; + + open(O, ">$stamp") or die("Can't open >$stamp: $!\n"); + close(O); + $changed++; + } else { + print " $file: no serial number found: no zone file?"; + } + print "\n"; + } + + if ($changed) { + my $pidfile; + + print "** Changed $changed files, the nameserver needs to be reloaded!\n"; + foreach (qw(/var/run/bind/run/named.pid /var/run/named.pid /etc/named.pid)) { + -f $_ and $pidfile = $_ and last; } + + if ($pidfile) { + if ($opt_yes) { $_ = "y"; print "** Nameserver will be reloaded\n"; } + else { print "** Reload now? [Y/n]: "; $_ = ; } + /^y|^$/i and system "rndc reload"; + } else { + print "** No PID of a running named found. Please reload manually.\n"; + } + + + } + +} + + +# vim:ts=4:sw=4:ai:aw: