Commit Graph

1729 Commits

Author SHA1 Message Date
ed
3b64cecd5c Several documentation fixups related to device minor/major numbers:
- Document the minor(3), major(3) and makedev(3) macro's. They also
  apply to umajor() and uminor() in the kernel, but hopefully we'll sort
  that out one day.

- Briefly dev2unit() inside the make_dev(9) manual page, since this is
  now the preferred macro to obtain character device unit numbers inside
  the kernel.

- Remove the device_ids(9) manual page. It contains highly inaccurate
  information, such as a description of the nonexistent major().
2008-09-28 20:15:45 +00:00
imp
6b3a0f9ca4 Add stronger warning that spl is historical. I almost deleted this
man page entirely, but it is still mildly useful in understanding the
few splxxx usages we still have in the tree.
2008-09-28 03:45:16 +00:00
ed
d421caabf9 Rename the minor' argument of make_dev(9) to unit'.
To prevent any further confusion about device minor and unit numbers,
we'd better just refer to device unit numbers. Many people still think
the numbers we show inside devfs have any relation to the numbers passed
to make_dev(9), which is not the case.

Discussed with:	kib
2008-09-26 14:31:24 +00:00
attilio
23ff3dbeb8 Remove the suser(9) interface from the kernel. It has been replaced from
years by the priv_check(9) interface and just very few places are left.
Note that compatibility stub with older FreeBSD version
(all above the 8 limit though) are left in order to reduce diffs against
old versions. It is responsibility of the maintainers for any module, if
they think it is the case, to axe out such cases.

This patch breaks KPI so __FreeBSD_version will be bumped into a later
commit.

This patch needs to be credited 50-50 with rwatson@ as he found time to
explain me how the priv_check() works in detail and to review patches.

Tested by:      Giovanni Trematerra <giovanni dot trematerra at gmail dot com>
Reviewed by:    rwatson
2008-09-17 15:49:44 +00:00
sam
f367e5ff45 decription of macros to add ddb commands
Submitted by:	Guillaume Ballet <gballet@gmail.com>
MFC after:	1 month
2008-09-15 23:13:29 +00:00
kib
783912cc18 Connect dev_clone.9 and devfs_set_cdevpriv.9 to the build. 2008-09-15 10:12:04 +00:00
kib
0e5845a31b Remove unneeded comma.
Noted by:	kensmith
2008-09-12 13:04:39 +00:00
kib
8fbe72145e Document dev_clone eventhandler interface 2008-09-11 11:43:47 +00:00
kib
26d6e1da5d Add a first draft of the cdevpriv(9) documentation 2008-09-11 11:41:33 +00:00
kib
d397045a7c Document make_dev_credf(9), destroy_dev_sched(9) and destroy_dev_drain(9)
functions.

Reviewed by:	brueffer
2008-09-11 11:38:48 +00:00
kib
e3f791c62f Update insmntque(9) manpage, bringing it close to reality.
Reviewed by:	brueffer
2008-09-11 11:36:21 +00:00
kib
a38c80b72e Document BUS_DMA_NOCACHE.
MFC after:	3 days
2008-09-06 15:21:01 +00:00
emaste
9badf4bdbe Add a note that CTASSERT() should not be used in header files. 2008-09-05 15:24:54 +00:00
attilio
e2ca413d09 Decontextualize vfs_busy(), vfs_unbusy() and vfs_mount_alloc() functions.
Manpages are updated accordingly.

Tested by:	Diego Sardina <siarodx at gmail dot com>
2008-08-31 14:26:08 +00:00
jkim
7982995488 Add links to all bpf(9) functions. 2008-08-28 17:04:52 +00:00
attilio
dbf35e279f Decontextualize the couplet VOP_GETATTR / VOP_SETATTR as the passed thread
was always curthread and totally unuseful.

Tested by: Giovanni Trematerra <giovanni dot trematerra at gmail dot com>
2008-08-28 15:23:18 +00:00
imp
3ad7bc21bd Document that devlistp and devcountp are only updated when there's no
error.
Bump date.
2008-08-23 07:50:20 +00:00
jhb
e306c86e1b Permit Giant to be passed as the explicit interlock either to
msleep/mtx_sleep or the various cv_*wait*() routines.  Currently, the
"unlock" behavior of PDROP and cv_wait_unlock() with Giant is not
permitted as it is will be confusing since Giant is fully unrecursed and
unlocked during a thread sleep.

This is handy for subsystems which wish to allow unlocked drivers to
continue to use Giant such as CAM, the new TTY layer, and the new USB
stack.  CAM currently uses a hack that I told Scott to use because I
really didn't want to permit this behavior, and the TTY and USB patches
both have various patches to permit this.

MFC after:	2 weeks
2008-08-07 21:00:13 +00:00
jhb
97c033161b Document the new return values for sleepq_abort(), sleepq_broadcast(), and
sleepq_signal().

Prodded by:	attilio
2008-08-07 20:47:01 +00:00
sam
dc31c98790 Try to fixup last (inadvertent) commit: firmware_drain was never added so
yank it's description; likewise for the FIRMWARE_WAIT flag to firmware_put.

For the record, the last commit was to cleanup various mistakes and correct
the example of embedding to reflect the npe firmware now being distributed
with the system.
2008-08-02 17:51:38 +00:00
sam
f28149353a add callout_schedule; besides being useful it also improves
compatibility with other systems

Reviewed by:	ed, battlez
2008-08-02 17:42:38 +00:00
pjd
9d11b5b5b3 Implement the following macros for completeness:
SYSCTL_QUAD()
	SYSCTL_ADD_QUAD()
	TUNABLE_QUAD()
	TUNABLE_QUAD_FETCH()

Now we can use 64bit tunables on 32bit systems.
2008-07-21 15:05:25 +00:00
dwmalone
ea6fbedc68 Add a man page for the DNS accept filter. 2008-07-18 14:46:01 +00:00
danger
b35e10e860 Back-out my previous change. See the thread at
http://lists.freebsd.org/pipermail/cvs-all/2008-July/263779.html
2008-07-10 11:24:41 +00:00
danger
7c6cdcc163 - nested functions are a GCC extensions and should not be used
Submitted by:	gahr
MFC after:	3 days
2008-07-09 14:04:28 +00:00
remko
78396ae0b6 Document the _arg versions of the uma_zalloc and uma_zfree functions.
PR:		docs/120357
Submitted by:	gahr
MFC after:	3 days
2008-06-19 18:33:38 +00:00
gonzo
6b323ac337 It's Friday the 13th, not the 10th and I can't travel in time. Yet. 2008-06-13 19:45:12 +00:00
gonzo
ec35617171 Add "fast" versions of macros and functions to taskqueue(9) API
description: TASKQUEUE_FAST_DEFINE(9), TASKQUEUE_FAST_DEFINE_THREAD(9),
  taskqueue_create_fast(9). They deal with taskqueues intended for use
  in fast interrupt handlers.

  Approved by:	cognet (mentor)
  Reviewed by:	keramida
2008-06-13 19:35:17 +00:00
wkoszek
407d56cbcf Mark "highaddr" and "lowaddr" appropriately. Change "dma" to "DMA".
Fix spelling mistage found by rodrigc@.

Reviewed by:	rodrigc, danger
2008-06-09 22:13:14 +00:00
attilio
65c567c106 Add the missing option LK_NOWITNESS for vn_lock / VOP_LOCK operations. 2008-06-05 17:07:33 +00:00
gonzo
4762c80628 Clean out all mentions of struct proc* for it was removed from
taskqueue(9) API more then two years ago.

  Approved by:	cognet (mentor)
2008-05-22 21:41:19 +00:00
alc
ff0e5f2bfe The function pmap_addr_hint no longer exists. Remove its man page. 2008-05-22 16:25:25 +00:00
alc
5a23437099 Generalize vm_map_find(9)'s parameter "find_space". Specifically, add
support for VMFS_ALIGNED_SPACE, which requests the allocation of an
address range best suited to superpages.  The old options TRUE and FALSE
are mapped to VMFS_ANY_SPACE and VMFS_NO_SPACE, so that there is no
immediate need to update all of vm_map_find(9)'s callers.

While I'm here, correct a misstatement about vm_map_find(9)'s return
values in the man page.
2008-05-10 18:55:35 +00:00
julian
2ddf06099d Document the kproc_kthread_add() call
and fix a small detail of its implementation.
MFC after: 1 week
2008-04-29 22:43:15 +00:00
pjd
3d7aa5ca50 Fix some section references. 2008-04-29 08:16:05 +00:00
attilio
3827ab6b7e LK_NOWITNESS can be used now in lockmgr*() functions in order to skip
witness(4) checks on a per-instance basis.
2008-04-12 20:18:02 +00:00
attilio
da8539bd62 Commit manpages for lockmgr_args_rw(9) and lockmgr_rw(9). 2008-04-06 21:22:12 +00:00
imp
30afe603df Add note about PZERO being obsolete, because so much code uses it.
Feel free to improve the verbage, since this was a compromise between
conflicting feedback I got on my original version.
2008-04-04 16:59:58 +00:00
attilio
f4b9e6a646 Add manpages for rw_try_rlock() and rw_try_wlock() functions. 2008-04-01 20:56:45 +00:00
brueffer
709a46133e Document lockmgr_waiters(9).
Reviewed by:	attilio
2008-03-28 21:30:37 +00:00
ru
e8523e8018 s/M_TRYWAIT/M_WAIT/ 2008-03-25 15:44:49 +00:00
ru
3b1bf8c2e9 Replaced the misleading uses of a historical artefact M_TRYWAIT with M_WAIT.
Removed dead code that assumed that M_TRYWAIT can return NULL; it's not true
since the advent of MBUMA.

Reviewed by:	arch

There are ongoing disputes as to whether we want to switch to directly using
UMA flags M_WAITOK/M_NOWAIT for mbuf(9) allocation.
2008-03-25 09:39:02 +00:00
brueffer
b2b09b9356 Bah, missed one instance in the previous commit. Correct bpf
data-link type here as well.

PR:		121477
2008-03-17 16:37:35 +00:00
brueffer
792430a220 Correct bpf data-link type.
PR:		121477
Submitted by:	Sam Banks
MFC after:	3 days
2008-03-17 16:33:34 +00:00
pjd
ea49d310bf Implement atomic_fetchadd_long() for all architectures and document it.
Reviewed by:	attilio, jhb, jeff, kris (as a part of the uidinfo_waitfree.patch)
2008-03-16 21:20:50 +00:00
pjd
6a68218ce1 Implement soon-to-be-used rw_unlock() macro. 2008-03-16 17:10:52 +00:00
pjd
3505d672cf Add missing .El. 2008-03-16 17:06:05 +00:00
rwatson
60dab6dffc Add stack_print_ddb() to the synposis of stack(9), add mlink for it; fix
stack_print(9) mlink.

Spotted by:	attilio
2008-03-14 13:13:37 +00:00
imp
6bb1c81980 Document all the BUS_PROBE_* values.
Note to the mdoc gods: This may need some teaks.
2008-03-09 05:31:31 +00:00
rwatson
6fa0a5ca57 Minor spelling/grammer fixes.
MFC after:	3 days
2008-03-07 17:02:34 +00:00