Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

TTYMSG(3)                  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 10.99                   January 15, 2013                   NetBSD 10.99