[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#274211: marked as done (superd: Missing man page)

Your message dated Sun, 22 Apr 2007 13:17:08 +0000
with message-id <E1HfbwC-00067U-L7@ries.debian.org>
and subject line Bug#274211: fixed in superd 0.0.3-5
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)
--- Begin Message --- 
Package: superd
Version: 0.0.3-3
Severity: minor
Tags: patch

Superd does not have a man page. This bug report provides a new man page
for the program (patch) and updates debian/rules.

Also, while writing the man page I noted that the option -d is not
mentioned by the program's usage comment:

usage: superd [-m numminions] [-l listenq] port absolutepathtobinary
[args] ...

The attached patch also corrects this, the usage is now:

usage: superd [-m numminions] [-l listenq] [-d debugfile] port
absolutepathtobinary [args] ...


-- System Information:
Debian Release: 3.1
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)
Kernel: Linux 2.4.27-1-686
Locale: LANG=C, LC_CTYPE=C

Versions of packages superd depends on:
ii  libc6                       2.3.2.ds1-16 GNU C Library: Shared libraries an

-- no debconf information

diff -ruN superd-0.0.3.orig/debian/changelog superd-0.0.3/debian/changelog
--- superd-0.0.3.orig/debian/changelog	2004-09-30 12:06:24.000000000 +0100
+++ superd-0.0.3/debian/changelog	2004-09-30 12:23:33.000000000 +0100
@@ -1,3 +1,10 @@
+superd (0.0.3-4) unstable; urgency=low
+
+  * Add man page to package
+  * Make usage output mention -d param
+
+ -- Stephen Birch <sgbirch@imsmail.org>  Thu, 30 Sep 2004 12:15:58 +0100
+
 superd (0.0.3-3) unstable; urgency=low
 
   * change define symbol LINUX to __GLIBC__ to enable usage on Hurd.
diff -ruN superd-0.0.3.orig/debian/rules superd-0.0.3/debian/rules
--- superd-0.0.3.orig/debian/rules	2004-09-30 12:06:24.000000000 +0100
+++ superd-0.0.3/debian/rules	2004-09-30 12:20:56.000000000 +0100
@@ -29,7 +29,6 @@
 
 	$(MAKE) CFLAGS="$(CFLAGS)" 
 	
-	
 	#/usr/bin/docbook-to-man debian/superd.sgml > superd.1
 
 	touch build-stamp
@@ -65,7 +64,7 @@
 	dh_testdir
 	dh_testroot
 	dh_installdocs
-	dh_installmanpages
+	dh_installman superd.man
 	dh_installchangelogs CHANGELOG
 	dh_link
 	dh_strip
diff -ruN superd-0.0.3.orig/superd.c superd-0.0.3/superd.c
--- superd-0.0.3.orig/superd.c	2004-09-30 12:06:24.000000000 +0100
+++ superd-0.0.3/superd.c	2004-09-30 12:10:05.000000000 +0100
@@ -123,7 +123,7 @@
 }
     
 void printusage(char *argv) {
-    fprintf(stderr, "usage: %s [-m numminions] [-l listenq] port absolutepathtobinary [args] ...\n", argv);
+    fprintf(stderr, "usage: %s [-m numminions] [-l listenq] [-d debugfile] port absolutepathtobinary [args] ...\n", argv);
     exit(1);
 }
 
diff -ruN superd-0.0.3.orig/superd.man superd-0.0.3/superd.man
--- superd-0.0.3.orig/superd.man	1970-01-01 01:00:00.000000000 +0100
+++ superd-0.0.3/superd.man	2004-09-30 12:09:45.000000000 +0100
@@ -0,0 +1,69 @@
+.TH SUPERD 8 " Sept 2004" " "
+.SH NAME
+superd \- Single port inetd with pre-forking
+.SH SYNOPSIS
+.B superd
+.I [-m numminions]
+.I [-l listenq]
+.I [-d debugfile]
+.B port
+.B absolutepathtobinary
+.B [args]
+.SH DESCRIPTION
+.PP
+.I Superd
+turns any program that normally talks to stdin and stdout into a high
+speed server. It is similar in functionality to inetd but handles only
+one port per invocation and uses pre-forking and file descriptor
+passing to achieve high performance.
+.PP
+When calling
+.I superd
+the user provides a
+.I port
+and the
+.I absolutepathtobinary
+of the executable program along with any arguments that program may need.
+.I Superd
+then opens a socket on that port and redirects the program's
+stdin and stdout to the socket.
+.PP
+Stderr is redirected to /dev/null
+unless
+.I debugfile
+is specified at the command line in which case
+stderr is redirected to that file. If
+.I debugfile
+already exists its contents will be silently discarded.
+.SH OPTIONS
+.B -m numminions
+.RS
+Number of minion processes to prefork (default = 20).
+.RE
+.PP
+.B -l listenq
+.RS
+The maximum length of queue of pending connections the queue may grow
+to. Internally this is the
+.I backlog
+argument passed to
+.B listen(2)
+call.
+.RE
+.PP
+.B -d debugfile
+.RS
+Provide the filename for redirection of the server program's
+.B stderr.
+.RE
+.PP
+.SH AUTHOR
+.PP
+The
+.B superd
+author is john@viscous.org, debian packaging is by Oliver
+M. Bolzer <oliver@debian.org>.
+.sp
+.SH COPYRIGHT
+superd may be redistributed under the terms of the GNU GPL, Version 2 or
+later, found on Debian systems in the file /usr/share/common-licenses/GPL.

--- End Message ---
--- Begin Message --- 
Source: superd
Source-Version: 0.0.3-5

We believe that the bug you reported is fixed in the latest version of
superd, which is due to be installed in the Debian FTP archive:

superd_0.0.3-5.diff.gz
  to pool/main/s/superd/superd_0.0.3-5.diff.gz
superd_0.0.3-5.dsc
  to pool/main/s/superd/superd_0.0.3-5.dsc
superd_0.0.3-5_i386.deb
  to pool/main/s/superd/superd_0.0.3-5_i386.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 274211@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Nico Golde <nion@debian.org> (supplier of updated superd package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Sun, 22 Apr 2007 14:51:08 +0200
Source: superd
Binary: superd
Architecture: source i386
Version: 0.0.3-5
Distribution: unstable
Urgency: low
Maintainer: Debian QA Group <packages@qa.debian.org>
Changed-By: Nico Golde <nion@debian.org>
Description: 
 superd     - Single-port inetd with pre-forking, suited for high-speed servers
Closes: 274211
Changes: 
 superd (0.0.3-5) unstable; urgency=low
 .
   * QA upload.
   * Added manpage and added -d to printusage() (Closes: #274211).
   * Fixed copyright.
   * Added compat file, removed DH_COMPAT from rules.
Files: 
 dec1f7e4fae461f33c9052c89f64d03f 559 net optional superd_0.0.3-5.dsc
 c651cc98c58ece74bc2735815ed23f86 4725 net optional superd_0.0.3-5.diff.gz
 fe090c9277528ea62010f814e1037ca2 11200 net optional superd_0.0.3-5_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFGK102HYflSXNkfP8RAsoBAJwIa4crENa1Roi/9rgY0QYS42ZtQQCcC0O2
vVEnRlNHoAfWFv88Nixy9l4=
=2YsF
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: