ttymsg(3) - NetBSD Manual Pages

TTYMSG(3)               NetBSD Library Functions Manual              TTYMSG(3)


NAME

     ttymsg -- ttymsg utility function


LIBRARY

     System Utilities Library (libutil, -lutil)


SYNOPSIS

     #include <util.h>

     char *
     ttymsg(struct iovec *iov, int iovlen, const char *tty, int tmout);


DESCRIPTION

     The ttymsg() function is used by programs such as talkd(8), syslogd(8),
     wall(1), etc., to display the contents of a uio structure on a terminal.
     ttymsg() forks and finishes in the child if the write would block after
     waiting up to tmout seconds.


RETURN VALUES

     ttymsg() returns a pointer to an error string on unexpected error; the
     string is not newline-terminated.  Various "normal" errors are ignored
     (exclusive-use, lack of permission, etc.).


SEE ALSO

     writev(2)


BUGS

     ttymsg could grow some flags and a username/uid who is the expected owner
     of the tty.  If the flags say so then the owner should be checked against
     the tty owner, and the message should not be sent if there is a mismatch.
     Also another flag could say check against group writable, and don't send
     a message.

NetBSD 9.1                     January 15, 2013                     NetBSD 9.1