src/lib/libc/gen/devname.3, branch releng/12.4

Renumber copyright clause 4

2017-02-28T23:42:47Z

Renumber cluase 4 to 3, per what everybody else did when BSD granted them permission to remove clause 3. My insistance on keeping the same numbering for legal reasons is too pedantic, so give up on that point. Submitted by: Jan Schaumann Pull Request: https://github.com/freebsd/freebsd/pull/96

Add two new routines: fdevname() and fdevname_r().

2009-02-11T20:24:59Z

A more elegant way of obtaining a name of a character device by its file descriptor on FreeBSD, is to use the FIODGNAME ioctl. Because a valid file descriptor implies a file descriptor is visible in /dev, it will always resolve a valid device name. I'm adding a more friendly wrapper for this ioctl, called fdevname(). It is a lot easier to use than devname() and also has better error handling. When a device name cannot be resolved, it will just return NULL instead of a generated device name that makes no sense. Discussed with: kib

Per Regents of the University of Calfornia letter, remove advertising

2007-01-09T00:28:16Z

clause. # If I've done so improperly on a file, please let me know.

Add an EXAMPLES section[1], quote Nd, and bump doc date.

2005-02-23T02:02:38Z

PR: 53621 [1] Submitted by: Faried Nawaz [1]

mdoc(7): Fix common mistakes made in the SEE ALSO section.

2003-09-12T21:54:11Z

Add devname_r(3) which takes a buffer as argument.

2003-06-20T09:52:27Z

english(4) police.

2002-12-27T12:15:40Z

mdoc(7) police: "The .Fn function".

2002-12-18T10:13:54Z

mdoc(7) police: bump document date to the date of the last interface

2002-03-18T02:36:43Z

change (revision 1.2 of devname.c on 1999/07/18), don't put quotes around a path, and use .Dv where appropriate.

Update to reflect reality; devname(3) hasn't returned NULL on failure

2002-03-18T02:32:53Z

since revision 1.2 of devname.c (1999/07/18). While I'm here, note, in the BUGS section, that the returned pointer is to a static buffer.