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
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'.
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 [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Martin Schulze <[email protected]> (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 [email protected])
-----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 <[email protected]>
Changed-By: Martin Schulze <[email protected]>
Description:
manpages - Manual pages about using a GNU/Linux system
manpages-dev - Manual pages about using GNU/Linux for development
Closes: 263756314435322934323621325115326720328629
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-----