From owner-freebsd-questions@FreeBSD.ORG Fri Oct 16 23:27:41 2009 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 07617106566B for ; Fri, 16 Oct 2009 23:27:41 +0000 (UTC) (envelope-from af.gourmet@videotron.ca) Received: from relais.videotron.ca (relais.videotron.ca [24.201.245.36]) by mx1.freebsd.org (Postfix) with ESMTP id D38E98FC1D for ; Fri, 16 Oct 2009 23:27:40 +0000 (UTC) MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; charset=UTF-8 Received: from [192.168.0.51] ([96.21.103.185]) by VL-MH-MR001.ip.videotron.ca (Sun Java(tm) System Messaging Server 6.3-4.01 (built Aug 3 2007; 32bit)) with ESMTP id <0KRM005BKRU36X70@VL-MH-MR001.ip.videotron.ca> for freebsd-questions@freebsd.org; Fri, 16 Oct 2009 19:27:40 -0400 (EDT) Message-id: <4AD9016E.20302@videotron.ca> Date: Fri, 16 Oct 2009 19:27:42 -0400 From: PJ User-Agent: Thunderbird 2.0.0.23 (Windows/20090812) To: Polytropon References: <4AD8EB8F.9010900@videotron.ca> <20091017010758.088b8b8c.freebsd@edvax.de> In-reply-to: <20091017010758.088b8b8c.freebsd@edvax.de> Cc: "freebsd-questions@freebsd.org" Subject: Re: I hate to bitch but bitch I must X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Oct 2009 23:27:41 -0000 Polytropon wrote: > On Fri, 16 Oct 2009 17:54:23 -0400, PJ wrote: > >> Why is it that the manual pages, as thorough as they may be, are very, >> very confusing. >> > > A common misunderstanding about manpages can be that they > are often (wishfully?) seen as a tutorial or a howto. In > fact, they are references. > > > > >> Perhaps I am being too wary, but I find that too many >> instructions/examples are stumbling blocks to appreciation of the whole >> system: >> for instance, let's look at the instructions for changing disk labels >> with glabel or is it tunefs ? >> man glabel(8): >> >> for UFS the file system label is set with >> tunefs(8) >> . >> what happened to glabel? >> > > That's confusing... > > > > >> man tunefs(8) >> The *tunefs* utility cannot be >> run on an active file system. To change an active file system, it must >> be downgraded to read-only or unmounted. >> >> So, you have to run tunefs from an active file system to modify another >> disk? >> > > No. "Active file system" refers to a file system that is mounted > rw - the common method of using a file system. But in order to run > a program from a file system, the file system can as well be mounted > ro. This still allows running programs. > > A setting you'll often find is maintenance done in single user > mode; here, / is mounted ro to give access to the basic programs > in /bin and /sbin. All other partitions, including /usr, are not > mounted. They don't need to be for having a fully functional > system in maintenance mode. > > > > >> but from man tunefs: >> BUGS >> This utility should work on active file systems. >> What in hades does this mean--just above it says cannot be run on active >> file systems. ??? >> > > It "should". This means: Don't try that. :-) > > My printer isn't printing! > But it should. > No, it is not printing! > Yes, but it should. > :-) > > Aha! Gotcha! Whoever wrote that has made an unintentionnal booboo. It is a subtle difference and is indicative that whoever wrote it is not a native english user... the meaning is clearly "should be executed, done, carried out, performed" - should work means it can be carried out - I think the author meant to say "should not be done" > > >> To change the root file >> system, the system must be rebooted after the file system is tuned. >> >> You can tune a file system, but you cannot tune a fish. >> How cute... And fish eat bugs. >> > > Nice you found this. :-) > > > > >> Seriously, now to the manual: >> To create a permanent label for a UFS2 file system without destroying >> any data, issue the following command: >> # tunefs -L /home/ /dev/da3 >> >> Oh? home is what? What does this have to do with the partitions? >> > > The volume name, according to the manual, is "/home/" now, > isn't it? > > > > >> from manual: >> # tunefs -L /home/ //dev/da3/ >> > > I cannot find this in the tunefs manual in group 8... It > seems that there are too many /s in it... > > typo, sorry > > >> Do people who write this stuff ever read it? Tell me that its clear and >> simple and to the point... so far, I have been running back and forth >> between half a dozen web pages trying to understand what is going on... >> and doing things through a dense fog does not produce creative results! >> > > Wow... I'm having problems now, too. Maybe I should re-read > the manpages a few times... > I agree that the manual is not intended as a tutorial... but then what is a manual but a source for a tutorial... ;-)