From owner-freebsd-doc@FreeBSD.ORG Thu Jun 19 14:45:37 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2D26537B401; Thu, 19 Jun 2003 14:45:37 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 183D743FCB; Thu, 19 Jun 2003 14:45:36 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h5JLjWkR009860; Thu, 19 Jun 2003 17:45:33 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 19 Jun 2003 17:30:38 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20030619173038.27a8c4fc.trhodes@FreeBSD.org> In-Reply-To: <20030619213857.GC408@nitro.dk> References: <20030619144421.4edd2826.trhodes@FreeBSD.org> <20030619213857.GC408@nitro.dk> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: FreeBSD-doc@FreeBSD.org cc: jim@FreeBSD.org Subject: Re: RFC: New section for the Unix Basics chapter. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jun 2003 21:45:37 -0000 On Thu, 19 Jun 2003 23:38:58 +0200 "Simon L. Nielsen" wrote: > On 2003.06.19 14:44:21 -0400, Tom Rhodes wrote: > > > In this email I have a patch to add information on symbolic permissions > > to the Unix Basics chapter of our handbook. Now I'm a little wierd on > > the table output and I know that it could use a few more > > tags, but I wanted to get a general idea before I put more work into > > it. > > > > Comments, suggestions, death threats welcome. Thanks! > > A few minor style/docbook sugestions in attached patch. General comments > below. > > > --- chapter.sgml Thu Jun 19 14:39:43 2003 > > +++ chapter.sgml.new Thu Jun 19 14:07:59 2003 > [CUT] > + > + (permissions) > + s > + SUID or SGID > + > > Set UID / Set GID or something a bit more verbose perhaps ? Perhaps. Thats actually a good idea, I'll just do it that way. > > [CUT] > > + These values are used with the chmod command > > + just like before, but with letters. For an example, you could use > > + the following command to block other users from accessing the files > > + in your home directory: > > + > > + &prompt.user;chmod go= * > > I think this is a bad example since it really doesn't prevent others > from reading e.g. dotfiles and the directory content. This section is > targeting newbies I think it's better not to let them think they can > "secure" a directory this way. I think a simple example with some > random file would be fine - like the next example. Have a better one I could use? > > > + A comma separated list can be provided when more than one set > > + of changes to a file must be made. For example the following command > > + will remove the groups and world write permission > > When referencing world here (which I think is OK) I think "(World)" or > something like that should be added group option in the table. At the time of writing, I couldn't think of a way to phrase it. Help on this would be great! > > > + Most users will do not notice this, but it should be pointed out > > + that using the octal method will only set or assign permissions to > > + a file; it does not add or delete them. This means that the octal > > + method does not have an equivalent option to the following command: > > + > > + &prompt.root; chmod u+rw FILE > > + > > + The closest octal value would be 0600 and it would not > > + be the same. > > + > > I must say that I'm not really sure what you are trying to say here. > > Mode 0600 would be the same as (the rather obscure) "chmod > u+rw-sx,go-swrx"... Ack, your right. -- Tom Rhodes