From owner-freebsd-doc Sun Jul 16 07:57:12 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id HAA27111 for doc-outgoing; Sun, 16 Jul 1995 07:57:12 -0700 Received: from nic.wat.hookup.net (root@nic.wat.hookup.net [198.133.162.1]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id HAA27105 for ; Sun, 16 Jul 1995 07:57:09 -0700 Received: from proton.genesoft.com (proton.genesoft.com [204.138.108.2]) by nic.wat.hookup.net (8.6.12/1.12) with SMTP id KAA03402; Sun, 16 Jul 1995 10:56:58 -0400 Received: by proton.genesoft.com (NX5.67e/NX3.0S) id AA01067; Sun, 16 Jul 95 10:59:38 -0400 Date: Sun, 16 Jul 95 10:59:38 -0400 Message-Id: <9507161459.AA01067@proton.genesoft.com> To: doc@freebsd.org X-Mailer: Lynx, Version 2.1 Personal_Name: J Cassidy From: jcassidy@proton.genesoft.com Subject: Ascii version Sender: doc-owner@freebsd.org Precedence: bulk Hello, where might I find an ascii version of the Handbook? I'm at the cottage and would like to read through it, but would rather read it offline due to long distance charges. If you could provide me with an ftp site and path name, I would be grateful. Thanks, Jim. From owner-freebsd-doc Sun Jul 16 08:17:44 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id IAA27574 for doc-outgoing; Sun, 16 Jul 1995 08:17:44 -0700 Received: from kryten.atinc.com ([198.138.38.7]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id IAA27564 for ; Sun, 16 Jul 1995 08:17:39 -0700 Received: (jmb@localhost) by kryten.atinc.com (8.6.9/8.3) id LAA11314; Sun, 16 Jul 1995 11:10:43 -0400 Date: Sun, 16 Jul 1995 11:10:42 -0400 (EDT) From: "Jonathan M. Bresler" Subject: Re: Ascii version To: jcassidy@proton.genesoft.com cc: doc@freebsd.org In-Reply-To: <9507161459.AA01067@proton.genesoft.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: doc-owner@freebsd.org Precedence: bulk On Sun, 16 Jul 1995 jcassidy@proton.genesoft.com wrote: > Hello, where might I find an ascii version of the Handbook? > I'm at the cottage and would like to read through it, but > would rather read it offline due to long distance charges. > > If you could provide me with an ftp site and path name, I > would be grateful. if you have the sgml and a system running, you can use 'sgmlfmt -ascii ' to get the ascii version. it really does leave something to be desired. > > Thanks, > Jim. > > Jonathan M. Bresler jmb@kryten.atinc.com | Analysis & Technology, Inc. FreeBSD Postmaster jmb@FreeBSD.Org | 2341 Jeff Davis Hwy play go. | Arlington, VA 22202 ride bike. hack FreeBSD.--ah the good life | 703-418-2800 x346 From owner-freebsd-doc Sun Jul 16 12:26:06 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id MAA05848 for doc-outgoing; Sun, 16 Jul 1995 12:26:06 -0700 Received: from violet.berkeley.edu (violet.Berkeley.EDU [128.32.155.22]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id MAA05841 for ; Sun, 16 Jul 1995 12:26:03 -0700 Received: by violet.berkeley.edu (8.6.10/1.33r) id MAA02196; Sun, 16 Jul 1995 12:26:02 -0700 Date: Sun, 16 Jul 1995 12:26:02 -0700 From: jkh@violet.berkeley.edu (Jordan K. Hubbard) Message-Id: <199507161926.MAA02196@violet.berkeley.edu> To: doc@freebsd.org, sure@violet.berkeley.edu, theres.some.FAQ.material.here...- Subject: somehow, Im Sender: doc-owner@freebsd.org Precedence: bulk Path: agate!newsxfer.itd.umich.edu!zip.eecs.umich.edu!caen!msunews!harbinger.cc.monash.edu.au!yarrina.connect.com.au!warrane.connect.com.au!godzilla.zeta.org.au!not-for-mail From: bde@zeta.org.au (Bruce Evans) Newsgroups: comp.unix.bsd.freebsd.misc Subject: Re: How to disklabel new SCSI drive? Date: 16 Jul 1995 06:53:39 +1000 Organization: Kralizec Dialup Unix Sydney - +61-2-837-1183, v.32bis v.42bis Lines: 80 Message-ID: <3u99sj$uv3@godzilla.zeta.org.au> References: <3trr3s$ef@mips.infocom.com> NNTP-Posting-Host: godzilla.zeta.org.au Keywords: SCSI, disklabel, NCR In article <3trr3s$ef@mips.infocom.com>, Dave Hovemeyer wrote: >I'm having lots of trouble trying to disklabel a new SCSI drive. >I have made an entry in /etc/disktab, but when I try to label the >drive the following happens: > > mips# disklabel -w /dev/sd1 sea32550N > disklabel: ioctl DIOCWDINFO: Operation not supported by device > >What am I doing wrong? Doing this using disklabel (and fdisk) is probably harder than using sysinstall. The following should work to put FreeBSD-2.0.5 on the whole of an _empty_ disk assuming that the disktab entry is correct. disklabel -r -w /dev/rsd1 sea32550N ^^ ^ The first -r is essential for writing new labels and using the raw device instead of the block device is good technique. To be `empty' the disk should have 0's at critical points on the first two sectors. In particular, the 2 byte signature at the end of the first sector must not be 0xaa55 or the disk will be interpreted as having a slice (partition) table and it will be difficult to write to it where you want unless the slice table is initialized correctly. All bootable hard disks will have the 0xaa55 signature so they won't be empty. Empty disks may be created by copying zeros over the first 2 sectors: dd if=/dev/zero of=/dev/rsd1 bs=1k count=1 Note that this will (appear to) destroy all data on the disk. The above is not the best method. Normally you will have a slice table or a label that you want to preserve or modify slightly. This can be done using fdisk -u /dev/rsd1 # install or change slice table disklabel -r -w sd1 sea32550N # install label ^no /dev/r fdisk is unintuitive and has poor error handling so it is difficult to change slice tables using it. However, to install a new slice table on an empty drive you just have to accept all the defaults except for 'n' to write at the end. Note that the sd1 drive in the above is different from /dev/rsd1. disklabel modifies path names that don't start with a slash by prefixing /dev/r and suffixing the "raw" partition letter. sd1 thus means /dev/rsd1c, i.e., the 'c' partition on the first BSD slice on drive sd1, i.e., the whole of the first BSD slice on drive sd1, while /dev/rsd1 is the whole of drive sd1. Thus `disklabel ... sd1' will fail if there is no FreeBSD slice, while `disklabel /dev/rsd1' will print the in-core label for the whole drive. Oops, this assumes that slices are enabled by the 0xaa55 signature. If slices aren't enabled, then /dev/rsd1c means the whole drive. In practice, slices have to be enabled to make the disk bootable. If there are no BSD slices, then /dev/rsd1c will be empty instead of unconfigured and attempts to label sd1 will fail with a bogus error message about /dev/rsd1c not existing. /dev/sd1 didn't exist in previous versions of FreeBSD or 386BSD so your `disklabel -w /dev/sd1 ...' would have printed a less confusing error message before failing. >The disklabel I'm trying is >sea32550N|Seagate 32550N:\ > :ty=winchester:dt=SCSI:se#512:nc#3510:nt#11:ns#108:\ > :rm#7200:\ > :pa#2433024:oa#0:ta=4.2BSD:\ > :pc#4169880:oc#0: Note that ns has to be < 64 in the slice table. I would use nt#22:ns#54. This only matters if you don't accept fdisk's default (bogus) slice table. You have to use a valid table if you want multiple slices, or the first slice starting at a nonzero offset. Starting a nonempty slice at offset 0 is invalid so sysinstall doesn't support creating such slices. -- Bruce Evans bde@zeta.org.au From owner-freebsd-doc Sun Jul 16 12:26:44 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id MAA05898 for doc-outgoing; Sun, 16 Jul 1995 12:26:44 -0700 Received: from violet.berkeley.edu (violet.Berkeley.EDU [128.32.155.22]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id MAA05891 for ; Sun, 16 Jul 1995 12:26:41 -0700 Received: by violet.berkeley.edu (8.6.10/1.33r) id MAA02243; Sun, 16 Jul 1995 12:26:40 -0700 Date: Sun, 16 Jul 1995 12:26:40 -0700 From: jkh@violet.berkeley.edu (Jordan K. Hubbard) Message-Id: <199507161926.MAA02243@violet.berkeley.edu> To: doc@freebsd.org Subject: Somehow, I am sure there is some FAQ material here.. :-) Sender: doc-owner@freebsd.org Precedence: bulk Path: agate!newsxfer.itd.umich.edu!zip.eecs.umich.edu!caen!msunews!harbinger.cc.monash.edu.au!yarrina.connect.com.au!warrane.connect.com.au!godzilla.zeta.org.au!not-for-mail From: bde@zeta.org.au (Bruce Evans) Newsgroups: comp.unix.bsd.freebsd.misc Subject: Re: How to disklabel new SCSI drive? Date: 16 Jul 1995 06:53:39 +1000 Organization: Kralizec Dialup Unix Sydney - +61-2-837-1183, v.32bis v.42bis Lines: 80 Message-ID: <3u99sj$uv3@godzilla.zeta.org.au> References: <3trr3s$ef@mips.infocom.com> NNTP-Posting-Host: godzilla.zeta.org.au Keywords: SCSI, disklabel, NCR In article <3trr3s$ef@mips.infocom.com>, Dave Hovemeyer wrote: >I'm having lots of trouble trying to disklabel a new SCSI drive. >I have made an entry in /etc/disktab, but when I try to label the >drive the following happens: > > mips# disklabel -w /dev/sd1 sea32550N > disklabel: ioctl DIOCWDINFO: Operation not supported by device > >What am I doing wrong? Doing this using disklabel (and fdisk) is probably harder than using sysinstall. The following should work to put FreeBSD-2.0.5 on the whole of an _empty_ disk assuming that the disktab entry is correct. disklabel -r -w /dev/rsd1 sea32550N ^^ ^ The first -r is essential for writing new labels and using the raw device instead of the block device is good technique. To be `empty' the disk should have 0's at critical points on the first two sectors. In particular, the 2 byte signature at the end of the first sector must not be 0xaa55 or the disk will be interpreted as having a slice (partition) table and it will be difficult to write to it where you want unless the slice table is initialized correctly. All bootable hard disks will have the 0xaa55 signature so they won't be empty. Empty disks may be created by copying zeros over the first 2 sectors: dd if=/dev/zero of=/dev/rsd1 bs=1k count=1 Note that this will (appear to) destroy all data on the disk. The above is not the best method. Normally you will have a slice table or a label that you want to preserve or modify slightly. This can be done using fdisk -u /dev/rsd1 # install or change slice table disklabel -r -w sd1 sea32550N # install label ^no /dev/r fdisk is unintuitive and has poor error handling so it is difficult to change slice tables using it. However, to install a new slice table on an empty drive you just have to accept all the defaults except for 'n' to write at the end. Note that the sd1 drive in the above is different from /dev/rsd1. disklabel modifies path names that don't start with a slash by prefixing /dev/r and suffixing the "raw" partition letter. sd1 thus means /dev/rsd1c, i.e., the 'c' partition on the first BSD slice on drive sd1, i.e., the whole of the first BSD slice on drive sd1, while /dev/rsd1 is the whole of drive sd1. Thus `disklabel ... sd1' will fail if there is no FreeBSD slice, while `disklabel /dev/rsd1' will print the in-core label for the whole drive. Oops, this assumes that slices are enabled by the 0xaa55 signature. If slices aren't enabled, then /dev/rsd1c means the whole drive. In practice, slices have to be enabled to make the disk bootable. If there are no BSD slices, then /dev/rsd1c will be empty instead of unconfigured and attempts to label sd1 will fail with a bogus error message about /dev/rsd1c not existing. /dev/sd1 didn't exist in previous versions of FreeBSD or 386BSD so your `disklabel -w /dev/sd1 ...' would have printed a less confusing error message before failing. >The disklabel I'm trying is >sea32550N|Seagate 32550N:\ > :ty=winchester:dt=SCSI:se#512:nc#3510:nt#11:ns#108:\ > :rm#7200:\ > :pa#2433024:oa#0:ta=4.2BSD:\ > :pc#4169880:oc#0: Note that ns has to be < 64 in the slice table. I would use nt#22:ns#54. This only matters if you don't accept fdisk's default (bogus) slice table. You have to use a valid table if you want multiple slices, or the first slice starting at a nonzero offset. Starting a nonempty slice at offset 0 is invalid so sysinstall doesn't support creating such slices. -- Bruce Evans bde@zeta.org.au From owner-freebsd-doc Sun Jul 16 21:54:34 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id VAA29335 for doc-outgoing; Sun, 16 Jul 1995 21:54:34 -0700 Received: from emory.mathcs.emory.edu (emory.mathcs.emory.edu [128.140.2.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id VAA29325 ; Sun, 16 Jul 1995 21:54:31 -0700 Received: from bagend.UUCP by emory.mathcs.emory.edu (5.65/Emory_mathcs.4.0.14) via UUCP id AA29977 ; Mon, 17 Jul 95 00:54:30 -0400 Received: by bagend.atl.ga.us (Smail3.1.29.1 #1) id m0sXhSj-0004pHC; Mon, 17 Jul 95 00:07 EDT Message-Id: From: jan@bagend.atl.ga.us (Jan Isley) Subject: Re: Dc_Users Group Meeting To: freebsd-hackers@freebsd.org (FreeBSD Hackers) Date: Mon, 17 Jul 1995 00:07:20 -0400 (EDT) Cc: freebsd-doc@freebsd.org (FreeBSD Doc) In-Reply-To: <5476.805148822@time.cdrom.com> from "Jordan K. Hubbard" at Jul 7, 95 01:27:02 pm X-Mailer: ELM [version 2.4 PL24] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 5915 Sender: doc-owner@freebsd.org Precedence: bulk Jordan K. Hubbard wrote: > > - Improving documentation ... deletia ... This would be > > directed at first time users and the corperate market. > Yes! I was just discussing this as one of my primary goals for 2.1, > in fact. If one reads the newsgroups for any length of time, in fact, > it becomes quickly and distressingly apparent that people are still > very much confused by some of our "highly assumptive" documentation. > We're still not taking it well into account that most users are LAZY > SCHMUCKS WHO WOULDN'T READ A MANUAL IF YOU WHAPPED THEM UPSIDE THE > HEAD WITH IT! I MEAN, I MEAN, *SLAP*. Uh. Thanks, I needed that. > Sorry to rave, and what I meant to say was that given that most users > aren't going to wade through lots of doc, the goal shouldn't be to > generate *more* doc so much as to generate *better* doc. that' a lot to quote, but what to leave out ? Yes, yes, yes, and it is not all the average schmucks' fault. The closest, decent computer book store to me by 20 miles is Microcenter. There are at *least* 50 very thick, 19.95 or less, System V books on their shelf, if not more, lots more. They have about a dozen Linux books on the shelf. And they have 3 BSD books. Two are way old, and they all cost over $50. Make that extra 20 mile drive and you can find 5 or 6 more books on BSD, none of them complete enough to not need to buy the whole set, there goes $200 bucks, give or take $50. So the average DOS dude has not bought these books, has he? Heck, he can buy a Linux book for $25 AND IT COMES WITH A CD OR TWO! Maybe where you live they have better, cheaper books, but not here they don't. I have sysv books out the wazoo, but I thought it was time to learn BSD. I needed to get anything on this system except Linux so I turned to FreeBSD. Sounds good, doesn't it? FreeBSD. None of the books that I have collected over that last 10 years are any help at all starting BSD from scratch. There ARE some extremely helpful folk associated with FreeBSD. You have to wonder though... I have said RTFM plenty of times myself, but often when someone gets RTFM around here, TFM they mean is way down the source tree some where, not the man page. This is not just a bitch session folks. I am trying to help. I am unfortunately, one of those BSD ignorant schmucks. If FreeBSD is to "gain market share" in a market dominated by sysv-isms, the documents need to improve or the newbies will stay away in droves. > By "better" I mean documentation that presents more of the crucial > stuff up-front, takes care to explain its terms early so that people > don't have to read 4 pages in to see that by "FAQ" we meant > /usr/share/FAQ/blah/blah and (and this is most important) actually > tries to be self-consistent with documentation conventions and > explaining things in the proper order. Our docs are riddled with > bogons like referring to the FAQ as "The FreeBSD FAQ" in one This is very important. You guys have no idea how important. You have all been working on this for years and things that are obvious and unimportant to you may be the things that sends newbies running back to Linux, even the ones that tried to RTFM first. And it sure needs to be better than most of what I have seen in the Linux how-to world. No wonder newbies don't read those how-to's! Like, many of them are LINUX RULZ D00D, who cares if they are correct. > When a user sees something in our own docs > that's plainly wrong for the release they're now using, it hardly > inspires confidence that we didn't even care enough about it to even > update it! :-( I wonder how many sales Diamond has lost over bogons in Linux X docs. How many they will still be losing a year from now ... > > - The creation and support of turnkey systems for users. This would > > be directed at a certian use such as routing, firewall, and Internet > > connectivity. > > You must be a mind-reader - I was just talking to some folks about > just such a system the other day.. I had envisioned some Tk based > interface that let you configure your machine as anything from a > router to a firewall to a corporate mail server, just by clicking the > relevant buttons and typing the right information when it popped up in > your face and asked for it. Such a system wouldn't take more than 6 ... > machine. If we could offer a more server oriented "Internet in a box" > equivalent to such people, it would be a terrific boon. ... > Lest we forget, Internet servers are also hardly the only turnkey apps > around. Long before we came on the scene, SCO was selling into > warehouse inventory control systems and point-of-sales apps (next time > you go to the movie theater, you may be amused to know that the screen > the sales clerk is typing on goes to a SCO box in the back) and all of > these are ripe and fertile ground for FreeBSD, if only someone would > jump in and write the business side. This same market helped NCR stay in business for years. And not for the last time am I going to say this. The biggest market out there is not webb servers, it is not video rental stores, it is the average schmuck at home, just like me, no networking, just a modem. I hear you laughing... don't. FreeBSD may have networking that walks on water and gives change. Most Joe Schmucks will never know anything about networking. The Joe Schmucks of the world are the ones who buy most of the computers. I *am* very impressed with FreeBSD. I have not managed to get it up and running good enough to shut down Linux, but I *am* very impressed with it! This was posted to hackers. Your average mail user agent does not have a followup-to header. :) I guess this belongs to doc or dev/null. -- Jan Isley Heroes have the shelf life of cottage cheese, jan@bagend.atl.ga.us and public memory is shorter than Dudley Moore. -- Rheta Grimsley Johnson From owner-freebsd-doc Mon Jul 17 06:33:45 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id GAA29800 for doc-outgoing; Mon, 17 Jul 1995 06:33:45 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id GAA29793 for ; Mon, 17 Jul 1995 06:33:43 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id JAA06907; Mon, 17 Jul 1995 09:33:58 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507171333.JAA06907@grendel.csc.smith.edu> Subject: Re: Ascii version To: jmb@kryten.Atinc.COM (Jonathan M. Bresler) Date: Mon, 17 Jul 1995 09:33:57 -0400 (EDT) Cc: jcassidy@proton.genesoft.com, doc@freebsd.org In-Reply-To: from "Jonathan M. Bresler" at Jul 16, 95 11:10:42 am Content-Type: text Content-Length: 990 Sender: doc-owner@freebsd.org Precedence: bulk Jonathan M. Bresler writes: > On Sun, 16 Jul 1995 jcassidy@proton.genesoft.com wrote: > > Hello, where might I find an ascii version of the Handbook? > > I'm at the cottage and would like to read through it, but > > would rather read it offline due to long distance charges. > > > > If you could provide me with an ftp site and path name, I > > would be grateful. > > if you have the sgml and a system running, you can use 'sgmlfmt > -ascii ' to get the ascii version. it really does leave something > to be desired. Or you can fetch http://www.freebsd.org/How/handbook/handbook.txt. Even better, you can grab the HTML files (http://www.freebsd.org/How/handbook/handbook-html.tar.gz) and view them offline using your favorite HTML browser. Just start with the file handbook.html. And yes, the ASCII version leaves a LOT to be desired, like cross references, decent formatting and the like. -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Tue Jul 18 06:02:40 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id GAA25497 for doc-outgoing; Tue, 18 Jul 1995 06:02:40 -0700 Received: from emory.mathcs.emory.edu (emory.mathcs.emory.edu [128.140.2.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id GAA25486 for ; Tue, 18 Jul 1995 06:02:36 -0700 Received: from bagend.UUCP by emory.mathcs.emory.edu (5.65/Emory_mathcs.4.0.14) via UUCP id AA06728 ; Tue, 18 Jul 95 09:02:31 -0400 Received: by bagend.atl.ga.us (Smail3.1.29.1 #1) id m0sYCG6-0004pHC; Tue, 18 Jul 95 09:00 EDT Message-Id: From: jan@bagend.atl.ga.us (Jan Isley) Subject: Re: Quick start installation To: jfieber@grendel.csc.smith.edu (John Fieber) Date: Tue, 18 Jul 1995 09:00:22 -0400 (EDT) Cc: kelly@fsl.noaa.gov, doc@freebsd.org In-Reply-To: <199507142140.RAA12422@grendel.csc.smith.edu> from "John Fieber" at Jul 14, 95 05:40:21 pm X-Mailer: ELM [version 2.4 PL24] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 742 Sender: doc-owner@freebsd.org Precedence: bulk John Fieber wrote: > Sean Kelly writes: > > * Concern: when using dd to make a floppy from an image, you might > > need to specify the block size on some systems. (I thought you > > needed `bs=18b' on FreeBSD as well!) Maybe we should mention this. > I don't think you *need* the blocksize, but I think an > appropriate blocksize makes things go a little faster. Am I > wrong? Anybody know optimal block sizes? Define optimal. :) Optimal block sizes for dd to a floppy would be the size of the track. For a 1.44MB floppy try bs=18k. -- Jan Isley Heroes have the shelf life of cottage cheese, jan@bagend.atl.ga.us and public memory is shorter than Dudley Moore. -- Rheta Grimsley Johnson From owner-freebsd-doc Tue Jul 18 06:58:14 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id GAB05616 for doc-outgoing; Tue, 18 Jul 1995 06:58:14 -0700 Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id GAA03816 for ; Tue, 18 Jul 1995 06:52:12 -0700 Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA23048; Tue, 18 Jul 95 07:41:46 -0600 Received: by emu.fsl.noaa.gov (1.38.193.4/SMI-4.1 (1.38.193.4)) id AA05571; Tue, 18 Jul 1995 07:44:53 -0600 Date: Tue, 18 Jul 1995 07:44:53 -0600 From: kelly@fsl.noaa.gov (Sean Kelly) Message-Id: <9507181344.AA05571@emu.fsl.noaa.gov> To: jan@bagend.atl.ga.us Cc: jfieber@grendel.csc.smith.edu, doc@freebsd.org In-Reply-To: (jan@bagend.atl.ga.us) Subject: Re: Quick start installation Sender: doc-owner@freebsd.org Precedence: bulk >>>>> "Jan" == Jan Isley writes: Jan> John Fieber wrote: >> Sean Kelly writes: > * Concern: when using dd to make a floppy >> from an image, you might > need to specify the block size on >> some systems. (I thought you > needed `bs=18b' on FreeBSD as >> well!) Maybe we should mention this. >> I don't think you *need* the blocksize, but I think an >> appropriate blocksize makes things go a little faster. Am I >> wrong? Anybody know optimal block sizes? Jan> Define optimal. :) Optimal block sizes for dd to a floppy Jan> would be the size of the track. But for a ``quick start'' document, the KISS principle applies, so John had the right idea: just leave bs options out! -- Sean Kelly NOAA Forecast Systems Lab, Boulder Colorado USA I looked out my apartment window, and I saw a bird wearing sneakers and a button saying, "I ain't flying no where." I said, "What's your problem buddy?" He said, "I'm sick of this stuff -- winter here, summer there, winter here, summer there. I don't know who thought this stuff up, but it certainly wasn't a bird." I said, "Well, I was just making breakfast, come on in. Want some eggs? Sorry." -- Steven Wright From owner-freebsd-doc Tue Jul 18 08:19:20 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id IAA25640 for doc-outgoing; Tue, 18 Jul 1995 08:19:20 -0700 Received: from emory.mathcs.emory.edu (emory.mathcs.emory.edu [128.140.2.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id IAA25634 for ; Tue, 18 Jul 1995 08:19:18 -0700 Received: from bagend.UUCP by emory.mathcs.emory.edu (5.65/Emory_mathcs.4.0.14) via UUCP id AA12315 ; Tue, 18 Jul 95 11:18:29 -0400 Received: by bagend.atl.ga.us (Smail3.1.29.1 #1) id m0sYE1x-0004pHC; Tue, 18 Jul 95 10:53 EDT Message-Id: From: jan@bagend.atl.ga.us (Jan Isley) Subject: Re: Quick start installation To: kelly@fsl.noaa.gov (Sean Kelly) Date: Tue, 18 Jul 1995 10:53:52 -0400 (EDT) Cc: jfieber@grendel.csc.smith.edu, doc@freebsd.org In-Reply-To: <9507181344.AA05571@emu.fsl.noaa.gov> from "Sean Kelly" at Jul 18, 95 07:44:53 am X-Mailer: ELM [version 2.4 PL24] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 1237 Sender: doc-owner@freebsd.org Precedence: bulk Ah, I think I missed the start of this. I am new to the doc list. My first take would be that if you are talking about dd instead of dos's rawrite.exe, tell them to use bs. dd if=boot.flp of=/dev/fd0 bs=18k is pretty darn simple. On every system I have played with, not using bs=18k makes the write take so much longer you are sitting there wondering if something has gone wrong. I know, assuming that because they are using dd that they know what you are talking about is a BAD assumption. Never mind. :) Sean Kelly wrote: > >>>>> "Jan" == Jan Isley writes: > Jan> John Fieber wrote: > >> I don't think you *need* the blocksize, but I think an > >> appropriate blocksize makes things go a little faster. Am I > >> wrong? Anybody know optimal block sizes? > Jan> Define optimal. :) Optimal block sizes for dd to a floppy > Jan> would be the size of the track. > But for a ``quick start'' document, the KISS principle applies, so > John had the right idea: just leave bs options out! -- Jan Isley Heroes have the shelf life of cottage cheese, jan@bagend.atl.ga.us and public memory is shorter than Dudley Moore. -- Rheta Grimsley Johnson From owner-freebsd-doc Tue Jul 18 09:15:23 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id JAA28473 for doc-outgoing; Tue, 18 Jul 1995 09:15:23 -0700 Received: from grendel.csc.smith.edu ([131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id JAA28467 for ; Tue, 18 Jul 1995 09:15:22 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id MAA19768; Tue, 18 Jul 1995 12:15:45 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507181615.MAA19768@grendel.csc.smith.edu> Subject: Re: Quick start installation To: jan@bagend.atl.ga.us (Jan Isley) Date: Tue, 18 Jul 1995 12:15:45 -0400 (EDT) Cc: kelly@fsl.noaa.gov, doc@freebsd.org In-Reply-To: from "Jan Isley" at Jul 18, 95 10:53:52 am Content-Type: text Content-Length: 488 Sender: doc-owner@freebsd.org Precedence: bulk Jan Isley writes: > is pretty darn simple. On every system I have played with, not > using bs=18k makes the write take so much longer you are sitting > there wondering if something has gone wrong. Forgive me for asking a stupid question (but I went from CP/M --> Amiga --> PC, and the phonomena of 1.2MB came and went during my Amiga years) but is this block size appropriate for 1.2MB floppies as well? -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Tue Jul 18 10:15:25 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id KAA00830 for doc-outgoing; Tue, 18 Jul 1995 10:15:25 -0700 Received: from emory.mathcs.emory.edu (emory.mathcs.emory.edu [128.140.2.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id KAA00813 for ; Tue, 18 Jul 1995 10:15:18 -0700 Received: from bagend.UUCP by emory.mathcs.emory.edu (5.65/Emory_mathcs.4.0.14) via UUCP id AA17489 ; Tue, 18 Jul 95 13:15:11 -0400 Received: by bagend.atl.ga.us (Smail3.1.29.1 #1) id m0sYFrZ-0004pHC; Tue, 18 Jul 95 12:51 EDT Message-Id: From: jan@bagend.atl.ga.us (Jan Isley) Subject: Re: Quick start installation To: jfieber@grendel.csc.smith.edu (John Fieber) Date: Tue, 18 Jul 1995 12:51:17 -0400 (EDT) Cc: kelly@fsl.noaa.gov, doc@freebsd.org In-Reply-To: <199507181615.MAA19768@grendel.csc.smith.edu> from "John Fieber" at Jul 18, 95 12:15:45 pm X-Mailer: ELM [version 2.4 PL24] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 820 Sender: doc-owner@freebsd.org Precedence: bulk John Fieber wrote: > Forgive me for asking a stupid question (but I went from CP/M --> > Amiga --> PC, and the phonomena of 1.2MB came and went during my > Amiga years) but is this block size appropriate for 1.2MB > floppies as well? I thought about that just about the time the modem fired off the last message. I have not been a DOS weenie since running 2.11 on my Seatle Computer Products Gazelle, a 10MHz 8086/8087 S-100 system. Yea, S-100. It seemed like a good idea at the time. :) Anyway, as I recall, a 1.2 floppy uses 15 sectors/track and a 1.44 floppy uses 18 sectors/track. So that would be bs=15k or bs=18k. -- Jan Isley Heroes have the shelf life of cottage cheese, jan@bagend.atl.ga.us and public memory is shorter than Dudley Moore. -- Rheta Grimsley Johnson From owner-freebsd-doc Tue Jul 18 10:30:13 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id KAA01240 for doc-outgoing; Tue, 18 Jul 1995 10:30:13 -0700 Received: from cs.weber.edu (cs.weber.edu [137.190.16.16]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id KAA01234 for ; Tue, 18 Jul 1995 10:30:10 -0700 Received: by cs.weber.edu (4.1/SMI-4.1.1) id AA24112; Tue, 18 Jul 95 11:22:32 MDT From: terry@cs.weber.edu (Terry Lambert) Message-Id: <9507181722.AA24112@cs.weber.edu> Subject: Re: Quick start installation To: jfieber@grendel.csc.smith.edu (John Fieber) Date: Tue, 18 Jul 95 11:22:32 MDT Cc: jan@bagend.atl.ga.us, kelly@fsl.noaa.gov, doc@freebsd.org In-Reply-To: <199507181615.MAA19768@grendel.csc.smith.edu> from "John Fieber" at Jul 18, 95 12:15:45 pm X-Mailer: ELM [version 2.4dev PL52] Sender: doc-owner@freebsd.org Precedence: bulk > > Jan Isley writes: > > is pretty darn simple. On every system I have played with, not > > using bs=18k makes the write take so much longer you are sitting > > there wondering if something has gone wrong. > > Forgive me for asking a stupid question (but I went from CP/M --> > Amiga --> PC, and the phonomena of 1.2MB came and went during my > Amiga years) but is this block size appropriate for 1.2MB > floppies as well? fd0196ds15 <-- 15k Terry Lambert terry@cs.weber.edu --- Any opinions in this posting are my own and not those of my present or previous employers. From owner-freebsd-doc Tue Jul 18 11:36:37 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id LAA04170 for doc-outgoing; Tue, 18 Jul 1995 11:36:37 -0700 Received: from grendel.csc.smith.edu ([131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id LAA04150 for ; Tue, 18 Jul 1995 11:36:35 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id OAA15698; Tue, 18 Jul 1995 14:37:47 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507181837.OAA15698@grendel.csc.smith.edu> Subject: Re: Documentation To: bsletten@vivid.autometric.com Date: Tue, 18 Jul 1995 14:37:47 -0400 (EDT) Cc: doc@freebsd.org In-Reply-To: <9507181222.ZM29598@jester.autometric.com> from "Brian Sletten" at Jul 18, 95 12:22:02 pm Content-Type: text Content-Length: 2302 Sender: doc-owner@freebsd.org Precedence: bulk [cc'd to doc@freebsd.org, I hope you don't mind...] Brian J. Sletten > Hi, John. Jonathan Bresler pointed me to you as the documentation > meister. As you may have heard, the DC FreeBSD group wants to > help out with documentation. I was wondering if you could let me > know what exists, what is needed, and where the central > repository might exist. Lets see.... Yes, a repository exists in freebsd-current. In particular, /usr/src/share/doc/faq and /usr/src/share/doc/handbook. Both documents are tagged according to the linuxdoc DTD (sgml) and can be converted to other formats using the sgmlfmt(1) command. I'm not the direct maintainer of the FAQ, but will comment that it needs a MAJOR overhaul. The handbook is my bag of worms. What is needed for the handbook is: 1) Extensive proofreading and correction. 2) New material For the first option, many statements need to be checked against reality. Cross references need to be placed. Grammer needs to be formalized and normalized. Many sections are obviously unedited documents that formerly stood on their own and they need to be "edited in" such that redundant material is replaced with cross references to the appropriate sections. For new material, sections mared with * need to be written! I have a couple in-progress, namely kernel config and adding/configuring disks. I also have a submitted section on DES/MD5 but it needs some editing before going in. Also, don't feel restricted to the "table-of-contents" that currently exists. In particular, I'm thinking of a bit of restructuring that would create a "basic system administration" part, followed by an "ISP guide" covering the things ISP types need/want to know about setting up services. For people unfamiliar with SGML, I'm perfectly happy to accept plain text or LaTeX. Finally, on the WWW side of things, I'd like to see a home page for the user groups! I'd rather not maintain them myself, but I'll certainly provide a directory page with hints about starting a group. If the group members cannot supply a home machine for their pages, I'm shure it could be arranged to make an account on www.freebsd.org so someone could maintain a page there. -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Tue Jul 18 11:50:55 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id LAA05504 for doc-outgoing; Tue, 18 Jul 1995 11:50:55 -0700 Received: from grunt.grondar.za (grunt.grondar.za [196.7.18.129]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id LAA05470 for ; Tue, 18 Jul 1995 11:50:29 -0700 Received: from grumble.grondar.za (grumble.grondar.za [196.7.18.130]) by grunt.grondar.za (8.6.11/8.6.9) with ESMTP id UAA02285; Tue, 18 Jul 1995 20:50:02 +0200 Received: from localhost (localhost [127.0.0.1]) by grumble.grondar.za (8.6.11/8.6.9) with SMTP id UAA07570; Tue, 18 Jul 1995 20:50:01 +0200 Message-Id: <199507181850.UAA07570@grumble.grondar.za> X-Authentication-Warning: grumble.grondar.za: Host localhost didn't use HELO protocol To: jfieber@grendel.csc.smith.edu (John Fieber) cc: doc@freebsd.org Subject: Re: Documentation Date: Tue, 18 Jul 1995 20:50:01 +0200 From: Mark Murray Sender: doc-owner@freebsd.org Precedence: bulk Dug out of a message... > For new material, sections mared with * need to be written! > I have a couple in-progress, namely kernel config and > adding/configuring disks. I also have a submitted section on > DES/MD5 but it needs some editing before going in. I was wondering about that DES/MD5 section. :-). Point me at the problems and I'll fix it. M -- Mark Murray 46 Harvey Rd, Claremont, Cape Town 7700, South Africa +27 21 61-3768 GMT+0200 From owner-freebsd-doc Tue Jul 18 12:24:49 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id MAA08406 for doc-outgoing; Tue, 18 Jul 1995 12:24:49 -0700 Received: from grendel.csc.smith.edu ([131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id MAA08389 for ; Tue, 18 Jul 1995 12:24:47 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id PAA03277; Tue, 18 Jul 1995 15:25:36 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507181925.PAA03277@grendel.csc.smith.edu> Subject: Re: Documentation To: mark@grondar.za (Mark Murray) Date: Tue, 18 Jul 1995 15:25:36 -0400 (EDT) Cc: doc@freebsd.org In-Reply-To: <199507181850.UAA07570@grumble.grondar.za> from "Mark Murray" at Jul 18, 95 08:50:01 pm Content-Type: text Content-Length: 1363 Sender: doc-owner@freebsd.org Precedence: bulk Mark Murray writes: > I was wondering about that DES/MD5 section. :-). > Point me at the problems and I'll fix it. It starts off really good, but then gets a confusing when discussing the libraries. I started changing things but I don't think there was a net improvement. Then I've gotten busy. (I'm moving in a week and a half; major life transition type of thing.) A plan C that might work is to reverse the order of topics and start off with a brief overview checklist: 1. If you do not install *any* of the security distributions: * Password encryption is MD5 * No kerberos support * No bdes(1) command * /usr/lib/libcrypt.* is a symbolic link to /usr/lib/(whatever it is) * .... 2. If you install the des package: * Password encryption is DES * You get the bdes(1) command * You get new binaries for (....) (because they are statically linked) * /usr/lib/libcrypt.* is a symbolic link to.... 3. If you install the kerberos package: * ..... and so on. THEN, we can provide the more detailed information about the implications of the different security packages. The text you supplied for the implications is great and can drop in more or less unmodified. The subsequent section on kerberos falls nicely into line as well. -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Wed Jul 19 01:35:13 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id BAA12613 for doc-outgoing; Wed, 19 Jul 1995 01:35:13 -0700 Received: from relay.hp.com (relay.hp.com [15.255.152.2]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id BAA12576 ; Wed, 19 Jul 1995 01:35:02 -0700 Received: from hpmwtd.sr.hp.com ([15.4.40.3]) by relay.hp.com with SMTP (1.37.109.16/15.5+ECS 3.3) id AA065872893; Wed, 19 Jul 1995 01:34:53 -0700 Received: from hpnmhjw.sr.hp.com by hpmwtd.sr.hp.com with SMTP (15.11.1.6/15.5+ECS 3.3) id AA10574; Wed, 19 Jul 95 01:34:48 -0700 Received: from mina.sr.hp.com by hpnmhjw.sr.hp.com with SMTP (1.37.109.15/15.5+ECS 3.3) id AA217052884; Wed, 19 Jul 1995 01:34:44 -0700 Message-Id: <199507190834.AA217052884@hpnmhjw.sr.hp.com> To: roberto@blaise.ibp.fr (Ollivier Robert) Cc: gclarkii@freebsd.org, freebsd-doc@freebsd.org Subject: Re: Who's working on the FAQ? In-Reply-To: Your message of "Tue, 11 Jul 1995 14:26:33 +0200." <199507111226.OAA01980@blaise.ibp.fr> Date: Wed, 19 Jul 1995 01:34:43 -0700 From: Darryl Okahata Sender: doc-owner@freebsd.org Precedence: bulk [ This is being cc'd to freebsd-doc to get any feedback. ] > > Has the FAQ been fixed up to handle the following? > > > > If not, I'd be willing to submit some entries for these. > > Go and send your changes. I'm a little bit short on time for the moment. Hi, Here are some changes. In addition to adding some common questions, I also changed the introduction slightly. The idea is that someone new to FreeBSD would ask questions like the following: 1. What is FreeBSD? 2. What do I need to run FreeBSD? 3. Where do I get it? I placed these close to the beginning because they are probably among the most-asked questions, and burying them in the bowels of the document would probably frustrate people and make them use Linux. ;-) Anyway, keep what you think is useful and throw out the rest. I added a question on "FreeBSD books/documents". I've mentioned some good books, but I don't know what the FreeBSD policy is regarding commercial products. Anyway, I've got no connections to any of the mentioned books/CDROMs, aside from being a customer. I didn't add/change anything regarding the serial port devices (e.g., lack of /dev/tty00, etc.), as I haven't had the time. I'm not sure what changes other people have been making, and so I didn't make a large amount of changes. If you'd like me to continue fiddling with the FAQ, just ask. Areas marked with need to be verified/corrected. Also, the section/question numbering may seem odd. They just need to be renumbered. I just chose some numbers to make the questions sequential, and I'm not trying to create some weird question hierarchy. The patches are relative to rev 1.5 of /usr/share/FAQ/Text/FreeBSD.FAQ. -- Darryl Okahata Internet: darrylo@sr.hp.com DISCLAIMER: this message is the author's personal opinion and does not constitute the support, opinion or policy of Hewlett-Packard or of the little green men that have been following him all day. =============================================================================== *** FreeBSD.FAQ.orig Tue Jul 11 23:23:56 1995 --- FreeBSD.FAQ Wed Jul 19 00:43:28 1995 *************** *** 33,38 **** --- 33,42 ---- Welcome to the FreeBSD 2.0 FAQ! This document tries to answer some of the most frequently asked questions about FreeBSD 2.0. + + The latest released version is FreeBSD 2.0.5R. (What about + current snapshots?) + If there's something you're having trouble with and you do not see it here, please send email to: *************** *** 40,49 **** Some of the instructions here will also refer to auxiliary utilities ! in the /usr/src/share/FAQ directory. CDROM purchasers and net folks ! who've grabbed the FreeBSD 2.0 `srcdist' will have these files. If ! you don't have the source distribution, then you can either grab the ! whole thing from: ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current --- 44,56 ---- Some of the instructions here will also refer to auxiliary utilities ! in the /usr/share/FAQ directory and below. If you do not have this ! directory, or if it does not contain the file that you want, you are ! probably using a version of FreeBSD prior to 2.0.5R. In this case, ! install the FreeBSD sources and look in /usr/src/share/FAQ (instead of ! /usr/share/FAQ). CDROM purchasers and net folks who've grabbed the ! FreeBSD 2.0 `srcdist' will have these files. If you don't have the ! source distribution, then you can either grab the whole thing from: ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current *************** *** 78,83 **** --- 85,115 ---- Sync PPP Improved SCSI support + 0.1.1: What do I need to run FreeBSD? + + See section 2, "Hardware compatibility", of this FAQ. + + 0.1.2: Where can I get FreeBSD? + + The distribution is available via anonymous ftp from: + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/ + + For the current release, 2.0.5R, look in: + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/2.0.5-RELEASE/ + + FreeBSD is also available via CDROM, from the following place(s): + + Walnut Creek CDROM + 4041 Pike Lane, Suite D-386 + Concord, CA 94520 USA + Orders: (800)-786-9907 + Questions: (510)-674-0783 + FAX: (510)-674-0821 + email: orders@cdrom.com + WWW: http://www.cdrom.com/ + 0.2: What are the FreeBSD mailing lists, and how can I get on them? *************** *** 123,132 **** --- 155,272 ---- (probably only for a short time longer). + 0.4: Books on FreeBSD + + There currently aren't any books written specifically for FreeBSD, although + some people are supposedly working on some. + + However, as FreeBSD 2.0 is based upon Berkeley 4.4BSD-Lite, most of the + 4.4BSD manuals are applicable to FreeBSD 2.0. O'Reilly and Associates + publishes these manuals: + + 4.4BSD System Manager's Manual + By Computer Systems Research Group, UC Berkeley + 1st Edition June 1994, 804 pages + ISBN: 1-56592-080-5 + + 4.4BSD User's Reference Manual + By Computer Systems Research Group, UC Berkeley + 1st Edition June 1994, 905 pages + ISBN: 1-56592-075-9 + + 4.4BSD User's Supplementary Documents + By Computer Systems Research Group, UC Berkeley + 1st Edition July 1994, 712 pages + ISBN: 1-56592-076-7 + + 4.4BSD Programmer's Reference Manual + By Computer Systems Research Group, UC Berkeley + 1st Edition June 1994, 886 pages + ISBN: 1-56592-078-3 + + 4.4BSD Programmer's Supplementary Documents + By Computer Systems Research Group, UC Berkeley + 1st Edition July 1994, 596 pages + ISBN: 1-56592-079-1 + + A description of these can be found via WWW as: + + http://gnn.com/gnn/bus/ora/category/bsd.html + + A good book on system administration is: + + Evi Nemeth, Garth Snyder, Scott Seebass, & Trent R. Hein, + "Unix System Administraion Handbook", Prentice-Hall, 1995, + ISBN: 0-13-151051-7 + [ Note: make sure you get the second edition, with a red cover, + instead of the first edition. ] + + This book covers the basics, as well as TCP/IP, DNS, NFS, SLIP/PPP, + sendmail, INN/NNTP, printing, etc.. It's expensive (~US$45-$55), but worth + it. It also includes a CDROM with the sources for various tools; most of + these, however, are also on the FreeBSD 2.0.5R CDROM (and the FreeBSD CDROM + often has newer versions). + + + 0.5: Other sources of information. + + One good source of additional information is the "[comp.unix.bsd] NetBSD, + FreeBSD, and 386BSD (0.1) FAQ". Much of the information is relevant to + FreeBSD, and this FAQ is posted around twice a month to the following + newsgroups: + + comp.unix.bsd.netbsd.announce + comp.unix.bsd.freebsd.announce + comp.answers + news.answers + + ( is this FAQ still being maintained/posted???) + + If you have WWW access, the FreeBSD home page is at: + + http://www.freebsd.org/ + + A FreeBSD "handbook" is being created, and can be found as: + + http://www.freebsd.org/How/handbook/ + + Note that this is a work in progress, and so parts may be incomplete. + 1 Installation -------------- + 1.0: How do I install FreeBSD? + + [ IMPORTANT NOTE: if you are installing 2.0.5R from tape, see the question + titled, "Help! I can't install from tape! The install fails with a + `record too big' error!" ] + + Installation instructions can be found as: + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/2.0.5-RELEASE/INSTALL + + Release notes are also available as: + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/2.0.5-RELEASE/RELNOTES + + On the CDROM, the following files are in the top-most directory: + + INSTALL -- Installation instructions + README.TXT -- Basic README file + RELNOTES -- Release notes + + + 1.0.1: Help! I can't install from tape! The install fails with a + "record too big" error! + + If you are installing 2.0.5R from tape, you must create the tape using a tar + blocksize of 10 (5120 bytes). The default tar blocksize is 20 (10240 + bytes), and tapes created using this default size cannot be used to install + 2.0.5R; with these tapes, you will get an error that complains about the + record size being too big. + + 1.1: I want to install FreeBSD onto a SCSI disk that has more than 1024 cylinders. How do I do it? *************** *** 179,184 **** --- 319,334 ---- No. FreeBSD 2.0 comes with bounce buffers which allows your bus mastering controller access to greater than 16MB. + 1.5.1: My network card keeps getting errors like, "ed1: timeout". What's + going on? + + This is usually caused by an interrupt conflict (e.g., two boards using + the same IRQ). FreeBSD prior to 2.0.5R used to be tolerant of + this, and the network driver would still function in the presence of IRQ + conflicts. However, with 2.0.5R and later, IRQ conflicts are no + longer tolerated. See the file, "", for more details. + + 1.6: Do I need to install the complete sources? In general, no. However, we would strongly recommend that you *************** *** 565,570 **** --- 715,867 ---- 5 Miscellaneous Questions ---------------- + + + 5.0.1: Hey! Chmod doesn't change the file permissions of symlinked files! + What's going on? + + You have to use either "-H" or "-L" together with the "-R" option to make + this work. See the chmod(1) and symlink(7) man pages for more info. + + WARNING: the "-R" option does a *RECURSIVE* chmod. Be careful about + specifying directories or symlinks to directories to chmod. If you want to + change the permissions of a directory referenced by a symlink, use chmod(1) + without any options and follow the symlink with a trailing slash ("/"). For + example, if "foo" is a symlink to directory "bar", and you want to change + the permissions of "foo" (actually "bar"), you would do something like: + + chmod 555 foo/ + + With the trailing slash, chmod will follow the symlink, "foo", to change the + permissions of the directory, "bar". + + + 5.0.2: How do I mount a CDROM? I've tried using mount(8), but it keeps on + giving me an error like, "/dev/cd0a on /mnt: Incorrect super block." + + You have to tell mount(8) the type of the device that you want to mount. By + default, mount(8) will assume the filesystem is of type "ufs". You want to + mount a CDROM filesystem, and you do this by specifying the "-t cd9660" + option to mount(8). This does, of course, assume that the CDROM contains an + ISO 9660 filesystem, which is what most CDROMs have. As of 2.0.5R, FreeBSD + also understands the Rock Ridge (long filename) extensions. + + As an example, if you want to mount the CDROM device, "/dev/cd0c", under + /mnt, you would execute: + + mount -t cd9660 /dev/cd0c /mnt + + Note that your device name ("/dev/cd0c" in this example) could be different, + depending on the CDROM interface. Note that the "-t cd9660" option just + causes the "mount_cd9660" command to be executed, and so the above example + could be shortened to: + + mount_cd9660 /dev/cd0c /mnt + + + 5.0.3: When I try to mount a CDROM, I get a "Device not configured" error. + What's going on? + + This generally means that there is no CDROM in the CDROM drive. Feed the + drive something. + + + 5.0.4: My programs occasionally die with "Signal 11" errors. What's + going on? + + This can be caused by bad hardware (memory, motherboard, etc.). Try running + a memory-testing program on your PC. Note that, even though every memory + testing program you try will report your memory as being fine, it's possible + for slightly marginal memory to pass all memory tests, yet fail under + operating conditions (such as during busmastering DMA from a SCSI + controller like the Adaptec 1542). + + + 5.0.5: Help, some of my X Window menus and dialog boxes don't work right! I + can't select them. + + Try turning off the Num Lock key. + + + 5.0.6: How do I access the virtual consoles? + + If the console is not currently displaying X Windows, just press Alt-F1 to + Alt-F12. NOTE: the default FreeBSD installation has only three (3) virtual + consoles enabled, and so only Alt-F1, Alt-F2, and Alt-F3 will work to switch + between three virtual consoles. If you want to increase this number, see + the next question. + + If the console is currently displaying X Windows, you can use Ctrl-Alt-F1, + etc. to switch to a virtual console. Note, however, that once you've + switched away from X Windows to a virtual terminal, you use only the Alt- + function key to switch to another virtual terminal or back to X Windows. + You do not also press the Ctrl key; the Ctrl-Alt-function key combination is + used only when switching from X Windows to a virtual terminal. + + + 5.0.7: How do I increase the number of virtual consoles? + + Edit /etc/ttys and add entries for "ttyv4" to "ttyvc" after the comment on + "Virtual terminals" (delete the leading whitespace in the following + example): + + # Edit the existing entry for ttyv3 in /etc/ttys and change + # "off" to "on". + ttyv3 "/usr/libexec/getty Pc" cons25 on secure + ttyv4 "/usr/libexec/getty Pc" cons25 on secure + ttyv5 "/usr/libexec/getty Pc" cons25 on secure + ttyv6 "/usr/libexec/getty Pc" cons25 on secure + ttyv7 "/usr/libexec/getty Pc" cons25 on secure + ttyv8 "/usr/libexec/getty Pc" cons25 on secure + ttyv9 "/usr/libexec/getty Pc" cons25 on secure + ttyva "/usr/libexec/getty Pc" cons25 on secure + ttyvb "/usr/libexec/getty Pc" cons25 on secure + + Use as many or as few as you want. The more virtual terminals you have, the + more resources that are used; this can be important if you have 8MB RAM or + less. You may also want to change the "secure" to "insecure". + + IMPORTANT NOTE: if you want to run X Windows, you *MUST* leave a virtual + terminal unused (or turned off). For example, if you want to attach a + virtual terminal to all of your twelve Alt-function keys, you can only + attach virtual terminals to eleven of them. The last must be left unused, + because X Windows will use it, and you will use the last Alt-function key to + switch back to X Windows (after you have switched from X Windows to a + virtual console via a Ctrl-Alt-function key). The easiest way to do this is + to disable a console by turning it off. For example, if you have a keyboard + with twelve function keys, you would change settings for virtual terminal 12 + from: + + ttyvb "/usr/libexec/getty Pc" cons25 on secure + + to: + + ttyvb "/usr/libexec/getty Pc" cons25 off secure + + If your keyboard has only ten function keys, you would end up with: + + ttyv9 "/usr/libexec/getty Pc" cons25 off secure + ttyva "/usr/libexec/getty Pc" cons25 off secure + ttyvb "/usr/libexec/getty Pc" cons25 off secure + + (You could also just delete these lines.) + + Once you have edited /etc/ttys, the next step is to make sure that you have + enough virtual terminal devices. The easiest way to do this is: + + cd /dev + ./MAKEDEV vty12 # For 12 devices + + Next, the easiest (and cleanest) way to activate the virtual consoles is to + reboot. However, if you really don't want to reboot, you can just shut down + X Windows and execute (as root): + + kill -HUP 1 + + It's imperative that you completely shut down X Windows if it is running, + before running this command. If you don't, your system will probably appear + to hang/lock up after executing the kill command. + 5.1: I've heard of something called FreeBSD-current. How do I run it, and where can I get more information? From owner-freebsd-doc Wed Jul 19 12:24:39 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id MAA07228 for doc-outgoing; Wed, 19 Jul 1995 12:24:39 -0700 Received: from server.keck.lmu.edu ([157.242.66.198]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id MAA07222 for ; Wed, 19 Jul 1995 12:24:36 -0700 Received: from bsd1.keck.lmu.edu (bsd1.keck.lmu.edu [157.242.76.5]) by server.keck.lmu.edu (8.6.8/8.6.6) with SMTP id UAA01412 for ; Wed, 19 Jul 1995 20:25:09 GMT Message-Id: <199507192025.UAA01412@server.keck.lmu.edu> Date: Wed, 19 Jul 95 12:29:54 0000 From: Stephen Tsai Organization: Loyola Marymount University X-Mailer: Mozilla 1.1N (X11; I; BSD/386 uname failed) MIME-Version: 1.0 To: doc@freebsd.org Subject: FreeBSD Handbook X-URL: http://freefall.cdrom.com/How/ Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=us-ascii Sender: doc-owner@freebsd.org Precedence: bulk Hi! I am working on setting up FreeBSD systems in the univeristy's computer lab. I am wondering if the FreeBSD Handbook will be avaliable in print or electronic form. This FreeBSD Handbook will give me a great help. Please kindly advice. Thanks. Yao-Wen Stephen Tsai 7/19/95 From owner-freebsd-doc Wed Jul 19 12:53:57 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id MAA07931 for doc-outgoing; Wed, 19 Jul 1995 12:53:57 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id MAA07904 for ; Wed, 19 Jul 1995 12:53:52 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id PAA11812; Wed, 19 Jul 1995 15:55:39 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507191955.PAA11812@grendel.csc.smith.edu> Subject: Re: FreeBSD Handbook To: tsai@server.keck.lmu.edu (Stephen Tsai) Date: Wed, 19 Jul 1995 15:55:39 -0400 (EDT) Cc: doc@freebsd.org In-Reply-To: <199507192025.UAA01412@server.keck.lmu.edu> from "Stephen Tsai" at Jul 19, 95 12:29:54 pm Content-Type: text Content-Length: 854 Sender: doc-owner@freebsd.org Precedence: bulk Stephen Tsai writes: > Hi! I am working on setting up FreeBSD systems in the univeristy's computer > lab. I am wondering if the FreeBSD Handbook will be avaliable in print or > electronic form. This FreeBSD Handbook will give me a great help. Electronic: http://www.freebsd.org/How/handbook/handbook-html.tar.gz contains all the HTML files. ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/share/doc/handbook/ contains the sgml source from which the html files come. If you are running 2.0.5 or FreeBSD-current, you can invoke the sgmlfmt(1) command on the file named handbook.sgml to generate ascii, latex, and html output. In a few days there will be a makefile so you can just type "make install" to have the html files installed in /usr/share/doc/handbook. -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Wed Jul 19 14:06:55 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id OAA10801 for doc-outgoing; Wed, 19 Jul 1995 14:06:55 -0700 Received: from ibp.ibp.fr (ibp.ibp.fr [132.227.60.30]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id OAA10795 ; Wed, 19 Jul 1995 14:06:49 -0700 Received: from blaise.ibp.fr (blaise.ibp.fr [132.227.60.1]) by ibp.ibp.fr (8.6.12/jtpda-5.0) with ESMTP id XAA09271 ; Wed, 19 Jul 1995 23:06:39 +0200 Received: from (roberto@localhost) by blaise.ibp.fr (8.6.12/jtpda-5.0) id XAA12526 ; Wed, 19 Jul 1995 23:06:38 +0200 From: roberto@blaise.ibp.fr (Ollivier Robert) Message-Id: <199507192106.XAA12526@blaise.ibp.fr> Subject: Re: Who's working on the FAQ? To: darrylo@hpnmhjw.sr.hp.com (Darryl Okahata) Date: Wed, 19 Jul 1995 23:06:37 +0200 (MET DST) Cc: gclarkii@freebsd.org, freebsd-doc@freebsd.org In-Reply-To: <199507190834.AA217052884@hpnmhjw.sr.hp.com> from "Darryl Okahata" at Jul 19, 95 01:34:43 am X-Operating-System: FreeBSD 2.2-CURRENT ctm#880 X-Mailer: ELM [version 2.4 PL24] Content-Type: text Content-Length: 449 Sender: doc-owner@freebsd.org Precedence: bulk > Here are some changes. In addition to adding some common > questions, I also changed the introduction slightly. The idea is that > someone new to FreeBSD would ask questions like the following: I'll look at them soon and incorporate them to both Text and the sgml version (for inclusion in the WWW). -- Ollivier ROBERT -=- The daemon is FREE! -=- roberto@FreeBSD.ORG FreeBSD 2.2-CURRENT #5: Fri Jul 14 12:28:04 MET DST 1995 From owner-freebsd-doc Wed Jul 19 14:37:01 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id OAA11939 for doc-outgoing; Wed, 19 Jul 1995 14:37:01 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id OAA11933 for ; Wed, 19 Jul 1995 14:37:00 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id RAA12730; Wed, 19 Jul 1995 17:38:30 -0400 From: jfieber@grendel.csc.smith.edu (John Fieber) Message-Id: <199507192138.RAA12730@grendel.csc.smith.edu> Subject: Re: Who's working on the FAQ? To: roberto@blaise.ibp.fr (Ollivier Robert) Date: Wed, 19 Jul 1995 17:38:30 -0400 (EDT) Cc: doc@freebsd.org In-Reply-To: <199507192106.XAA12526@blaise.ibp.fr> from "Ollivier Robert" at Jul 19, 95 11:06:37 pm Content-Type: text Content-Length: 404 Sender: doc-owner@freebsd.org Precedence: bulk Ollivier Robert writes: > I'll look at them soon and incorporate them to both Text and the sgml > version (for inclusion in the WWW). We should be dropping support for the text versions soon. As soon as I get a bsd.sgml.mk constructed, most of the ASCII stuff will go up in a puff of smoke since its out of date anyway. -john === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush === From owner-freebsd-doc Fri Jul 21 17:28:07 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.11/8.6.6) id RAA01491 for doc-outgoing; Fri, 21 Jul 1995 17:28:07 -0700 Received: from outgate.leitch.com (outgate.leitch.com [198.53.146.90]) by freefall.cdrom.com (8.6.11/8.6.6) with ESMTP id RAA01485 for ; Fri, 21 Jul 1995 17:28:05 -0700 Received: from tap.zeus.leitch.com (tap.zeus.leitch.com [204.187.60.10]) by outgate.leitch.com (8.6.11/8.6.9) with ESMTP id UAA13943 for ; Fri, 21 Jul 1995 20:29:21 -0400 Received: from ale.zeus.leitch.com (ale.zeus.leitch.com [204.187.60.65]) by tap.zeus.leitch.com (8.6.11/8.6.6) with ESMTP id UAA29104 for ; Fri, 21 Jul 1995 20:29:21 -0400 From: Dave Chapeskie Received: (dchapes@localhost) by ale.zeus.leitch.com (8.6.11/8.6.9) id UAA01877 for doc@freebsd.org; Fri, 21 Jul 1995 20:29:38 -0400 Message-Id: <199507220029.UAA01877@ale.zeus.leitch.com> Subject: Error in kerberos section of the handbook To: doc@freebsd.org Date: Fri, 21 Jul 1995 20:29:38 -0400 (EDT) X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 1532 Sender: doc-owner@freebsd.org Precedence: bulk First off, wonderful job on the handbook guys! I noticed the following mistakes (I think) in the Kerberos section of the on-line handbook. 6.3.2 Making it all run That document says I need an rcmd and a kpasswd instance for each machine. I only have rcmd instances on each machine and only my KDC has a kpasswd instance. I have no problems changing my kerberos password from any of the machines in my network. I'm almost certain the kpasswd instance is only relevent on the KDC. 6.3.5 Testing it all out "Try listing the tokens using klist" should probably read "Try listing the tickets using klist" Misc: On my 2.0.5R box I found that the kpasswd entry in /etc/inetd.conf was commented out by default and must be uncommented (on the KDC only). This should be documented somewhere with the setup notes. I noticed there was nothing in S/Key or the DES, MD5, and Crypt sections. Is anyone working on these? If not I might have a go at it (at least the S/Key one). I assume that for S/Key an example of how to setup an s/key, how to use it for various things, and how to configure a system to require one when loggin in would be sufficient. I've never used sgml before, although I have used other markup languages. The sgmlfmt(1) man page refers to "linuxdoc DTD". Where can I find documentation on this? Is there any sort of guideline type documents for writing sections of the handbook? Thanks -- Dave Chapeskie Leitch Technology International Inc. Email: dchapes@zeus.leitch.com