Commit graph

235 commits

Author SHA1 Message Date
Giorgos Keramidas
34bd84809b Reword a bit parts of #configtuning-initial, add a short note to
explain why `/var' or `/var/tmp' may needs a lot of disk space, and
tune the description of `/usr' to remove an instance of ``Both of
which'' that seemed to be dangling from nowhere in particular.
2008-11-13 05:03:14 +00:00
Christian Brueffer
44ce836674 Fix typo. 2008-11-01 11:13:46 +00:00
Marc Fonvieille
758c853438 s/man page/manual page/ 2008-09-17 19:27:10 +00:00
Tom Rhodes
588a5826a0 Update the /etc/hosts example in the handbook to match reality.
PR:		124949
Discussed with:	brueffer
2008-08-03 16:30:38 +00:00
Remko Lodder
52425992c2 Borrow Poul-Henning's Axe and chop out old information for 4.x, 5.x
and unsupported 6.x releases. Tom started this process a while ago
and I'll follow up on that for the latest EoL round.

The old versions can still be found in the doc archives:
http://docs.freebsd.org/doc/
2008-06-01 09:42:12 +00:00
Remko Lodder
09556065ef Remove reference to .sh extenions and adjust filepermissions from
755 to 555.

PR:		docs/124167
Submitted by:	Sahil Tandon <sahil at tandon dot net>
2008-05-31 19:10:24 +00:00
Remko Lodder
beb92e3a57 Nowadays the rc.d scripts are without .sh extension.
PR:		docs/123799
Submitted by:	Sahil Tandon <sahil at tandon dot net>
2008-05-19 18:32:41 +00:00
Giorgos Keramidas
59cdab6e08 Tweak a bit the description of `PROVIDE' rc.d keyword, to make it a bit
more clear that it is *required* for startup scripts.  An rc.d script
without a PROVIDE keyword is not run by our rc.subr (it is skipped by
the find_local_scripts_new() shell function of rc.subr).

Inspired by:	A post by Helmut Schneider, jumper99 at gmx.de,
		on news:comp.unix.bsd.freebsd.misc
Message-Id:	63aggbF26iusnU1@mid.individual.net
2008-03-06 16:29:21 +00:00
Remko Lodder
c336eb6890 rc.d is no longer a new method, it's the method. 2007-12-23 18:48:21 +00:00
Marc Fonvieille
92cacb0de0 Use right tags for some command-line activities. 2007-08-17 12:54:31 +00:00
Nate Lawson
ce50266cf6 Clean up the acpi section a bit, removing references to disable acpi with
the acpiconf utility.  If I messed up the sgml, feel free to fix.
2007-04-07 20:21:09 +00:00
Giorgos Keramidas
2f18540604 Remove a reference to the `compat.linux.osrelease' sysctl.
As Alexander Leidinger has pointed out:

"glibc behaves differently based upon the value of it. It may refuse to
do anything if it doesn't understand the value.  Changing the value of
osrelease is only advised in experimental situations (like in
http://wiki.freebsd.org/linux-kernel) and may result even in kernel
panics."

I've replaced a reference to `compat.linux.osrelease' with a safer
example, for setting `security.bsd.see_other_uids=0', which we already
use as a sample /etc/sysctl.conf entry anyway.
2006-11-29 21:22:35 +00:00
Giorgos Keramidas
b93e6b5358 Various fixes to the "config and tuning" section of the Handbook.
* Reword the paragraph before a set of tunables for Linux, as
    it wasa bit confusing.

  * Correct the name of 'kern.maxfiles' (it was 'kern.maxfile')
    before, and reword the text around it to remove the need for
    a possessive "'s", which would look funny after 'maxfiles'.

  * Finish properly a sentence which was missing a fullstop.

Submitted by:	ganbold &at; micom &dot; mng &dot; net
2006-11-22 16:17:01 +00:00
Yaroslav Tykhiy
d5b45016fd Stop suggesting the use of the dangerous prefix "force"
with rc.d scripts.  The prefix "one" is the safe way to
override rc.conf once.  OTOH "force" will disable sanity
checks as well.
2006-10-26 15:29:09 +00:00
Yaroslav Tykhiy
7c6f9fab80 Link to the rc-scripting article from the appropriate section.
Suggested by:	dougb
2006-10-26 15:24:35 +00:00
Marc Fonvieille
0793255df0 In the Network Interface Cards page:
- Mention /boot/loader.conf when we talk about modules;

- The NDIS driver part does not belong to wireless devices section since
  it can be used for other Ethernet device, so move that part to its own
  section in the network device configuration page.  I also updated the
  previous text to match 5.5, 6.X and 7.X

  Based on docs/84961 (submitted by Fredrik Lindberg
  <fli+freebsd@shapeshifter.se>), docs/97229 (submitted by Gavin
  Atkinson <gavin@mod3.co.uk>) and many other requests/remarks.
2006-07-21 09:53:30 +00:00
Tom Rhodes
18577c121a Kill an extra space.
Noticed by:	simon
2006-07-16 18:42:49 +00:00
Tom Rhodes
aa9b8179ce Axe "under &os; 5.X and newer" in the rc title. 2006-07-14 03:03:34 +00:00
Giorgos Keramidas
e7ec7e7093 Document kern.maxfile' and kern.maxusers' auto-tuning.
PR:		docs/99804
Submitted by:	Kevin Kinsey <kdk@daleco.biz>
2006-07-12 11:18:26 +00:00
Tom Rhodes
3f0d1b56f0 Do what I swore would be done:
o Remove 4.X information, this includes notes and sections.

o Update documentation to reflect 5.X and 6.X.

o In some areas, try to make the new content version agnostic.

o Skip areas stating "5.[0-5] and later" as it's relevant - we
need a better way to handle these.

For several items, I checked the NOTES files, manual pages,
CVS history, etc.

Discussed on:		-doc
A few ideas from:	remko
2006-05-30 23:08:25 +00:00
Christian Brueffer
6c02bad18a Add a pointer to the "Encrypting Swap Space" section to the
"Adding Swap Space" section.
2006-03-13 16:52:10 +00:00
Doug Barton
42fbeac82a Swap out all references to rcNG in favor of rc.d. This is not
"next generation" technology anymore. :)

Update text and examples to match current realities relative
to the local_startup import, and other advances.

Attempt to future-proof the text a little by referring to
dates and releases, rather than (e.g.) "recently."

Add some more man page references.

Reviewed, and helpful suggestions provied by:	pav
2006-01-17 09:55:05 +00:00
Xin LI
e140896ec8 Escape <, >, &'s, plus some cleanups against the SGML. There should not
be any content changes involved in this commit, however, localization
teams are encouraged to catch up with this change.

Requested by:	intron at intron ac
Reviewed by:	Niclas Zeising <lothrandil at n00b apagnu se>
Glanced by:	simon
2006-01-05 20:03:39 +00:00
Alex Dupre
86c0a41554 Add missing negation.
Spotted by:	Marco Trentini <mark@remotelab.org>
2005-11-06 12:49:53 +00:00
Joel Dahl
0fe6859cda Move "maxusers n" from the kernel configuration chapter to the tuning
kernel limits chapter.

Suggested by:	blackend (some time ago)
Approved by:	brueffer (mentor)
2005-08-25 09:01:08 +00:00
Pav Lucistnik
112e1b7803 11.7 Using rc under FreeBSD 5.X:
- eliminate single use of term "rcNG"
- change chapter name to mention FreeBSD 5.X and newer, not just 5.X
- kill <indexterm> rcNG
- kill mention of 5.X at the end of the chapter, it's not just 5.X

Approved by:	keramida (mentor)
2005-08-12 08:16:43 +00:00
Giorgos Keramidas
7a5067e888 When pulling a file from /etc/rc.conf it's a good idea to use the full
path to the included file.

Suggested by:	gsmith@acrelic.com (Gordon Smith)
2005-06-30 09:23:14 +00:00
Michael Lucas
1a44e592e9 Add a label for the nmbclusters section, so I can link to it from the FAQ. 2005-05-12 20:45:22 +00:00
Jesus R. Camou
e77d110832 Add information on tuning kern.maxvnodes.
PR:		docs/80267
Submitted by:	Brad Davis <so14k@so14k.com>
Approved by:	trhodes (mentor)
2005-04-24 03:15:56 +00:00
Remko Lodder
3aa8879151 Fix read-only sysctl wording.
PR:		docs/80263
Submitted by:	Brad Davis <so14k at so14k dot com>
2005-04-22 22:08:01 +00:00
Remko Lodder
3de8cfcdf7 Clarify that we mean /etc/rc.conf entries instead of just entries in
the Virtual Hosts part. [1]

Update the programlisting that follows the previosly mentioned section
and remove leading spaces (which changes the presentation on the site). [2]

PR:			docs/78132
Submitted by:		Brad Davis <so14k at so14k dot com> [1]
  			Siebrand Mazeland <s dot mazeland at xs4all dot nl> [2]
Approved by:		simon (mentor)
2005-02-27 11:27:41 +00:00
Simon L. B. Nielsen
dc9009c533 Remove more contractions.
Submitted by:	Joel Dahl <joel@automatvapen.se>
2005-02-20 14:04:14 +00:00
Simon L. B. Nielsen
8ddd739127 Be consistent and change '[P|p]orts collection' -> 'Ports Collection'
as per the FDP Primer word list.

Submitted by:	Siebrand Mazeland <s.mazeland@xs4all.nl>
PR:		docs/76324
2005-02-13 10:24:10 +00:00
Tom Rhodes
fd8ab0f8eb Add a work around for some mouse failure issues with regards to suspend and
resume.

Suggested by:	njl
Submitted by:	njl (the loader.conf option)
2005-01-30 09:27:43 +00:00
Xin LI
0e244d775c The context is talking about *APIC* interrupt storm so I guess the index
item should be indicated as APIC not ACPI.
2005-01-28 18:31:12 +00:00
Martin Heinen
7182286ebc As stated in the text, list the old names of the inflight sysctls.
Discussed with:	keramida
2005-01-27 22:37:44 +00:00
Giorgos Keramidas
1c87db4bc5 The net.inet.tcp.inflight* sysctls are in their own, separate sysctl
node since revision 1.196 of `src/sys/netinet/tcp_subr.c'.  Update
their description in the Handbook, but keep a reference to the old
pre-5.3-RELEASE names until we stop supporting 4.X releases (a couple
of years from now).

PR:		docs/76462
Submitted by:	Joel Dahl <joel@automatvapen.se>
2005-01-20 12:36:00 +00:00
Denis Peplin
9cbbdb0c53 cleanup indexterm (s/<</</ for closing tag) 2005-01-19 12:56:50 +00:00
Giorgos Keramidas
60d6273bb9 Improve a bit the description of when and how a NIC driver has to be
added to the kernel configuration.  Also note that some drivers cannot
be used as modules (i.e. those for some ISA devices).

Useful comments by:	blackend, den
2005-01-14 12:51:52 +00:00
Denis Peplin
aecb3f50a6 Do not say that ed loadable module is not available - it is available for
both 4.X and 5.X
2005-01-14 08:31:30 +00:00
Denis Peplin
4db513bee3 Replace fix for LINT, use both conf/NOTES and <arch>/conf/NOTES (1)
s/interfaces/interface/ (2)

Submitted by:	Joel Dahl <joel@automatvapen.se> (1)
		ceri (2)
PR:		docs/75639
		(modified, s/i386/<replaceable>arch</replaceable>/)
2005-01-14 08:00:45 +00:00
Denis Peplin
83604e3476 Use /usr/src/sys/conf/NOTES by default,
/usr/src/sys/<replaceable>arch</replaceable>/conf/LINT for 4.X
2005-01-13 15:07:32 +00:00
Denis Peplin
03518b7210 Move utility_enable example to appropriate section 2005-01-12 13:04:22 +00:00
Martin Heinen
d824a9db88 Add index entries for ACPI and APM. 2005-01-12 00:24:21 +00:00
Martin Heinen
36c11b8489 Improve the index:
- lowercase/upercase entries
- remove the entry "basics"
- cross reference readers with <see> to variants
- remove an entry from a footnote
- unify entries of kernel options
2005-01-11 12:34:29 +00:00
Ceri Davies
eb2cd84505 Internet Explorer fails to render some tables generated by the
informaltable element properly, unless the pgwide attribute is
explicitly set to 1.  Use this consistently within the (en) tree, and
update the FDP accordingly.  This should finally silence the demons in:

PR:		docs/73095
Submitted by:	Hilko Meyer <Hilko dot Meyer at gmx dot de>
2004-11-29 21:43:38 +00:00
Marc Fonvieille
5055021668 s/role="directory"/class="directory"/ since the last instance is the
correct one.  I'm guilty of most of these wrong attributes.
2004-11-19 19:57:22 +00:00
Marc Fonvieille
9e316c8ae9 - Use of application tags for a daemon
- Use of filename tags instead of command ones for a file
2004-10-27 12:22:14 +00:00
Marc Fonvieille
8d0fb1ab8f Add a missing word. 2004-10-26 16:42:24 +00:00
Marc Fonvieille
48200bef5b - Add missing username tags
- Remove a contraction
2004-10-24 17:53:20 +00:00