Date: Sat, 4 May 2002 22:19:32 +0100 (BST) From: Hiten Pandya <hitenp@hpdi.ath.cx> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/37757: [PATCH] kernel path change for -current man pages Message-ID: <200205042119.g44LJWAN027426@hpdi.ath.cx>
next in thread | raw e-mail | index | archive | help
>Number: 37757 >Category: docs >Synopsis: [PATCH] kernel path change for -current man pages >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Sat May 04 14:30:00 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Hiten Pandya >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: System: FreeBSD hpdi.ath.cx 5.0-CURRENT FreeBSD 5.0-CURRENT #0: Sat Mar 9 18:43:51 GMT 2002 hitenp@hpdi.ath.cx:/c1/obj/data/dev/src/sys/CURRENT5 i386 >Description: The manual pages in FreeBSD-CURRENT need to be updated to reflect the new location of the kernel, which is: /boot/kernel/kernel. The patch provided herein does the above thing of updating the very few but important man pages. The patches herein have been reviewed by freebsd-current mailing list. Also, the patch is available from: http://storm.uk.FreeBSD.org/~hiten/diffs/paths-20020329.diff NOTE: this issue is only for -CURRENT. Please do not MFC these changes to -STABLE. STABLE still uses /boot/kernel; while -CURRENT has switched over to /boot/kernel/kernel. The following manual pages are updated by the delta(s) below: ps(1) getbootfile(3) nextboot(8) boot_i386(8) vinum(4) loader.conf(5) loader.4th(8) fstat(1) ipcs(1) nfsstat(1) symorder(1) systat(1) vmstat(8) uptime(1) w(1) getextattr(8) iostat(8) kernbb(8) pstat(8) rwhod(8) setextattr(8) trpt(8) Please do not hesitate to contact me for more information regarding the delta(s) provided, or this PR. Things that are still left TODO: o change location of the modules from /modules to /boot/kernel I will do the above remaining thing when I can find myself some time. Thanks. -- Hiten Pandya -- <hiten@uk.FreeBSD.org> >How-To-Repeat: Visit the various manual pages, and check them with thi >Fix: The following patches fix/update the manual pages to use /boot/kernel/kernel, rather than /boot/kernel. Index: fstat.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/fstat/fstat.1,v retrieving revision 1.15 diff -u -r1.15 fstat.1 --- fstat.1 2002/03/27 22:59:11 1.15 +++ fstat.1 2002/03/29 00:30:18 @@ -73,7 +73,7 @@ .Pa /dev/kmem . .It Fl N Extract the name list from the specified system instead of the default -.Pa /kernel . +.Pa /boot/kernel/kernel . .It Fl m Include memory-mapped files in the listing; normally these are excluded due to the extra processing required. Index: getbootfile.3 =================================================================== RCS file: /home/ncvs/src/lib/libc/gen/getbootfile.3,v retrieving revision 1.9 diff -u -r1.9 getbootfile.3 --- getbootfile.3 2001/10/01 16:08:50 1.9 +++ getbootfile.3 2002/03/28 23:44:00 @@ -63,7 +63,7 @@ .Sh BUGS If the boot blocks have not been modified to pass this information into the kernel at boot time, the static string -.Dq Pa /kernel +.Dq Pa /boot/kernel/kernel is returned instead of the real boot file. .Sh HISTORY The Index: getextattr.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/getextattr/getextattr.8,v retrieving revision 1.13 diff -u -r1.13 getextattr.8 --- getextattr.8 2002/02/10 06:13:14 1.13 +++ getextattr.8 2002/03/29 00:53:34 @@ -78,18 +78,18 @@ and the attribute must of defined for the file queried. .Sh EXAMPLES .Bd -literal -offset indent -# getextattr system md5 /kernel -/kernel: +# getextattr system md5 /boot/kernel/kernel +/boot/kernel/kernel: 61 61 33 62 39 39 66 65 31 35 35 32 31 62 65 32 62 36 38 36 62 31 66 39 63 64 33 39 35 36 36 31 -# getextattr -s system md5 /kernel -/kernel: "aa3b99fe15521be2b686b1f9cd395661" +# getextattr -s system md5 /boot/kernel/kernel +/boot/kernel/kernel: "aa3b99fe15521be2b686b1f9cd395661" .Ed .Pp Retrieve the .Dq md5 extended attribute for the file -.Pa /kernel . +.Pa /boot/kernel/kernel . .Sh SEE ALSO .Xr extattr 2 , .Xr extattr 3 , Index: iostat.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/iostat/iostat.8,v retrieving revision 1.20 diff -u -r1.20 iostat.8 --- iostat.8 2001/08/07 13:59:48 1.20 +++ iostat.8 2002/03/29 00:56:07 @@ -144,7 +144,7 @@ devices present. .It Fl N Extract the name list from the specified system instead of the default -.Dq Pa /kernel . +.Dq Pa /boot/kernel/kernel . .It Fl o Display old-style .Nm @@ -350,8 +350,8 @@ .El .El .Sh FILES -.Bl -tag -width /dev/kmem -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel Default kernel namelist. .It Pa /dev/kmem Default memory file. Index: ipcs.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/ipcs/ipcs.1,v retrieving revision 1.12 diff -u -r1.12 ipcs.1 --- ipcs.1 2001/05/31 22:30:39 1.12 +++ ipcs.1 2002/03/29 00:33:43 @@ -100,7 +100,7 @@ .It Fl C Ar system Extract the name list from the specified system instead of the default -.Dq Pa /kernel . +.Dq Pa /boot/kernel/kernel . Implies .Fl y . .It Fl M @@ -154,10 +154,10 @@ at all attempt to explain the information printed by .Nm . .Sh FILES -.Bl -tag -width /etc/passwd -compact +.Bl -tag -width /boot/kernel/kernel -compact .It Pa /dev/kmem default kernel memory -.It Pa /kernel +.It Pa /boot/kernel/kernel default system name list .El .Sh SEE ALSO Index: kernbb.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/kernbb/kernbb.8,v retrieving revision 1.14 diff -u -r1.14 kernbb.8 --- kernbb.8 2001/07/15 08:02:02 1.14 +++ kernbb.8 2002/03/29 00:58:23 @@ -56,8 +56,8 @@ of executions, length of the basic-block in bytes and the product of the previous two fields. .Sh FILES -.Bl -tag -width /dev/kmemx -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel the default system .It Pa /dev/kmem the default memory Index: loader.4th.8 =================================================================== RCS file: /home/ncvs/src/sys/boot/forth/loader.4th.8,v retrieving revision 1.10 diff -u -r1.10 loader.4th.8 --- loader.4th.8 2001/08/13 16:32:56 1.10 +++ loader.4th.8 2002/03/29 00:27:45 @@ -176,7 +176,7 @@ Loads a different kernel with the standard configuration: .Pp .Bd -literal -offset indent -compact -set kernel="kernel.old" +set kernel="/boot/kernel.old/kernel" unload boot-conf .Ed Index: loader.conf.5 =================================================================== RCS file: /home/ncvs/src/sys/boot/forth/loader.conf.5,v retrieving revision 1.15 diff -u -r1.15 loader.conf.5 --- loader.conf.5 2002/03/13 10:55:22 1.15 +++ loader.conf.5 2002/03/29 00:25:50 @@ -154,7 +154,7 @@ selects a mute console (useful for systems with neither a video console nor a serial port). .It Va kernel -.Pq Dq /kernel +.Pq Dq /boot/kernel/kernel .It Va loader_conf_files .Pq Do /boot/loader.conf /boot/loader.conf.local Dc .It Va splash_bmp_load Index: nextboot.8 =================================================================== RCS file: /home/ncvs/src/sbin/nextboot/nextboot.8,v retrieving revision 1.16 diff -u -r1.16 nextboot.8 --- nextboot.8 2001/07/15 07:49:09 1.16 +++ nextboot.8 2002/03/28 23:49:48 @@ -76,14 +76,15 @@ .Pp An example of usage might be: .Bd -literal - nextboot -b /dev/rwd0 1:sd(0,a)/kernel.experimental wd(0,a)/kernel.old + nextboot -b /dev/rwd0 1:sd(0,a)/boot/kernel/kernel.experimental \\ + wd(0,a)/boot/kernel.old/kernel .Ed .Pp Which would instruct the boot blocks at the next boot, to try boot the experimental kernel off the SCSI disk. If for any reason this failed, the next boot attempt would boot the kernel -.Pa /kernel.old +.Pa /boot/kernel.old/kernel off the IDE drive. (Assuming the write-back option were enabled) If this in turn failed. The compiled in default would be used. Index: nfsstat.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/nfsstat/nfsstat.1,v retrieving revision 1.11 diff -u -r1.11 nfsstat.1 --- nfsstat.1 2001/07/10 14:16:08 1.11 +++ nfsstat.1 2002/03/29 00:36:07 @@ -63,7 +63,7 @@ .Pa /dev/kmem . .It Fl N Extract the name list from the specified system instead of the default -.Pa /kernel . +.Pa /boot/kernel/kernel . .It Fl s Only display server side statistics .It Fl W @@ -77,8 +77,8 @@ second intervals. .El .Sh FILES -.Bl -tag -width /dev/kmem -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel default kernel namelist .It Pa /dev/kmem default memory file Index: ps.1 =================================================================== RCS file: /home/ncvs/src/bin/ps/ps.1,v retrieving revision 1.42 diff -u -r1.42 ps.1 --- ps.1 2002/02/21 18:27:16 1.42 +++ ps.1 2002/03/28 23:40:40 @@ -117,7 +117,7 @@ .Tn ID . .It Fl N Extract the name list from the specified system instead of the default -.Pa /kernel . +.Pa /boot/kernel/kernel . .It Fl O Add the information associated with the space or comma separated list of keywords specified, after the process @@ -514,7 +514,7 @@ /dev name database .It Pa /var/db/kvm_kernel.db system namelist database -.It Pa /kernel +.It Pa /boot/kernel/kernel default system namelist .It Pa /proc the mount point of Index: pstat.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/pstat/pstat.8,v retrieving revision 1.33 diff -u -r1.33 pstat.8 --- pstat.8 2001/09/18 23:34:44 1.33 +++ pstat.8 2002/03/29 01:01:09 @@ -368,11 +368,11 @@ .Pa /dev/kmem . .It Fl N Extract the name list from the specified system instead of the default -.Pa /kernel . +.Pa /boot/kernel/kernel . .El .Sh FILES -.Bl -tag -width /dev/memxxx -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel namelist .It Pa /dev/mem default source of tables Index: rwhod.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/rwhod/rwhod.8,v retrieving revision 1.16 diff -u -r1.16 rwhod.8 --- rwhod.8 2001/07/15 08:02:45 1.16 +++ rwhod.8 2002/03/29 01:02:30 @@ -216,7 +216,7 @@ performs an .Xr nlist 3 on -.Pa /kernel +.Pa /boot/kernel/kernel every 30 minutes to guard against the possibility that this file is not the system image currently operating. Index: setextattr.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/setextattr/setextattr.8,v retrieving revision 1.8 diff -u -r1.8 setextattr.8 --- setextattr.8 2001/06/24 23:59:22 1.8 +++ setextattr.8 2002/03/29 01:08:51 @@ -59,13 +59,13 @@ to succeed, the attribute service must be available on the file system, and appropriate privilege may be required. .Sh EXAMPLES -.Dl # setextattr system md5 /kernel `md5 -q /kernel` +.Dl # setextattr system md5 /boot/kernel/kernel `md5 -q /boot/kernel/kernel` .Pp Set the .Dq md5 -extended attribute on the file /kernel to the string +extended attribute on the file /boot/kernel/kernel to the string containing the output of -.Dq md5 -q /kernel . +.Dq md5 -q /boot/kernel/kernel . .Sh SEE ALSO .Xr extattr 2 , .Xr extattr 3 , Index: symorder.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/symorder/symorder.1,v retrieving revision 1.12 diff -u -r1.12 symorder.1 --- symorder.1 2001/07/15 08:01:35 1.12 +++ symorder.1 2002/03/29 00:39:20 @@ -76,7 +76,7 @@ .Pp This program was specifically designed to cut down on the overhead of getting symbols from -.Pa /kernel . +.Pa /boot/kernel/kernel . .Sh DIAGNOSTICS The .Nm Index: systat.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/systat/systat.1,v retrieving revision 1.31 diff -u -r1.31 systat.1 --- systat.1 2001/10/09 16:07:32 1.31 +++ systat.1 2002/03/29 00:41:31 @@ -502,8 +502,8 @@ .Xr iostat 8 , .Xr vmstat 8 .Sh FILES -.Bl -tag -width /etc/networks -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel For the namelist. .It Pa /dev/kmem For information in main memory. Index: trpt.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/trpt/trpt.8,v retrieving revision 1.12 diff -u -r1.12 trpt.8 --- trpt.8 2001/07/15 08:06:16 1.12 +++ trpt.8 2002/03/29 01:10:21 @@ -125,8 +125,8 @@ core file other than the default, the last two arguments may be used to supplant the defaults. .Sh FILES -.Bl -tag -width /dev/kmem -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel .It Pa /dev/kmem .El .Sh SEE ALSO Index: uptime.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/w/uptime.1,v retrieving revision 1.7 diff -u -r1.7 uptime.1 --- uptime.1 2001/07/15 08:01:40 1.7 +++ uptime.1 2002/03/29 00:45:52 @@ -48,8 +48,8 @@ the number of users, and the load average of the system over the last 1, 5, and 15 minutes. .Sh FILES -.Bl -tag -width /kernel -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel +.It Pa /boot/kernel/kernel system name list .El .Sh SEE ALSO Index: vinum.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/vinum.4,v retrieving revision 1.39 diff -u -r1.39 vinum.4 --- vinum.4 2002/03/18 12:38:33 1.39 +++ vinum.4 2002/03/29 00:10:22 @@ -837,13 +837,13 @@ will not show the symbols. Check the module before starting .Nm gdb : .Bd -literal -$ file /modules/vinum.ko -/modules/vinum.ko: ELF 32-bit LSB shared object, Intel 80386, +$ file /boot/kernel/vinum.ko +/boot/kernel/vinum.ko: ELF 32-bit LSB shared object, Intel 80386, version 1 (FreeBSD), not stripped .Ed .Pp If the output shows that -.Pa /modules/vinum.ko +.Pa /boot/kernel/vinum.ko is stripped, you will have to find a version which is not. Usually this will be either in .Pa /usr/obj/sys/modules/vinum/vinum.ko Index: vmstat.8 =================================================================== RCS file: /home/ncvs/src/usr.bin/vmstat/vmstat.8,v retrieving revision 1.22 diff -u -r1.22 vmstat.8 --- vmstat.8 2001/07/15 08:01:40 1.22 +++ vmstat.8 2002/03/29 00:44:35 @@ -91,7 +91,7 @@ Extract the name list from the specified .Ar system instead of the default -.Pa /kernel . +.Pa /boot/kernel/kernel . .It Fl m Report on the usage of kernel dynamic memory listed first by size of allocation and then by type of usage. @@ -297,8 +297,8 @@ and display statistics on those devices, as well as other systems statistics every second. .Sh FILES -.Bl -tag -width /dev/kmemxxx -compact -.It Pa /kernel +.Bl -tag -width /boot/kernel/kernel -compact +.It Pa /boot/kernel/kernel default kernel namelist .It Pa /dev/kmem default memory file Index: w.1 =================================================================== RCS file: /home/ncvs/src/usr.bin/w/w.1,v retrieving revision 1.17 diff -u -r1.17 w.1 --- w.1 2001/07/26 19:20:13 1.17 +++ w.1 2002/03/29 00:47:28 @@ -76,7 +76,7 @@ .It Fl N Extract the name list from the specified system instead of the default -.Dq /kernel . +.Dq /boot/kernel/kernel . .It Fl n Don't attempt to resolve network addresses (normally .Nm >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205042119.g44LJWAN027426>