192 Commits

Author SHA1 Message Date
dillon
386338d04f Bring more VOP manual pages up to date in regards to locking
requirements.
1999-09-24 10:19:43 +00:00
dillon
609f54c951 Update errors in documentation for various VOP_ calls. Specifically,
describe the correct locking state expected on entry and return.
1999-09-24 07:07:02 +00:00
phantom
a2ad4c3e54 Add to .Nm devstat_end_transaction_buf().
Do some ordering.

Noticed by: ken
1999-09-23 13:31:15 +00:00
phk
760dea228a Document the new free/erase transaction type.
Reminded about by:	ken
1999-09-22 20:27:21 +00:00
phantom
f763adb99e Synchronization NAME section with SYNOPSIS. 1999-09-21 19:18:09 +00:00
phk
45d2461210 document devstat_end_transaction_buf() 1999-09-18 21:31:19 +00:00
ru
4e8bd14844 Adjust descriptions for if_up() and if_down().
Reviewed by:	wollman
1999-09-14 01:05:40 +00:00
dfr
79eb0d6064 Add new manpage device_set_flags.9 and add links for
device_set_desc_copy.9 and device_get_flags.9.
1999-09-12 16:01:11 +00:00
alfred
5358b0a7ff vnode -> mountpoint
reference vfs_check_export
change license to my own, (ok'd by dfr) and remove advert clause.
remove extra Id tags and emacs cruft, this should be a fresh file.
1999-09-11 21:00:03 +00:00
chris
e5e68f25b0 Add a link for uiomove.9 to uio.9 1999-09-11 15:39:31 +00:00
alfred
b5a29f8080 Document VFS changes:
VFS_CHECKEXP.9, now used to check export credentials
VFS_FHTOVP.9, only used for filehandle to vnode, no access checks are done.
VFS.9, inform people of the vfs_std* functions available to avoid
       ugly casts to eopnotsup and making of dummy functions to return 0.
1999-09-11 00:57:20 +00:00
dfr
12118cc465 Add device_set_desc_copy(9). 1999-09-06 15:13:09 +00:00
phantom
890a9302c4 Replace stale references to device_add_child_after(9) with
device_child_add_ordered(9)

PR:		13210
Submitted by:	Alexey Zelkin <phantom@cris.net>
Reviewed by:	mpp
Forgotten by:	dfr
1999-09-04 12:37:21 +00:00
peter
76f0c923fe $Id$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00
chris
cbf4240acf Bad ref time(2) changed to time(3) 1999-08-16 22:11:19 +00:00
mpp
3760a527a6 Remove a self-referencing xref in the SEE ALSO section. 1999-08-15 13:47:08 +00:00
mpp
1f5a4f9ad4 Various man page cleanup:
- Sort xrefs
- FreeBSD.ORG -> FreeBSD.org
- Be consistent with section names as outlined in mdoc(7).
- Other misc mdoc cleanup.

PR:		doc/13144
Submitted by:	Alexey M. Zelkin <phantom@cris.net>
1999-08-15 10:48:36 +00:00
hoek
7f4aba7cc3 English fixes: consistent spacing after periods, "userland", not "user land",
other typos, ~four grammar gnits, an ironic case of incorrect
               parallelization, bad capitalization, an incorrect use of the
               infamous slash ('/'), and an unclear sentence.
1999-08-02 04:00:33 +00:00
hoek
e8fde6f570 Bruce noted that the use of err(), fixed to errx() in the last commit,
did not specify an exit code.  This implies the use of either a hand-
rolled err() (Bruce's suggestion) or a random error code (my suggestion),
both of which are against the style guidelines.  This commit specifies
the correct error code (implicitly).  This also changes the error message
to be a little more helpful.
1999-08-02 03:18:17 +00:00
hoek
581ea05e68 Use errx() instead of err() in example code calling err() after strtol(). 1999-07-31 15:04:37 +00:00
mdodd
1b3328c300 Alter the behavior of sys/kern/subr_bus.c:device_print_child()
- device_print_child() either lets the BUS_PRINT_CHILD
	  method produce the entire device announcement message or
	  it prints "foo0: not found\n"

Alter sys/kern/subr_bus.c:bus_generic_print_child() to take on
the previous behavior of device_print_child() (printing the
"foo0: <FooDevice 1.1>" bit of the announce message.)

Provide bus_print_child_header() and bus_print_child_footer()
to actually print the output for bus_generic_print_child().
These functions should be used whenever possible (unless you can
just use bus_generic_print_child())

The BUS_PRINT_CHILD method now returns int instead of void.

Modify everything else that defines or uses a BUS_PRINT_CHILD
method to comply with the above changes.

	- Devices are 'on' a bus, not 'at' it.
	- If a custom BUS_PRINT_CHILD method does the same thing
	  as bus_generic_print_child(), use bus_generic_print_child()
	- Use device_get_nameunit() instead of both
	  device_get_name() and device_get_unit()
	- All BUS_PRINT_CHILD methods return the number of
	  characters output.

Reviewed by: dfr, peter
1999-07-29 01:03:04 +00:00
nik
1c58beb04f Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

     .\"    $Id$
     .\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by:            bde
1999-07-12 21:02:10 +00:00
kris
355fb5338b Flesh out VOP_ADVLOCK.9 with a description of the available flags
Sync vnode.9 with the definitions in <sys/vnode.h>

Reviewed by:	Doug Rabson
1999-06-30 12:02:52 +00:00
mpp
9d0120cf53 Fix some typos and do some minor mdoc cleanup. 1999-06-27 02:38:46 +00:00
n_hibma
1c09d8feee Add man page for device_quiet and friends 1999-06-22 18:09:54 +00:00
hoek
9cb4fddb16 typo: Adviseroty -> Advisory 1999-06-22 02:34:47 +00:00
n_hibma
015d2f3ea8 Update the comments on values than can be returned by DEVICE_PROBE.
DEVICE_PROBE can return priorities.

Reviewed by:	Doug Rabson <dfr@nlsystems.com>
1999-06-17 19:22:12 +00:00
bde
9a9fd043b2 Fixed bitrot in synopsis (a missing include). 1999-06-02 16:33:22 +00:00
nik
02c236ef75 Description of LOCKLEAF said "inode" when it should have said "vnode".
PR:             docs/11596
Submitted by:   Robert Watson <robert@fledge.watson.org>
1999-05-29 13:00:40 +00:00
dfr
1110334ad2 Document device_add_child_ordered(). 1999-05-28 09:38:25 +00:00
mharo
c7520d9e74 s/file it possible/file if possible/ 1999-05-11 01:19:34 +00:00
phk
ca21a25f17 This Implements the mumbled about "Jail" feature.
This is a seriously beefed up chroot kind of thing.  The process
is jailed along the same lines as a chroot does it, but with
additional tough restrictions imposed on what the superuser can do.

For all I know, it is safe to hand over the root bit inside a
prison to the customer living in that prison, this is what
it was developed for in fact:  "real virtual servers".

Each prison has an ip number associated with it, which all IP
communications will be coerced to use and each prison has its own
hostname.

Needless to say, you need more RAM this way, but the advantage is
that each customer can run their own particular version of apache
and not stomp on the toes of their neighbors.

It generally does what one would expect, but setting up a jail
still takes a little knowledge.

A few notes:

   I have no scripts for setting up a jail, don't ask me for them.

   The IP number should be an alias on one of the interfaces.

   mount a /proc in each jail, it will make ps more useable.

   /proc/<pid>/status tells the hostname of the prison for
   jailed processes.

   Quotas are only sensible if you have a mountpoint per prison.

   There are no privisions for stopping resource-hogging.

   Some "#ifdef INET" and similar may be missing (send patches!)

If somebody wants to take it from here and develop it into
more of a "virtual machine" they should be most welcome!

Tools, comments, patches & documentation most welcome.

Have fun...

Sponsored by:   http://www.rndassociates.com/
Run for almost a year by:       http://www.servetheweb.com/
1999-04-28 11:38:52 +00:00
bde
08ae42f665 Fixed bitrot in synopsis. 1999-03-26 02:11:59 +00:00
ghelmer
10d69fb387 Document the flags and p parameters to VOP_LOCK and VOP_UNLOCK. Also,
at Doug Rabson's suggestion, add vn_lock(9) as an alternative name for
this manpage and note its calling convention.

PR:		docs/9338
1999-03-17 20:17:32 +00:00
bde
d6209f70c6 Removed old scsi section 9 man pages. Only cd.9 has been converted to
cam.  scsiconf.9, sd.9, and st.9 can now be found in the Attic.

Reviewed by:	ken
1999-03-06 19:03:31 +00:00
bde
8987c1baf2 Fixed bitrot in synopsis (devfs_link was renamed to devfs_makelink).
Didn't fix bitrot in this page's name; just install a link.
1999-03-06 17:37:20 +00:00
bde
01f64b5c61 Fixed wrong function prototype(s) in synopsis. 1999-03-06 17:25:50 +00:00
bde
15d674b3ae Fixed bitrot in synopsis (u_long changed to uintptr_t for portability). 1999-03-06 17:21:14 +00:00
bde
1b7889bbfd Fixed C syntax error in synopsis. 1999-03-06 17:14:24 +00:00
bde
a89e4f49cd Fixed bitrot in synopsis (const poisoning hadn't reached here). 1999-03-06 17:10:15 +00:00
bde
1d5b4f0e39 Fixed missing headers in synopsis. 1999-03-06 17:07:29 +00:00
bde
7aca67cebc Fixed bitrot in synopsis (fuword() and suword() changed to support alpha). 1999-03-06 17:04:18 +00:00
dillon
d443f239de Clarify more of what VOP_LINK expects. 1999-02-13 07:56:49 +00:00
dillon
f4351f3b6f Update man page - directory vnode should not be unlocked or released
by the VOP routine.  The caller does it.
1999-02-13 07:44:14 +00:00
alex
95c394b70e Removed occurrences of consecutive repeated words (such as "the the"). 1999-02-12 02:12:08 +00:00
ken
542b263658 Add a prioritization field to the devstat_add_entry() call so that
peripheral drivers can determine where in the devstat(9) list they are
inserted.

This requires recompilation of libdevstat, systat, vmstat, rpc.rstatd, and
any ports that depend on the devstat code, since the size of the devstat
structure has changed.  The devstat version number has been incremented as
well to reflect the change.

This sorts devices in the devstat list in "more interesting" to "less
interesting" order.  So, for instance, da devices are now more important
than floppy drives, and so will appear before floppy drives in the default
output from systat, iostat, vmstat, etc.

The order of devices is, for now, kept in a central table in devicestat.h.
If individual drivers were able to make a meaningful decision on what
priority they should be at attach time, we could consider splitting the
priority information out into the various drivers.  For now, though, they
have no way of knowing that, so it's easier to put them in an easy to find
table.

Also, move the checkversion() call in vmstat(8) to a more logical place.

Thanks to Bruce and David O'Brien for suggestions, for reviewing this, and
for putting up with the long time it has taken me to commit it.  Bruce did
object somewhat to the central priority table (he would rather the
priorities be distributed in each driver), so his objection is duly noted
here.

Reviewed by:	bde, obrien
1999-02-10 00:04:13 +00:00
mpp
a6b9e3e3ce Fix some spelling errors. 1999-02-01 22:55:54 +00:00
nsouch
c9bc4bf009 ppbconf.9 removed 1999-01-30 15:33:20 +00:00
nsouch
211ce41456 Improve ppbus(4) microsequencer description. Remove ppbconf.9 which is
to rapidly depreciated.
1999-01-30 15:32:41 +00:00
julian
c7eb114522 Slightly relax the requirements fro removing extra braces and parenthesis.
Objected to by: bde
1999-01-30 04:17:14 +00:00