Phase out ttyslot(3).
The ttyslot() function was originally part for SUSv1, marked LEGACY in SUSv2 and removed later on. This function only makes sense when using utmp(5), because it was used to determine the offset of the record for the controlling TTY. It makes little sense to keep it here, because the new utmpx file format doesn't index based on TTY slots.
This commit is contained in:
parent
646420c8dc
commit
88b69f52ee
@ -14,6 +14,8 @@
|
||||
# The file is partitioned: OLD_FILES first, then OLD_LIBS and OLD_DIRS last.
|
||||
#
|
||||
|
||||
# 20100114: removal of ttyslot(3)
|
||||
OLD_FILES+=usr/share/man/man3/ttyslot.3.gz
|
||||
# 20100113: remove utmp.h, replace it by utmpx.h
|
||||
OLD_FILES+=usr/share/man/man3/login.3.gz
|
||||
OLD_FILES+=usr/share/man/man3/logout.3.gz
|
||||
|
@ -574,7 +574,6 @@ int swapon(const char *);
|
||||
int swapoff(const char *);
|
||||
int syscall(int, ...);
|
||||
off_t __syscall(quad_t, ...);
|
||||
int ttyslot(void);
|
||||
int undelete(const char *);
|
||||
int unwhiteout(const char *);
|
||||
void *valloc(size_t); /* obsoleted by malloc() */
|
||||
|
@ -272,7 +272,6 @@ FBSD_1.0 {
|
||||
openlog;
|
||||
closelog;
|
||||
setlogmask;
|
||||
ttyslot;
|
||||
ttyname_r;
|
||||
ttyname;
|
||||
timezone;
|
||||
|
@ -34,8 +34,7 @@
|
||||
.Sh NAME
|
||||
.Nm ttyname ,
|
||||
.Nm ttyname_r ,
|
||||
.Nm isatty ,
|
||||
.Nm ttyslot
|
||||
.Nm isatty
|
||||
.Nd get name of associated terminal (tty) from file descriptor
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
@ -47,8 +46,6 @@
|
||||
.Fn ttyname_r "int fd" "char *buf" "size_t len"
|
||||
.Ft int
|
||||
.Fn isatty "int fd"
|
||||
.Ft int
|
||||
.Fn ttyslot void
|
||||
.Sh DESCRIPTION
|
||||
These functions operate on the system file descriptors for terminal
|
||||
type devices.
|
||||
@ -89,13 +86,6 @@ The
|
||||
.Fn ttyname_r
|
||||
function
|
||||
takes a buffer and length as arguments to avoid this problem.
|
||||
.Pp
|
||||
The
|
||||
.Fn ttyslot
|
||||
function
|
||||
fetches the current process' control terminal number from the
|
||||
.Xr ttys 5
|
||||
file entry.
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
.Fn ttyname
|
||||
@ -110,12 +100,6 @@ The
|
||||
.Fn ttyname_r
|
||||
function returns 0 if successful.
|
||||
Otherwise an error number is returned.
|
||||
.Pp
|
||||
The
|
||||
.Fn ttyslot
|
||||
function
|
||||
returns the unit number of the device file if found; otherwise
|
||||
the value zero is returned.
|
||||
.Sh FILES
|
||||
.Bl -tag -width ".Pa /etc/ttys" -compact
|
||||
.It Pa /dev/\(**
|
||||
@ -142,10 +126,9 @@ is smaller than the length of the string to be returned.
|
||||
.Xr ttys 5
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn isatty ,
|
||||
.Fn ttyname ,
|
||||
.Fn isatty
|
||||
and
|
||||
.Fn ttyslot
|
||||
.Fn ttyname
|
||||
functions
|
||||
appeared in
|
||||
.At v7 .
|
||||
|
@ -40,7 +40,7 @@ __FBSDID("$FreeBSD$");
|
||||
#include <unistd.h>
|
||||
|
||||
int
|
||||
ttyslot()
|
||||
__ttyslot(void)
|
||||
{
|
||||
struct ttyent *ttyp;
|
||||
int slot;
|
||||
@ -63,3 +63,5 @@ ttyslot()
|
||||
endttyent();
|
||||
return(0);
|
||||
}
|
||||
|
||||
__sym_compat(ttyslot, __ttyslot, FBSD_1.0);
|
||||
|
@ -158,7 +158,6 @@ ttyp1 none network off group=pty
|
||||
.Sh SEE ALSO
|
||||
.Xr login 1 ,
|
||||
.Xr getttyent 3 ,
|
||||
.Xr ttyslot 3 ,
|
||||
.Xr gettytab 5 ,
|
||||
.Xr login.conf 5 ,
|
||||
.Xr termcap 5 ,
|
||||
|
Loading…
Reference in New Issue
Block a user