Debian Bug report logs - #323621
manpages: initrd(4) describes only "change_root", not "pivot_root"

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Norbert Buchmuller <norbi.spam@nix.hu>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: manpages: initrd(4) describes only "change_root", not "pivot_root"

Date: Wed, 17 Aug 2005 18:13:03 +0200

Package: manpages
Version: 1.70-1
Severity: normal

The initrd(4) manpage documents only the older, so-called "change_root"
method, and does not even mention "pivot_root". The "change_root" method
is considered to be obsolete (see Documentation/initrd.txt in the 2.4
or 2.6 kernel source tree).

Until complete rewrite, a notice saying 'the method documented there
is obsolete, see pivot_root(2)' and pointers to pivot_root(8) and
pivot_root(2) in 'SEE ALSO' would be useful, I suppose.

norbi

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (600, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.11
Locale: LANG=C, LC_CTYPE=hu_HU (charmap=ISO-8859-2)

-- no debconf information

Message #10 received at 323621@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk" <mtk-manpages@gmx.net>

To: Norbert Buchmuller <norbi.spam@nix.hu>

Cc: 323621@bugs.debian.org,control@bugs.debian.org

Subject: Re: Bug#323621: manpages: initrd(4) describes only "change_root", not "pivot_root"

Date: Wed, 21 Sep 2005 14:28:04 +0200 (MEST)

tags 323621 fixed-upstream
thanks

Norbert,

> The initrd(4) manpage documents only the older, so-called "change_root"
> method, and does not even mention "pivot_root". The "change_root" method
> is considered to be obsolete (see Documentation/initrd.txt in the 2.4
> or 2.6 kernel source tree).
> 
> Until complete rewrite, a notice saying 'the method documented there
> is obsolete, see pivot_root(2)' and pointers to pivot_root(8) and
> pivot_root(2) in 'SEE ALSO' would be useful, I suppose.

Thanks.  I added the following text for the man-pages-2.08 release:
 
       Note:   The  use  of  /proc/sys/kernel/real-root-dev  to
       change the root file system is obsolete.  See the kernel
       source   file   Documentation/initrd.txt   as   well  as
       pivot_root(2) and pivot_root(8) for information  on  the
       modern method of changing the root file system.

Do you have the time / knowledge for the "complete rewrite"?

Cheers,

Michael

-- 
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 

Want to help with man page maintenance?  Grab the latest
tarball at ftp://ftp.win.tue.nl/pub/linux-local/manpages/
and grep the source files for 'FIXME'.

Message #17 received at 323621-close@bugs.debian.org (full text, mbox, reply):

From: Martin Schulze <joey@infodrom.org>

To: 323621-close@bugs.debian.org

Subject: Bug#323621: fixed in manpages 2.08-1

Date: Thu, 17 Nov 2005 23:02:09 -0800

Source: manpages
Source-Version: 2.08-1

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

manpages-dev_2.08-1_all.deb
  to pool/main/m/manpages/manpages-dev_2.08-1_all.deb
manpages_2.08-1.diff.gz
  to pool/main/m/manpages/manpages_2.08-1.diff.gz
manpages_2.08-1.dsc
  to pool/main/m/manpages/manpages_2.08-1.dsc
manpages_2.08-1_all.deb
  to pool/main/m/manpages/manpages_2.08-1_all.deb
manpages_2.08.orig.tar.gz
  to pool/main/m/manpages/manpages_2.08.orig.tar.gz



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 323621@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Martin Schulze <joey@infodrom.org> (supplier of updated manpages 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: Fri, 18 Nov 2005 07:46:45 +0100
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 2.08-1
Distribution: unstable
Urgency: low
Maintainer: Martin Schulze <joey@debian.org>
Changed-By: Martin Schulze <joey@infodrom.org>
Description: 
 manpages   - Manual pages about using a GNU/Linux system
 manpages-dev - Manual pages about using GNU/Linux for development
Closes: 263756 314435 322934 323621 325115 326720 328629
Changes: 
 manpages (2.08-1) unstable; urgency=low
 .
   * New upstream release, with the following changes
     - Add _POSIX_C_SOURCE 199309 to nanosleep(2) prototype (Closes: Bug#314435)
     - Clarified arguments in outb(2) (Closes: Bug#263756)
     - Corrected prototype in poll(2) (Closes: Bug#322934)
     - Removed misleading text in rand(3) (Closes: Bug#328629)
     - Correction of description of carg(3) (Closes: Bug#326720)
     - Removed reference to rpc_secure(3) in rpc(3) (Closes: Bug#325115)
     - Mention pivot-root in initrd(4) (Closes: Bug#323621)
Files: 
 6682770978e807df9d68cc3d1ee87677 584 doc - manpages_2.08-1.dsc
 0b3cca8825ac6980fdc22d47d23c6888 1050767 doc - manpages_2.08.orig.tar.gz
 929aaee8838745ccb7af2bf4bb1596f1 44697 doc - manpages_2.08-1.diff.gz
 abf56fc177c2af5490b962f301a2b4b2 402880 doc important manpages_2.08-1_all.deb
 67dc6340a6b039bb1fb74604714347cd 1104406 doc standard manpages-dev_2.08-1_all.deb

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

iD8DBQFDfXllW5ql+IAeqTIRAjEWAJ4rAV2qjPqtyYu0RtGiykphDcUs2ACdH6Cy
cIx6c2EfU8aeF/mi+qAA770=
=l+s0
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.