NAME send_message - send a message to a user SYNOPSIS int send_message(string message) int send_message(int code) DESCRIPTION In the first form, send a message to the user associated with the current object. Used by the driver object, send_message() will write the message on stderr. In the second form, send_message(0) means turn input echoing off, and send_message(1) means turn input echoing on; they are only meaningful for telnet connections. Use of send_message(-1) is described below. The function will return 0 if there is room for more messages, and 1 if not. If it returns 1, the driver will call message_done() in this object when all messages have been sent; if this object calls send_message() again before message_done() has been called, the remainder of the previous message will be discarded. Calling send_message(-1) will return 0 if all messages have been sent, and 1 if not. If it returns 1, the driver will call message_done() in this object when all messages have been sent. Destructing a connection object before all messages have been sent may cause the messages to be lost. ERRORS Calling send_message() in an object that is not connected will result in an error. SEE ALSO kfun/query_ip_number, kfun/this_user, kfun/connect, kfun/open_port, kfun/users