src/share/man/man9/devfs_set_cdevpriv.9, branch main

man filesystems: fix xrefs after move to section 4

2024-05-16T16:25:29+00:00

Reviewed by: des, imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/1077

cdevpriv(9): document devfs_foreach_cdevpriv()

2024-03-23T06:59:00+00:00

Sponsored by:	The FreeBSD Foundation
MFC after:	1 week

Remove $FreeBSD$: two-line nroff pattern

2023-08-16T17:55:10+00:00

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/

The cdevpriv_dtr_t typedef was not able to be used in a function prototype

2015-12-02T18:27:30+00:00

like the various d_*_t typedefs since it declared a function pointer rather
than a function.  Add a new d_priv_dtor_t typedef that declares the function
and can be used as a function prototype.  The previous typedef wasn't
useful outside of the cdevpriv implementation, so retire it.

The name d_priv_dtor_t was chosen to be more consistent with cdev methods
since it is commonly used in place of d_close_t even though it is not a
direct pointer in struct cdevsw.

Reviewed by:	kib, imp
MFC after:	1 month
Differential Revision:	https://reviews.freebsd.org/D4340

Remove reference to non-existent kern_openat(9).

2015-08-20T22:14:43+00:00

MFC after:	3 days
Sponsored by:	EMC / Isilon Storage Division

Fix various mdoc issues and some EOL whitespace.

2014-12-21T10:57:42+00:00

Found with:	mandoc -Tlint

Streamline use of cdevpriv and correct some corner cases.

2012-08-15T16:19:39+00:00

1) It is not useful to call "devfs_clear_cdevpriv()" from
"d_close" callbacks, hence for example read, write, ioctl and
so on might be sleeping at the time of "d_close" being called
and then then freed private data can still be accessed.
Examples: dtrace, linux_compat, ksyms (all fixed by this patch)

2) In sys/dev/drm* there are some cases in which memory will
be freed twice, if open fails, first by code in the open
routine, secondly by the cdevpriv destructor. Move registration
of the cdevpriv to the end of the drm open routines.

3) devfs_clear_cdevpriv() is not called if the "d_open" callback
registered cdevpriv data and the "d_open" callback function
returned an error. Fix this.

Discussed with:	phk
MFC after:	2 weeks

[mdoc] Fixed .Dt call.

2011-05-25T14:13:53+00:00

mdoc: order prologue macros consistently by Dd/Dt/Os

2010-04-14T19:08:06+00:00

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by:	ru
Approved by:	philip, ed (mentors)

Add several necessary .El's.

2010-02-27T01:17:44+00:00

MFC after:	2 weeks