From owner-freebsd-doc Sat Feb 8 14: 0:29 2003 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A722D37B401 for ; Sat, 8 Feb 2003 14:00:25 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BE28E43FA3 for ; Sat, 8 Feb 2003 14:00:24 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h18M0ONS048266 for ; Sat, 8 Feb 2003 14:00:24 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h18M0OZf048265; Sat, 8 Feb 2003 14:00:24 -0800 (PST) Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 729BE37B4F6 for ; Sat, 8 Feb 2003 13:55:40 -0800 (PST) Received: from mired.org (ip68-97-54-220.ok.ok.cox.net [68.97.54.220]) by mx1.FreeBSD.org (Postfix) with SMTP id 5025A43FB1 for ; Sat, 8 Feb 2003 13:55:34 -0800 (PST) (envelope-from mwm@mired.org) Received: (qmail 7398 invoked by uid 100); 8 Feb 2003 21:55:32 -0000 Message-Id: <20030208215532.7397.qmail@mired.org> Date: 8 Feb 2003 21:55:32 -0000 From: Mike Meyer Reply-To: Mike Meyer To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/48101: There's no documentation on the fixit disk anywhere. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 48101 >Category: docs >Synopsis: There's no documentation on the fixit disk anywhere. >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Feb 08 14:00:24 PST 2003 >Closed-Date: >Last-Modified: >Originator: Mike Meyer >Release: FreeBSD 4.7-STABLE i386 >Organization: Meyer Consulting >Environment: System: FreeBSD guru.mired.org 4.7-STABLE FreeBSD 4.7-STABLE #17: Wed Oct 30 09:13:02 CST 2002 mwm@guru.mired.org:/sharetmp/obj/usr/src/sys/GURU i386 >Description: There isn't any real documentation on what the fixit disk is used for anywhere on the FreeBSD site. >How-To-Repeat: Try finding that documentation. >Fix: The attached patch ands a FAQ entry that serves mostly to list the reasons one would want to use the Fixit disk, and the other sources of information that one might find useful when working with the disk. I'm not sure this is the right place to put the information, but I couldn't see any better place. 4450a4451,4519 > > > > My root file system doesn't mount. What do I do now? > > > > The fixit disk is used when your systems root file > system cannot be mounted read-only at boot time. The sole > purpose of the disk is to repair the root file system so you > can mount it, and continue the process of bringing up the > system from that point. > > The fixit CDROM has most of the functionality of a > complete FreeBSD install. It does not have > /stand, but /bin, > /sbin, /usr/bin > and /usr/sbin are all there. You > should be able to boot this CDROM and go directly to the > fixit mode. > > The fixit floppy has much less functionality. All the > tools on it are in /stand. In > particular, it does not have &man.fsck.8; or &man.newfs.8;, > but it does have &man.tar.1; and &man.restore.8;. The fixit > floppy is not bootable. You must boot the install floppy, > then insert the fixit floppy when so directed. > > There are three things that can cause your root file > system to fail to mount. Each of these has a different > solution. > > First, if your system has slices on the disk holding > the root file system, the slice table may be broken. The > tool for editing the slice table is &man.fdisk.8;. The > format of the data is documented in > /usr/include/sys/disklabel.h. > > Second, the disk label may be broken. The tool for > editing disk labels is &man.disklabel.8;. The format of the > data is documented in > /usr/include/sys/disklabel.h. > > Finally, the file system proper may be so badly broken > that it can't be mounted. The tool for fixing this is > &man.fsck.8;. The format is documented in > /usr/include/ufs/ffs/fs.h, > /usr/include/ufs/ufs/dinode.h, and > /usr/include/ufs/ufs/dir.h. Of > particular interest is the alternate superblock at block 32, > so that fsck -b 32 > disk will repair a broken > primary superblock. Note that &man.fsck.8; is > not on the fixit floppy. > > Other useful commands are &man.ed.1; and whatever you > use to restore from backups. Ed can be used to repair broken > configuration files, or to change them to deal with > nonfunctional hardware. If you are using a standard system > tool for backing up your system, then the ability to restore > backups is probably on the fixit disk. > > It is advisable to use &man.fdisk.8; - if appropriate - > to get a copy of your slice tables, and &man.disklabel.8; to get a > copy of your disk labels, and save them somewhere > safe. Printed copies for the disk your root file system is > on should be stored with the backup of the root file system. > > >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message