Commit Graph

299 Commits

Author SHA1 Message Date
Chris Costello
e4407b54e8 Minor doc nit: Replace contractions with their expanded forms.
Obtained from:	NAI Labs CBOSS Project
Sponsored by:	DARPA, NAI Labs
2002-01-06 20:28:27 +00:00
Chris Costello
7f0def37ec As discussed with Bruce Evans and Kirk McKusick:
o Combine ufs.7 and ffs.7 into a single ffs.7 man page.
o Remove all references to `ufs' as a file system.
o Proper (lack of) capitalization for `ffs'.

Obtained from:	TrustedBSD Project
Sposnored by:	DARPA, NAI Labs
2002-01-05 20:18:35 +00:00
Chris Costello
ad25c55e52 Make WHERE TO START' and WHERE TO STOP' subsections within `DESCRIPTION'.
Suggested by:	sheldonh
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2002-01-01 19:20:02 +00:00
Chris Costello
3092f2e699 o Logically split up sentences, removing hard sentence breaks.
o Use .Sx where a section cross-reference is intended.

Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 20:34:53 +00:00
Chris Costello
07bf51c9b5 Be sure to point out that, by "mount point", one in /etc/fstab
is meant.

Submitted by:	John Hanley <jh_@yahoo.com>
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 03:47:06 +00:00
Chris Costello
bd49a87618 Document how to enable ACLs using extattrctl.
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 03:44:40 +00:00
Chris Costello
1c393056e6 Move UFS and FFS docs to section 7.
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-28 17:10:13 +00:00
Chris Costello
1fc841e3ab Add in the new security documentation guidelines document.
Obtained from:	NAI Labs CBOSS Project
Sponsored by:	DARPA, NAI Labs
2001-12-22 22:07:02 +00:00
Robert Watson
7270230e88 o s/softupdates/it/ to reduce over-use of 'softupdates' in a single
paragraph.
2001-12-22 21:02:33 +00:00
Robert Watson
b2e2e310fd o Softupdates is now enabled by default on non-root file systems. Update
language about softupdates to reference this fact, as well as slightly
  moderate the "recommend Softupdates for use on all filesystems" to
  "most filesystems" so as to be consistent with what sysinstall selects.
2001-12-22 21:01:07 +00:00
Robert Watson
60114b8024 o Most users will use sysinstall(8) for partition layout, rather than
disklabel(8), so add a reference to sysinstall(8).
2001-12-22 20:54:45 +00:00
Robert Watson
bcb3e22d61 o Expand on the definition of a sysctl, and add cross-references to
rc.conf and sysctl.conf.

MFC after:	3 days
2001-12-22 14:25:31 +00:00
Robert Watson
07f4b9740e o Refer to hw.ata.wc as a 'loader tunable' rather than a 'kernel variable'
for consistency with the rest of the document.  Since we've already
  described the properties of loader tunables elsewhere, remove the
  duplicate description of it being a boot-time property.

MFC after:	3 days
2001-12-22 14:21:20 +00:00
Robert Watson
d888f91feb o Update tuning(7) to reflect auto-tuning of kern.maxusers in recent
versions of FreeBSD.  This should be merged before 4.5-RELEASE, as this
  functionality is present in 4.5-RELEASE.

MFC after:	3 days
2001-12-22 14:19:20 +00:00
Ruslan Ermilov
f74d799555 mdoc(7) police: kill the undead whitespace at EOL. 2001-12-14 09:09:21 +00:00
Robert Watson
3b4fff26f3 o Various language and style tweaks.
Submitted by:	ru
2001-12-12 15:58:04 +00:00
Ruslan Ermilov
108c9afc50 mdoc(7) police: remove the debugging stuff I use to prevent
hyphenation (so that the output could be spell-checked).
2001-12-12 15:15:46 +00:00
Sheldon Hearn
3626f83327 Update the default newfs block and fragment sizes from 8192/1024 to
16384/2048.

Following recent discussions on the -arch mailing list, involving dillon
and mckusick, this change parallels the one made over a decade ago when
the default was bumped up from 4096/512.

This should provide significant performance improvements for most
folks, less significant performance losses for a few folks and
wasted space lost to large fragments for many folks.

For discussion, please see the following thread in the -arch archive:

Subject: Using a larger block size on large filesystems

The discussion ceases to be relevant when the issue of partitioning
schemes is raised.
2001-12-11 16:21:40 +00:00
Sheldon Hearn
2bd2a050ac Remove the advice relating to the number of cylinders per cylinder
group.  The highest possible value is calculated automatically since
rev 1.41 of src/sbin/newfs.c .
2001-12-10 09:26:30 +00:00
Robert Watson
eb22d616a0 When rfc1323 is mentioned in the context of buffer sizes, not that it
is enabled by default in FreeBSD.
2001-12-07 18:17:37 +00:00
Robert Watson
a695793d88 o Add a mention of kern.openfiles to the description of kern.maxfiles,
and suggest using this value to get a sense of the needs of the system.
2001-12-07 18:02:16 +00:00
Robert Watson
0fbfd3c17d o Fix spelling of allocations as allocates.
Submitted by:	silby
2001-12-06 20:27:44 +00:00
Robert Watson
98181c4975 o Reflect changed default such that keepalives are always enabled by
default now.  Discuss why that's good.  Note that there are still
  some situations where turning it off may be advantageous, including
  situations where there are network outages and it's desirable to
  have TCP sessions last beyond the outage.

Reviewed by:	fenner
Suggested by:	silby
2001-12-06 20:24:38 +00:00
Robert Watson
9aa92d5586 Moderate the recommendation that TCP keepalives always be turned on;
in some environments, this may result in the early termination of
legitimate TCP sessions during temporary network outages.  However,
maintain a strong recommendation that this be used when many network
clients are dialup.

Requested by:	fenner
2001-12-06 19:57:34 +00:00
Robert Watson
25eecbb5a4 o Add an additional .Pp between the send/recvbuffer comments and
the ones on ipfw.  Note to self: why does ipfw/dummynet count as
  a sysctl in tuning(7)?
2001-12-06 19:50:35 +00:00
Robert Watson
fe3e42064f o When describing kern.ipc.nsfbufs, use the slightly less colloquial
"modify" rather than the slightly more colloquial "mess with".
2001-12-06 19:48:48 +00:00
Robert Watson
657c740ed6 The default values for net.inet.tcp.sendspace and net.inet.tcp.recvspace
have been changed to 32k and 64k respectively.
2001-12-06 19:44:31 +00:00
Robert Watson
48c1691ebf vmiodirenable is now on by default; reflect that change in default,
and talk more about the reasons to turn it off (restricted memory
environments), and less about why to turn it on.
2001-12-06 19:39:33 +00:00
Robert Watson
32a124764d Reword parts of tuning(7) regarding loader tunables, which are refered
to in the document as "boot-time sysctls".  Instead, refer to them as
loader tunables.
2001-12-06 19:36:21 +00:00
Dima Dorfman
b94231daca Spelling police: "more then" - "more than" where appropriate. 2001-11-24 19:47:12 +00:00
Ruslan Ermilov
47bb57ceb4 mdoc(7) police: markup nits. 2001-11-21 13:33:30 +00:00
Ruslan Ermilov
4fab9eb9d6 mdoc(7) police: fix markup + generic cleanup. 2001-11-21 13:28:50 +00:00
Crist J. Clark
00b8804712 Document the /var/run/named directory.
Suggesteded by:		brian
2001-11-01 23:55:46 +00:00
Crist J. Clark
7558c91f77 Add a directory in /var/run to store ppp(8) command sockets.
PR:		bin/29966
Approved by:	brian
MFC after:	4
2001-11-01 23:44:12 +00:00
Assar Westerlund
9a5849d115 add /var/heimdal
absence noted by Archie Cobbs <archie@packetdesign.com>
2001-10-31 23:04:34 +00:00
Mike Silbersack
2fa7b7ca77 Update tuning so that it mentions maxusers, nmbclusters, and nsfbufs as
tunables in loader.conf rather than just kernel options.

MFC after: 3 days
2001-10-29 22:29:01 +00:00
Murray Stokely
c8123d63a2 Improve the wording of my last commit.
Submitted by:	sheldonh
2001-10-16 18:32:33 +00:00
Murray Stokely
325c1f2d13 Note that the contents of /tmp may or may not be kept between system
reboots.

Also add a `NOTES' section that reminds the reader that this man page
just documents the system default, and that the hierarchy of a given
site is at the system administrators discretion.

PR:		docs/29525
2001-10-13 21:48:57 +00:00
Ruslan Ermilov
32eef9aeb1 mdoc(7) police: Use the new .In macro for #include statements. 2001-10-01 16:09:29 +00:00
Kris Kennaway
5b7ce34e01 Oops, /var/spool/uucp needs to stay for serial port locking 2001-10-01 08:52:40 +00:00
Kris Kennaway
c3aa93665e Note removal of UUCP directories 2001-10-01 08:27:22 +00:00
Murray Stokely
bc58a19f1d Note that it might not be a good idea to mount /var 'noatime'.
PR:		docs/30675
Submitted by:	Eugene M. Kim <gene@nttmcl.com>, and
                Giorgos Keramidas <charon@labs.gr>
2001-09-24 07:35:37 +00:00
Jonathan Lemon
0d5d2695c0 Update to reflect the fact that net.inet.tcp.rfc1323 is on by default. 2001-09-17 03:49:51 +00:00
Ruslan Ermilov
0c0eb9be74 mdoc(7) police: sort FILES. 2001-09-04 10:08:19 +00:00
Alexander Langer
d33a962d07 Move /etc/defaults/make.conf to /usr/share/examples/etc/make.conf as
discussed on the arch@ mailinglist (after repo-copy).

sys.mk will .error if it finds /etc/defaults/make.conf but include
it anyways (this is the same behaviour as with the make.conf.local
removal).

/usr/share/examples/etc/make.conf has BDEFLAGS commented out now,
since it's only an example file.

Adjust all textes that talk about make.conf or defaults/make.conf to
match the new situation.
2001-08-30 22:44:51 +00:00
Ruslan Ermilov
7bf248defc Mentions about /var/spool/secretmail were deleted in BSD.var.dist,v 1.2. 2001-08-22 10:21:19 +00:00
Ruslan Ermilov
64b90fce72 Even more libss removal. 2001-08-20 15:41:15 +00:00
Ruslan Ermilov
753d686d34 mdoc(7) police: s/BSD/.Bx/ where appropriate. 2001-08-14 10:01:54 +00:00
Ruslan Ermilov
d013e3f544 mdoc(7) police: s/NetBSD/.Nx/ where appropriate. 2001-08-13 17:00:36 +00:00
Ruslan Ermilov
57e4378bf6 mdoc(7) police: protect trailing full stops of abbreviations
with a trailing zero-width space: `e.g.\&'.
2001-08-10 13:45:36 +00:00
Ruslan Ermilov
c4d9468ea0 mdoc(7) police:
Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.
2001-08-07 15:48:51 +00:00
Ruslan Ermilov
1d719d1ca1 mdoc(7) police: don't use enclosure macros with plain text. 2001-07-18 15:00:46 +00:00
Nik Clayton
8b4611ee0f Note which entries are created by sysinstall(8).
Requested by:	ru
2001-07-16 16:09:21 +00:00
Daniel Harris
c8c7c06a4a Fix assorted typos. 2001-07-14 22:41:05 +00:00
Jens Schweikhardt
c1f3e4bf21 Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by:	Silence from cvs diff -b
MFC after:	7 days
2001-07-14 19:41:16 +00:00
Ben Smithurst
d6b52729a0 fix typo: vise versa -> vice versa
PR:		28926
Submitted by:	Michael Lucas <mwlucas@blackhelicopters.org>
2001-07-12 20:40:25 +00:00
Ruslan Ermilov
63b2f7728a mdoc(7) police: eliminate warnings. 2001-07-10 18:43:07 +00:00
Ruslan Ermilov
0c93b033d5 mdoc(7) police: sort SEE ALSO xrefs. 2001-07-10 17:52:29 +00:00
Ruslan Ermilov
3d45e180f4 mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00
Sheldon Hearn
d193eadbdf Fix typo: "fending of" -> "fending off" 2001-07-10 14:09:37 +00:00
Dima Dorfman
70d51341bf mdoc(7) police: remove extraneous .Pp before and/or after .Sh. 2001-07-09 09:54:33 +00:00
Matthew Dillon
037fbe4424 Fix type-o's, revamp section on the /tmp softlink, add sections for a
couple more sysctl's, add a section on mount options.
2001-07-07 17:43:20 +00:00
Ruslan Ermilov
5521ff5a4d mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2). 2001-07-06 16:46:48 +00:00
Nik Clayton
302bba85d6 /dist is a mount point used by sysinstall(8), not an extraction directory. 2001-06-30 14:56:44 +00:00
Nik Clayton
cf348169cb Document dist/, cdrom/, compat/, and /usr/compat/, fix a couple of
{typ,think}os.

Submitted by:	Rich Morin <rdm@cfcl.com>
2001-06-26 14:03:11 +00:00
Dima Dorfman
159f80bfbc Reword the sentence that I screwed up in the last commit.
Submitted by:	Erik Trulsson <ertr1013@student.uu.se>
2001-06-24 20:34:31 +00:00
Dima Dorfman
a910f192bb Remove duplicate words. 2001-06-24 01:34:38 +00:00
Dima Dorfman
5a203488e4 mdoc(7) police: sort xrefs. 2001-06-24 01:17:07 +00:00
Dima Dorfman
9baaab27a0 OpenSSH doesn't forward keys by default. 2001-06-16 00:32:19 +00:00
Joerg Wunsch
4a70e151df Document /usr/include/dev/{ic,wi}.
Reminded by:	ru
2001-06-05 18:52:55 +00:00
Matthew Dillon
1a4c56a67d Fix type-o's, update page 2001-06-05 05:59:21 +00:00
Eric Melville
35f3d11437 Add sprog.7 to the list. 2001-06-04 22:15:44 +00:00
Eric Melville
ef73da6384 Add sprog.7, the beginnings of the secure programming guide.
Reviewed by:	ru
2001-06-04 15:32:44 +00:00
Ruslan Ermilov
0b381bf1fd Remove vestiges of MFS. 2001-06-01 10:07:28 +00:00
Matthew Dillon
fc32c80215 Add two new manual pages related to general firewall and tuning issues
Reviewed by: hackers
2001-05-27 23:14:27 +00:00
Ruslan Ermilov
1f4e04b562 Document /usr/include/fs/ntfs and /usr/include/fs/nwfs. 2001-05-26 12:04:02 +00:00
Ruslan Ermilov
1166fb516b - sys/msdosfs moved to sys/fs/msdosfs
- msdos.ko renamed to msdosfs.ko
- /usr/include/msdosfs moved to /usr/include/fs/msdosfs
2001-05-25 08:14:14 +00:00
Ruslan Ermilov
4f3d8832ff Document new /usr/include/fs include subdirs. 2001-05-23 17:22:38 +00:00
John Baldwin
120bcabcbf Replace references to the KERNEL variable with KERNCONF. 2001-05-17 23:23:25 +00:00
Jens Schweikhardt
e986850f9f Fixed typos: dependant -> dependent 2001-05-01 14:10:12 +00:00
Dima Dorfman
019de50b69 Reword a few things and document the search' and index' make targets.
PR:		26690
Submitted by:	Pete Fritchman <petef@databits.net>
2001-04-22 00:28:40 +00:00
Ruslan Ermilov
eb0838029f mdoc(7) police: normalize .Nd. 2001-04-18 15:54:10 +00:00
Ruslan Ermilov
a3089261bc Use Groff versions of man(7) and mdoc(7) manpages.
mdoc.samples(7) is superseded by mdoc(7).
2001-04-17 12:48:14 +00:00
Ruslan Ermilov
8f00082cd6 Document /usr/include/fs/smbfs and /usr/include/netsmb.
Submitted by:	bp
2001-04-13 08:14:58 +00:00
Ruslan Ermilov
6405e53deb Record -lposix1e death. 2001-04-05 07:59:19 +00:00
Ruslan Ermilov
acaf79e1b9 MAN[1-9] -> MAN. 2001-03-27 13:48:25 +00:00
Ruslan Ermilov
99d2a6766d .St macro cleanup:
- spell the abbreviation of 1003.1 as ``POSIX.1''
- fixed the description of -p1003.1-90; it was sold as ISO/IEC 9945-1:1990
- removed -p1003.1b; it only existed as 1003.1b-1993 (-p1003.1b-93), and
  is part of 1003.1 since 1003.1-1996.
- replaced -p1003.1g (project) with -p1003.1g-2000 (approved draft)
- changed abbreviation of -isoC from ``ISO C'' to ``ISO C89''
- removed -iso9899 alias for -isoC
- IEC was missing from some names
- added abbreviation for -susv2 (``SUSv2'')
2001-03-12 17:19:38 +00:00
Ruslan Ermilov
c308228566 Update the BUGS section.
The first bug is fixed in tmac.doc, revision 1.21.
The second bug fixed in doc-common, revision 1.33.
2001-03-01 12:58:54 +00:00
Ruslan Ermilov
589a5e341f /^\.St/ s/-iso9945-1/-p1003.1-96/ 2001-02-26 14:48:38 +00:00
Bruce Evans
1a030b1cbc Don't set a bad example by putting the function type in ".Fo". 2001-02-06 01:42:56 +00:00
Ruslan Ermilov
d0353b836e mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:38:02 +00:00
Ben Smithurst
92fbe861c6 Actually add build.7 to the Makefile, 2 months late.
PR:		24405
Submitted by:	Mike Meyer <mwm@mired.org>
2001-01-17 11:11:02 +00:00
Chris Costello
d7a0ba44f9 o Clear up explanations of various entries (includes spelling, grammar,
punctuation, and explanations that are just plain wrong)
o Add missing entries
o Remove entries for directories that do not exist

Submitted by:	Rich Morin <rdm@cfcl.com> (for the most part)
2001-01-13 18:38:00 +00:00
Ben Smithurst
4f38ddf643 fix typo; file -> files
Submitted by:	Alexey Dokuchaev <danfe@inet.ssc.nsu.ru>
2001-01-13 17:49:34 +00:00
Maxim Sobolev
e0a5f02bc3 Add getenv(3) and setenv(3) into ``See also'' section. 2001-01-01 23:26:54 +00:00
Ruslan Ermilov
3136363f3e Prepare for mdoc(7)NG. 2000-12-29 09:18:45 +00:00
Ruslan Ermilov
d003b7796c mdoc(7) police: removed duplicate .Os calls. 2000-12-14 12:40:48 +00:00
Ruslan Ermilov
ed40311694 mdoc(7) police: removed history info from the .Os FreeBSD call. 2000-12-14 11:52:05 +00:00
Archie Cobbs
e449cfc4c7 Document /usr/include/isc.
Noticed by:	ru
2000-12-12 05:19:10 +00:00
Ruslan Ermilov
d7b336c076 mdoc(7) police: use canonical form of .Dd macro. 2000-12-11 15:47:53 +00:00