History log of /openbsd-current/share/man/man9/file.9
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.22 03-Jan-2020 visa

Fix a file descriptor close race in kqueue_register()

After inserting a knote, check that the associated file descriptor
still references the same file. Remove the knote if the descriptor
has changed because otherwise the kqueue becomes inconsistent with
the file descriptor table.

There is an analogous race in fcntl(F_SETLK). It is already handled,
but the code can be simplified by using the same check as in
kqueue_register().

Fix inspired by DragonFly BSD

OK mpi@, anton@


# 1.21 31-Dec-2019 visa

Document fd_getfile_mode(9).

OK mpi@


Revision tags: OPENBSD_6_6_BASE
# 1.20 15-Jul-2019 visa

Document locking with fdrelease().


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.19 17-May-2018 visa

Update the manual to match with the current semantics of fd_getfile().
Also, adjust the notes about FREF() and FRELE() as proper reference
counting is becoming mandatory.

OK jmc@, mpi@


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.18 11-Feb-2017 jmc

tweak previous;


# 1.17 11-Feb-2017 guenther

Add a flags argument to falloc() that lets it optionally set the
close-on-exec flag on the newly allocated fd. Make falloc()'s
return arguments non-optional: assert that they're not NULL.

ok mpi@ millert@


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.16 23-Nov-2015 jmc

add missing NAME entries;
feedback/ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.15 07-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getvnode(9).

Input and ok millert@


# 1.14 06-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getsock(9).

Diff from Vitaliy Makkoveev.

Manpage tweak and ok millert@


# 1.13 30-Apr-2015 millert

FRELE returns an int not void. It is actually the return value
of fdrop() (or 0 if the ref count is non-zero). From Kanonenvogel


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.12 04-Jun-2013 schwarze

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.


Revision tags: OPENBSD_5_3_BASE
# 1.11 04-Oct-2012 guenther

FRELE() has a second argument now


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


# 1.9 03-Apr-2007 jasper

put "CODE REFERENCES" before "SEE ALSO" for consistency

ok jmc@


Revision tags: OPENBSD_4_1_BASE
# 1.8 08-Nov-2006 jmc

getvnode requires vnode.h; from bret lambert
ok pedro


Revision tags: OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.7 05-Feb-2004 jmc

make .Nm match .Dt to avoid screwy apropos(1) output;
found by pb@


# 1.6 24-Jan-2004 jmc

typo from Jared Yanovich;


Revision tags: OPENBSD_3_4_BASE
# 1.5 15-Apr-2003 jmc

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.4 23-Aug-2002 art

Document the FREF done in getvnode and soon in getsock.


# 1.3 23-Aug-2002 mpech

o) fix .Sh usage;
o) minor fix;

art@ ok


# 1.2 23-Aug-2002 mpech

o) fix .Xr usage;
o) typos;

art@ ok


# 1.1 23-Aug-2002 art

Document various file descriptor access functoins in the kernel.


# 1.21 31-Dec-2019 visa

Document fd_getfile_mode(9).

OK mpi@


Revision tags: OPENBSD_6_6_BASE
# 1.20 15-Jul-2019 visa

Document locking with fdrelease().


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.19 17-May-2018 visa

Update the manual to match with the current semantics of fd_getfile().
Also, adjust the notes about FREF() and FRELE() as proper reference
counting is becoming mandatory.

OK jmc@, mpi@


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.18 11-Feb-2017 jmc

tweak previous;


# 1.17 11-Feb-2017 guenther

Add a flags argument to falloc() that lets it optionally set the
close-on-exec flag on the newly allocated fd. Make falloc()'s
return arguments non-optional: assert that they're not NULL.

ok mpi@ millert@


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.16 23-Nov-2015 jmc

add missing NAME entries;
feedback/ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.15 07-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getvnode(9).

Input and ok millert@


# 1.14 06-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getsock(9).

Diff from Vitaliy Makkoveev.

Manpage tweak and ok millert@


# 1.13 30-Apr-2015 millert

FRELE returns an int not void. It is actually the return value
of fdrop() (or 0 if the ref count is non-zero). From Kanonenvogel


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.12 04-Jun-2013 schwarze

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.


Revision tags: OPENBSD_5_3_BASE
# 1.11 04-Oct-2012 guenther

FRELE() has a second argument now


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


# 1.9 03-Apr-2007 jasper

put "CODE REFERENCES" before "SEE ALSO" for consistency

ok jmc@


Revision tags: OPENBSD_4_1_BASE
# 1.8 08-Nov-2006 jmc

getvnode requires vnode.h; from bret lambert
ok pedro


Revision tags: OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.7 05-Feb-2004 jmc

make .Nm match .Dt to avoid screwy apropos(1) output;
found by pb@


# 1.6 24-Jan-2004 jmc

typo from Jared Yanovich;


Revision tags: OPENBSD_3_4_BASE
# 1.5 15-Apr-2003 jmc

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.4 23-Aug-2002 art

Document the FREF done in getvnode and soon in getsock.


# 1.3 23-Aug-2002 mpech

o) fix .Sh usage;
o) minor fix;

art@ ok


# 1.2 23-Aug-2002 mpech

o) fix .Xr usage;
o) typos;

art@ ok


# 1.1 23-Aug-2002 art

Document various file descriptor access functoins in the kernel.


# 1.20 15-Jul-2019 visa

Document locking with fdrelease().


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.19 17-May-2018 visa

Update the manual to match with the current semantics of fd_getfile().
Also, adjust the notes about FREF() and FRELE() as proper reference
counting is becoming mandatory.

OK jmc@, mpi@


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.18 11-Feb-2017 jmc

tweak previous;


# 1.17 11-Feb-2017 guenther

Add a flags argument to falloc() that lets it optionally set the
close-on-exec flag on the newly allocated fd. Make falloc()'s
return arguments non-optional: assert that they're not NULL.

ok mpi@ millert@


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.16 23-Nov-2015 jmc

add missing NAME entries;
feedback/ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.15 07-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getvnode(9).

Input and ok millert@


# 1.14 06-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getsock(9).

Diff from Vitaliy Makkoveev.

Manpage tweak and ok millert@


# 1.13 30-Apr-2015 millert

FRELE returns an int not void. It is actually the return value
of fdrop() (or 0 if the ref count is non-zero). From Kanonenvogel


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.12 04-Jun-2013 schwarze

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.


Revision tags: OPENBSD_5_3_BASE
# 1.11 04-Oct-2012 guenther

FRELE() has a second argument now


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


# 1.9 03-Apr-2007 jasper

put "CODE REFERENCES" before "SEE ALSO" for consistency

ok jmc@


Revision tags: OPENBSD_4_1_BASE
# 1.8 08-Nov-2006 jmc

getvnode requires vnode.h; from bret lambert
ok pedro


Revision tags: OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.7 05-Feb-2004 jmc

make .Nm match .Dt to avoid screwy apropos(1) output;
found by pb@


# 1.6 24-Jan-2004 jmc

typo from Jared Yanovich;


Revision tags: OPENBSD_3_4_BASE
# 1.5 15-Apr-2003 jmc

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.4 23-Aug-2002 art

Document the FREF done in getvnode and soon in getsock.


# 1.3 23-Aug-2002 mpech

o) fix .Sh usage;
o) minor fix;

art@ ok


# 1.2 23-Aug-2002 mpech

o) fix .Xr usage;
o) typos;

art@ ok


# 1.1 23-Aug-2002 art

Document various file descriptor access functoins in the kernel.


# 1.19 17-May-2018 visa

Update the manual to match with the current semantics of fd_getfile().
Also, adjust the notes about FREF() and FRELE() as proper reference
counting is becoming mandatory.

OK jmc@, mpi@


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.18 11-Feb-2017 jmc

tweak previous;


# 1.17 11-Feb-2017 guenther

Add a flags argument to falloc() that lets it optionally set the
close-on-exec flag on the newly allocated fd. Make falloc()'s
return arguments non-optional: assert that they're not NULL.

ok mpi@ millert@


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.16 23-Nov-2015 jmc

add missing NAME entries;
feedback/ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.15 07-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getvnode(9).

Input and ok millert@


# 1.14 06-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getsock(9).

Diff from Vitaliy Makkoveev.

Manpage tweak and ok millert@


# 1.13 30-Apr-2015 millert

FRELE returns an int not void. It is actually the return value
of fdrop() (or 0 if the ref count is non-zero). From Kanonenvogel


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.12 04-Jun-2013 schwarze

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.


Revision tags: OPENBSD_5_3_BASE
# 1.11 04-Oct-2012 guenther

FRELE() has a second argument now


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


# 1.9 03-Apr-2007 jasper

put "CODE REFERENCES" before "SEE ALSO" for consistency

ok jmc@


Revision tags: OPENBSD_4_1_BASE
# 1.8 08-Nov-2006 jmc

getvnode requires vnode.h; from bret lambert
ok pedro


Revision tags: OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.7 05-Feb-2004 jmc

make .Nm match .Dt to avoid screwy apropos(1) output;
found by pb@


# 1.6 24-Jan-2004 jmc

typo from Jared Yanovich;


Revision tags: OPENBSD_3_4_BASE
# 1.5 15-Apr-2003 jmc

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.4 23-Aug-2002 art

Document the FREF done in getvnode and soon in getsock.


# 1.3 23-Aug-2002 mpech

o) fix .Sh usage;
o) minor fix;

art@ ok


# 1.2 23-Aug-2002 mpech

o) fix .Xr usage;
o) typos;

art@ ok


# 1.1 23-Aug-2002 art

Document various file descriptor access functoins in the kernel.


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.18 11-Feb-2017 jmc

tweak previous;


# 1.17 11-Feb-2017 guenther

Add a flags argument to falloc() that lets it optionally set the
close-on-exec flag on the newly allocated fd. Make falloc()'s
return arguments non-optional: assert that they're not NULL.

ok mpi@ millert@


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.16 23-Nov-2015 jmc

add missing NAME entries;
feedback/ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.15 07-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getvnode(9).

Input and ok millert@


# 1.14 06-May-2015 mpi

Pass a thread pointer instead of its file descriptor table to getsock(9).

Diff from Vitaliy Makkoveev.

Manpage tweak and ok millert@


# 1.13 30-Apr-2015 millert

FRELE returns an int not void. It is actually the return value
of fdrop() (or 0 if the ref count is non-zero). From Kanonenvogel


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.12 04-Jun-2013 schwarze

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.


Revision tags: OPENBSD_5_3_BASE
# 1.11 04-Oct-2012 guenther

FRELE() has a second argument now


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


# 1.9 03-Apr-2007 jasper

put "CODE REFERENCES" before "SEE ALSO" for consistency

ok jmc@


Revision tags: OPENBSD_4_1_BASE
# 1.8 08-Nov-2006 jmc

getvnode requires vnode.h; from bret lambert
ok pedro


Revision tags: OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.7 05-Feb-2004 jmc

make .Nm match .Dt to avoid screwy apropos(1) output;
found by pb@


# 1.6 24-Jan-2004 jmc

typo from Jared Yanovich;


Revision tags: OPENBSD_3_4_BASE
# 1.5 15-Apr-2003 jmc

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.4 23-Aug-2002 art

Document the FREF done in getvnode and soon in getsock.


# 1.3 23-Aug-2002 mpech

o) fix .Sh usage;
o) minor fix;

art@ ok


# 1.2 23-Aug-2002 mpech

o) fix .Xr usage;
o) typos;

art@ ok


# 1.1 23-Aug-2002 art

Document various file descriptor access functoins in the kernel.