Commit debian/0.30 - debian-goodies

Imported Debian version 0.30 Javier Fernandez-Sanguino 12 years ago

9 changed file(s) with 423 addition(s) and 17 deletion(s). Raw diff Collapse all Expand all

.checkrestart.swp less more

Binary diff not shown

+32

-15

checkrestart less more

119	119	if path.endswith('.sh'):
120	120	continue
121	121	package.initscripts.append(path)
	122	# Alternatively, find init.d scripts that match the process name
	123	if len(package.initscripts) == 0:
	124	for process in package.processes:
	125	path = '/etc/init.d/' + os.path.basename(process.program)
	126	if os.path.exists(path):
	127	package.initscripts.append(path)
	128	# Remove duplicate inits
	129	package.initscripts = [ u for u in package.initscripts if u not in locals()['_[1]'] ]
122	130
123	131	restartable = []
124	132	nonrestartable = []

130	138	else:
131	139	nonrestartable.append(package)
132	140
133		print
134		print "Of these, %d seem to contain init scripts which can be used to restart them:" % len(restartable)
135		# TODO - consider putting this in a --verbose option
136		print "Of these, the following seem to contain init scripts which can be used to restart them:"
137		for package in restartable:
138		print package.name + ':'
139		for process in package.processes:
140		print "\t%s\t%s" % (process.pid,process.program)
	141	if len(restartable) > 0:
	142	print
	143	print "Of these, %d seem to contain init scripts which can be used to restart them:" % len(restartable)
	144	# TODO - consider putting this in a --verbose option
	145	print "The following packages seem to have init scripts that could be used\nto restart them:"
	146	for package in restartable:
	147	print package.name + ':'
	148	for process in package.processes:
	149	print "\t%s\t%s" % (process.pid,process.program)
141	150
142		print
143		print "These are the init scripts:"
144		print '\n'.join(restartCommands)
145		print
	151	print
	152	print "These are the init scripts:"
	153	print '\n'.join(restartCommands)
	154	print
146	155
147	156	if len(nonrestartable) == 0:
148	157	sys.exit(0)
149	158
150	159	# TODO - consider putting this in a --verbose option
151		print "Here are the others that do not seem to contain an init script for restarting them::"
	160	print "These processes do not seem to han an associated init script to restart them:"
152	161	for package in nonrestartable:
153	162	print package.name + ':'
154	163	for process in package.processes:

167	176	elif field == 'n':
168	177	# Remove the previous entry to check if this is something we should do
169	178	if data.startswith('/SYSV'):
	179	last = process.descriptors.pop()
	180	if not re.compile("DEL").search(last):
	181	process.files.append(data)
	182	elif data.startswith('/dev/zero'):
170	183	last = process.descriptors.pop()
171	184	if not re.compile("DEL").search(last):
172	185	process.files.append(data)

283	296	# what dpkg would do. Now we need to be more contrieved.
284	297	def needsRestart(self):
285	298	for f in self.files:
286		#print "Checking %s" % f
287	299	# We don't care about log files
288	300	if f.startswith('/var/log/'):
289	301	continue
290	302	# Or about files under /tmp
291	303	if f.startswith('/tmp/'):
	304	continue
	305	# Or /dev/zero
	306	if f.startswith('/dev/zero'):
292	307	continue
293	308	# TODO: it should only care about library files (i.e. /lib, /usr/lib and the like)
294	309	# build that check with a regexp to exclude others

297	312	if re.compile("$path inode=[0-9]+$$").search(f):
298	313	return 1
299	314	for f in self.descriptors:
300		# If it begins with SYSV it is not a deleted file
	315	# Notice that if it begins with SYSV or /dev/zero
	316	# it is not a deleted file and the descriptor was popped already
	317	# (see above)
301	318	if re.compile("DEL").search(f):
302	319	return 1
303	320	for f in self.links:

+12

-0

debian/changelog less more

	0	debian-goodies (0.30) unstable; urgency=low
	1
	2	* checkrestart changes:
	3	* Do not warn on processes than use /dev/zero and shows up as
	4	deleted. This prevents it from warning about apache2 (Closes: #432569)
	5	* Slightly improve the messages output.
	6	* Find init.d scripts even if not provided in the package by looking
	7	for init.d scripts that match the process name (works for apache2 too)
	8	* Fix some typos in which-pkg-broke(1) (Closes: #409581)
	9
	10	-- Javier Fernandez-Sanguino Pen~a <jfs@debian.org> Wed, 22 Aug 2007 22:59:27 +0200
	11
0	12	debian-goodies (0.29) unstable; urgency=low
1	13
2	14	* Network-test: use -t switch to use user's TMPDIR or /tmp instead of

+38

-0

debmany/bash_completion less more

	0	# Debian debmany(1) completion.
	1	#
	2	have debmany &&
	3	_debmany()
	4	{
	5	local cur prev
	6
	7	COMPREPLY=()
	8	cur=${COMP_WORDS[COMP_CWORD]}
	9	prev=${COMP_WORDS[COMP_CWORD-1]}
	10
	11	if [[ "$prev" == -m ]]; then
	12	case "${cur:0:1}" in
	13	\"\|\') local manpageviewer="${cur:1}";;
	14	*) local manpageviewer="$cur";;
	15	esac
	16	COMP_WORDS=(COMP_WORDS[0] $manpageviewer)
	17	COMP_CWORD=1
	18	_command
	19	# not perfect: '-m "konquer<tab' gets completed to '-m "konqueror"'
	20	# and '-m konquer<tab' gets completed to '-m konqueror'
	21	# both shall complete to '-m "konqueror man:%s"' ?!
	22	# but [ ${#COMPREPLY[@]} -eq 1 ] && [ ${COMPREPLY:0:1} != '"' ] && COMPREPLY[0]='"'$COMPREPLY' man:%s"'
	23	# completes to debmany -m \"konqueror\ man\:%s\"
	24	# my knowledge is too low concerning completion
	25	# whole -m section should be rewritten by someone with knowledge
	26	else
	27	if [[ "$cur" == -* ]]; then
	28	COMPREPLY=( $( compgen -W '-? -h --help -k -g -x -m' -- $cur ) )
	29	else
	30	COMPREPLY=( $( apt-cache pkgnames $cur 2> /dev/null; ) )
	31	[ ${#COMPREPLY[@]} -eq 0 ] && _filedir deb
	32	fi
	33	fi
	34
	35	return 0
	36	} &&
	37	complete -F _debmany $filenames debmany

+204

-0

debmany/debmany less more

	0	#!/bin/bassh
	1	# script: debmany
	2	# author: Michael Arlt
	3	# description: select the manpages of any [not] installed debian package
	4	# comment: debmany is based on the work of debman and debget
	5	# uses: whiptail (preferred) or dialog
	6	# This is free software. You may redistribute copies of it under the terms of
	7	# the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
	8	# There is NO WARRANTY, to the extent permitted by law.
	9
	10	LC_ALL=C
	11
	12	# choose the manpageviewer
	13	mancmdline="man %s" # default manpageviewer
	14	test -n "$DEBMANY_MANPAGE_VIEWER" && mancmdline="$DEBMANY_MANPAGE_VIEWER" # override default manpageviewer
	15
	16	curdir=`pwd`
	17
	18	error()
	19	{
	20	# show errorcode and quit
	21	echo "ERROR: $*" >&2
	22	exit 1
	23	}
	24
	25	usage()
	26	{
	27	self="${0##*/}"
	28	echo "debmany 1.1 Sun Aug 19 20:11:48 CEST 2007
	29	Description: Display a manpage from a Debian package.
	30	The list of manpages is displayed in a dialog.
	31	Supported locations for debian packages are: Local .deb-file,
	32	a package in the repository or a installed package.
	33	Syntax : $self [-?\|-h\|--help] [-m manpageviewer\|-k\|-g\|-x] package\|package.deb
	34
	35	Examples: $self foo.deb show manpages from a local package file foo.deb
	36	$self foo show manpages from a package, if the package is
	37	not installed it is retrieved from the
	38	configured repositories.
	39	$self -k foo show manpages using your preferred man-viewer
	40	(KDE users)
	41	$self -g foo show manpages using your preferred man-viewer
	42	(GNOME users)
	43	$self -x foo show manpages using your preferred man-viewer
	44	using xdg-open (Xfce users)
	45	$self -m 'konqueror man:%s' foo
	46	show manpages using konqueror as man-viewer
	47	export DEBMANY_MANPAGE_VIEWER='konqueror man:%s'; $self sc"
	48	if [ $# -eq 0 ]
	49	then
	50	exit 0
	51	else
	52	error "$*"
	53	fi
	54	}
	55
	56	case "$1" in
	57	"-?"\|-h\|--help) usage ;;
	58	-m) shift
	59	# override default manpageviewer or environment variable DEBMANY_MAN_VIEWER
	60	mancmd=($1) # get first word from manpageviewer
	61	if which $mancmd >/dev/null 2>&1 # is the manpageviewer executeable?
	62	then
	63	mancmdline="$1"
	64	shift
	65	else
	66	usage "Manpageviewer '$mancmd' is not available or executable"
	67	fi
	68	;;
	69	-k) shift; mancmdline='kfmclient exec man:%s';; # set kde viewer
	70	-g) shift; mancmdline='gnome-open man:%s';; # set gnome viewer
	71	-x) shift; mancmdline='xdg-open man:%s';; # set independant viewer
	72	-*) usage "Unknown option $1"
	73	;;
	74	esac
	75
	76	test $# -ne 1 && usage "You must specify one package or a Debian package file"
	77
	78	# determine the size of your terminal
	79	declare -i size=(`stty size`)
	80	declare -i x=${size[1]}
	81	declare -i y=${size[0]}
	82
	83	# if it is impossible to determine the size
	84	if [ $x -eq 0 ]
	85	then
	86	x=80
	87	y=25
	88	echo "Unable to determine the size of your terminal - using Console default: $x*$y" >&2
	89	sleep 3
	90	fi
	91
	92	# test upon minimum resolution
	93	if [ $x -lt 40 -o $y -lt 9 ]
	94	then
	95	error "Resolution too small ($x$y). I need a minimum of 409 - recommended is more..."
	96	fi
	97
	98	# set the size of the dialog window and menu
	99	x=x-1 # width of the dialog
	100	y=y-1 # height of the dialog
	101	declare -i h=y-7 # height of the menu
	102
	103	if [ "${1##*.}" = "deb" ]
	104	then
	105	# mode1: you want to see manpages from a .deb-file
	106	if [ -r "$1" ] ; then
	107	file=`readlink -f "$1"`
	108	status=file
	109	else
	110	error "The file $1 cannot be read"
	111	fi
	112	else
	113	# mode 2: test if you have the package already installed
	114	for man in `dpkg -L "$1" 2>/dev/null \| grep -e /usr/share/man -e /usr/X11R6/man\|sort`
	115	do
	116	# mode 2: add the manpages to the list
	117	test -f $man && manpages="$manpages $man ${man##*/}"
	118	done
	119	fi
	120
	121	# TODO: If there is a locally installed package with no manpages
	122	# it will try to download a new version. This could be considered
	123	# a bug or a feature (as there are slim chances of this to
	124	# provide any new manpages). Maybe it should just abort if the
	125	# packaged is installed but there are no manpages to see.
	126	if [ -n "$manpages" ]
	127	then
	128	# mode 2
	129	cd /
	130	status=installed
	131	else
	132	# mode 1 and 3
	133	trap 'test -n "$temp" && rm -rf $temp; exit' 0 2 15 # cleanup
	134
	135	tmp=/dev/shm # set default tempdir
	136	test -d $tmp \|\| tmp=/tmp # if not available use /tmp
	137
	138	# make a temporary folder for the manpages - $TMPDIR overrides the path of -p
	139	temp=`mktemp -d -p $tmp debmany.XXXXXXXXXX` \|\| error "Unable to create a temporary folder."
	140
	141	if [ -z "$file" ]
	142	then
	143	# mode 3: find the package.deb
	144	aptdata=`apt-get -q2 --print-uris --reinstall install "$1" 2>/dev/null \| tail -1`
	145	if [ -z "$aptdata" ]
	146	then
	147	error "There is no package called '$1'."
	148	exit 1
	149	fi
	150
	151	url=`echo "$aptdata" \| sed -e "s/^'$[^']$'.$/\1/"`
	152	test -z "$url" && error "Could not obtain an URL for '$pkgspec'."
	153
	154	if [ "${url%%:*}" = "file" ]
	155	then
	156	# mode 3: access the local file
	157	file="${url#*:}"
	158	if [ ! -r "$file" ]
	159	then
	160	error "Could not access '$file' from the repository."
	161	fi
	162	status=repos-file
	163	else
	164	# mode 3: download the local file
	165	file="$temp/tmp.deb"
	166	curl "$url" >"$file" \|\| error "Could not download '$file' from the repository."
	167	status=repos-curl
	168	fi
	169	fi
	170	cd $temp
	171	# extract the manpages
	172	MANDIRS='usr/share/man usr/X11R6/man ./usr/share/man ./usr/X11R6/man'
	173	dpkg --fsys-tarfile "$file" \| tar -xf - $MANDIRS 2>/dev/null
	174	manpages=`find usr -type f\|sort\|sed -e 's§$[^/]*$$§\1 \1§'`
	175	fi
	176
	177	# choose whiptail or dialog
	178	whiptail=/usr/bin/whiptail
	179	dialog=/usr/bin/dialog
	180	test -x $whiptail && cmd=$whiptail \|\| cmd=$dialog
	181
	182	while true
	183	do
	184	# test if manpages where found
	185	test -z "$manpages" && error "No manpage exists for package '$1'."
	186
	187	# select your manpages using dialog
	188	exec 3>&1
	189	return=`$cmd --title "Select a manpage ($status:$1)" --menu '' $y $x $h $manpages 2>&1 1>&3`
	190	exec 3>&-
	191	if [ -n "$return" ]
	192	then
	193	# show the manpage
	194	`printf "$mancmdline" "$PWD/$return"`
	195	else
	196	cd $curdir
	197	exit
	198	fi
	199	done
	200
	201	# This should not be reached
	202	cd $curdir
	203	exit 0

+64

-0

debmany/man/de/man1/debmany.1 less more

	0	.TH "DEBMANY" "1" "1.1" "Michael Arlt" "Dienstprogramme für Benutzer"
	1	.SH "NAME"
	2	debmany \- Wählen von manpages aus installierten Paketen, Paketen des Repositories oder .deb\-Dateien zum Betrachten mit "man" oder einem alternativen Viewer.
	3	.SH "SYNTAX"
	4	.B debmany
	5	\fI\-\-help
	6	.br
	7	.B debmany
	8	\fI[\-m manpageviewer\|\-k\|\-g\|\-x] Paket\|Paket.deb\fR
	9	.SH "BESCHREIBUNG"
	10	.\" Add any additional description here
	11	.PP
	12	Wählen Sie eine Manpage von einem Debian Paket um sie mit "man" oder einem alternativen Viewer zu betrachten. Die Liste der Manpages wird in einem Dialog dargestellt. Unterstützte Quellen für Debian Pakete sind: Lokale .deb\-Datei, ein Paket aus dem Repository oder ein installiertes Paket.
	13	.TP
	14	\fB\-\-help\fR
	15	zeigt eine kurze Hilfe und beendet sich
	16	.TP
	17	\fB\-m manpageviewer\fR
	18	Setzt optional den Manpageviewer. Der Viewer muss .gz Dateien unterstützen. Durch die Umgebungsvariable DEBMANY_MANPAGE_VIEWER kann der gewünschte Manpageviewer voreingestellt werden. Hierbei ist zu beachten, dass der komplette Aufruf formuliert werden muss. "%s" wird durch den Pfad zur Manpage ersetzt. Der Aufruf muss in "" oder '' gefasst werden \- siehe Beispiele.
	19	Bei der Benutzung eines grafischen Manpageviewers müssen Sie sicherstellen, dass Sie Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x\-forwarding)
	20	.TP
	21	\fB\-k\fR
	22	Zeigt die Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen) an, falls Sie KDE benutzen \- Kurzform von \-m 'kfmclient exec man:%s'. "kfmclient" ist Teil des Paketes "konqueror".
	23	.TP
	24	\fB\-g\fR
	25	Zeigt die Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen) an, falls Sie GNOME benutzen \- Kurzform von \-m 'gnome\-open man:%s'. "gnome\-open" ist Teil des Paketes "libgnome2\-0".
	26	.TP
	27	\fB\-x\fR
	28	Zeigt die Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen) an, falls Sie KDE/GNOME/Xfce benutzen \- Kurzform von \-m 'xdg\-open man:%s'. "xdg\-open" ist Teil des Paketes "xdg\-utils".
	29	.PP
	30	Die Manpages werden temporär nach /dev/shm (sofern dieses Verzeichnis existiert) oder /tmp extrahiert. Durch das Setzen und Exportieren der Umgebungsvariable TMPDIR kann der Speicherort überschrieben werden.
	31	.PP
	32	Das Debian Paket "whiptail" (bevorzugt) oder "dialog" sowie "curl" muss installiert sein.
	33	.SH "BEISPIELE"
	34	.TP
	35	debmany coreutils
	36	Zeigt alle Manpages des installierten Debian Pakets "coreutils" mit "man" an.
	37	.TP
	38	debmany 3dchess
	39	Zeigt alle Manpages des Paketes "3dchess" mit "man" an. Da es noch nicht installiert ist wird es vom Repository bezogen \- wenn nötig auch per Download.
	40	.TP
	41	debmany test.deb
	42	Zeigt alle Manpages des lokalen Debian Paketes "./test.deb" mit "man" an.
	43	.TP
	44	debmany \-k sc
	45	Benutzt den bevorzugten Manviewer (für KDE Anwender)
	46	.TP
	47	debmany \-g sc
	48	Benutzt den bevorzugten Manviewer (für GNOME Anwender)
	49	.TP
	50	debmany \-x sc
	51	Benutzt den bevorzugten Manviewer (für KDE/GNOME/Xfce Anwender)
	52	.TP
	53	debmany \-m 'konqueror man:%s' sc
	54	Benutzt Konqueror als Viewer
	55	.TP
	56	export DEBMANY_MANPAGE_VIEWER="konqueror man:%s"; debmany sc
	57	Benutzt den in der Umgebungsvariable DEBMANY_MANPAGE_VIEWER festgelegten Viewer (konqueror)
	58	.SH "AUTOR"
	59	Geschrieben von Michael Arlt.
	60	.SH "LIZENZ"
	61	This is free software. You may redistribute copies of it under the terms of
	62	the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
	63	There is NO WARRANTY, to the extent permitted by law.

+64

-0

debmany/man/man1/debmany.1 less more

	0	.TH "DEBMANY" "1" "1.1" "Michael Arlt" "User Commands"
	1	.SH "NAME"
	2	debmany \- select manpages from installed packages, packages from the repository or .deb\-files for viewing using "man" or an alternative viewer.
	3	.SH "SYNOPSIS"
	4	.B debmany
	5	\fI\-\-help
	6	.br
	7	.B debmany
	8	\fI[\-m manpageviewer\|\-k\|\-g\|\-x] package\|package.deb\fR
	9	.SH "DESCRIPTION"
	10	.\" Add any additional description here
	11	.PP
	12	Select a manpage from a debian package for viewing with man or an alternative viewer. The list of manpages is displayed in a dialog. Supported locations for debian packages are: Local .deb\-file, a package in the repository or a installed package.
	13	.TP
	14	\fB\-\-help\fR
	15	display a small help and exit
	16	.TP
	17	\fB\-m manpageviewer\fR
	18	Optionally set a manpage viewer. The viewer must support .gz files. You can preset the desired manpage viewer with the environment variable DEBMANY_MANPAGE_VIEWER. You must define the complete request. "%s" gets replaced with the path to the manpage. The manpageviewer must be enclosed with "" or '' \- see examples.
	19	If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with x\-forwarding)
	20	.TP
	21	\fB\-k\fR
	22	Display the manpage using your preferred viewer (must support .gz files) if you use KDE \- this is the short form of \-m 'kfmclient exec man:%s'. "kfmclient" is a part of the package "konqueror".
	23	.TP
	24	\fB\-g\fR
	25	Display the manpage using your preferred viewer (must support .gz files) if you use GNOME \- this is the short form of \-m 'gnome\-open man:%s'. "gnome\-open" is a part of the package "libgnome2\-0".
	26	.TP
	27	\fB\-x\fR
	28	Display the manpage using your preferred viewer (must support .gz files) if you use KDE/GNOME/Xfce \- this is the short form of \-m 'xdg\-open man:%s'. "xdg\-open" is a part of the package "xdg\-utils".
	29	.PP
	30	The manpages are temporarily extracted to /dev/shm (if the directory exists) or /tmp . You can override the path if you set and export the environment variable TMPDIR.
	31	.PP
	32	You need to have the debian package "whiptail" (preferred) or "dialog" as well as "curl" installed.
	33	.SH "EXAMPLES"
	34	.TP
	35	debmany coreutils
	36	Show all manpages from the installed debian package "coreutils" using man.
	37	.TP
	38	debmany 3dchess
	39	Show all manpages from the package "3dchess" using man. Since it is not already installed the package is accessed from the repository \- even downloading is done if needed.
	40	.TP
	41	debmany test.deb
	42	Show all manpages from the local debian package "./test.deb" using man.
	43	.TP
	44	debmany \-k sc
	45	Use your preferred man\-viewer (for KDE user)
	46	.TP
	47	debmany \-g sc
	48	Use your preferred man\-viewer (for GNOME user)
	49	.TP
	50	debmany \-x sc
	51	Use your preferred man\-viewer (for KDE/GNOME/Xfce user)
	52	.TP
	53	debmany \-m 'konqueror man:%s' sc
	54	Use Konqueror as viewer
	55	.TP
	56	export DEBMANY_MANPAGE_VIEWER="konqueror man:%s"; debmany sc
	57	Use the viewer specified in the environment variable DEBMANY_MANPAGE_VIEWER (konqueror)
	58	.SH "AUTHOR"
	59	Written by Michael Arlt.
	60	.SH "LICENSE"
	61	This is free software. You may redistribute copies of it under the terms of
	62	the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
	63	There is NO WARRANTY, to the extent permitted by law.

-0

debmany/readme less more

	0	copy bash_completion to ~/.bash_completion
	1	it uses functions from /etc/bash_completion
	2	completion is done for
	3	parameters (-m is not handled very good),
	4	packages,
	5	filenames ending with .deb and
	6	folders

-2

which-pkg-broke.1 less more

0	0	.\" which-pkg-broke.1 - find which package might have broken another
1	1	.\" Copyright (C) 2006 Javier Fernandez-Sanguino
2	2	.\" Everybody is allowed to distribute this manual page,
3		.\" to modify it, and to distribute modifed versions of it.
	3	.\" to modify it, and to distribute modified versions of it.
4	4	.TH which-pkg-broke 1 "July 24 2006" "debian\-goodies" "debian\-goodies"
5	5	.SH NAME
6	6	which-pkg-broke \- find which package might have broken another

21	21	to find which package update might be responsible for the breakage.
22	22
23	23	.SH EXAMPLES
24		This tool can be useful determine which package dependancies were upgraded
	24	This tool can be useful determine which package dependencies were upgraded
25	25	more recently and might be associated with the bug that is being observed.
26	26	For example, if aptitude stops working properly, an administrator can run:
27	27