int usr_injoth

(onlinerec_t* user, char* msg, int force)

Page another user with a message.

Documentation

Page another user with a message.

`Injects' a string to another user (hence the name).

Parameters:

- user A pointer to the other user's onlinerec_t. You should obviously attach the other user's shared segment first, by calling usr_insys(). As a side effect, this will also make sure the other user is actually on-line.
msg - A null-terminated string holding the message to send to the user. No need for the message to be fully formatted, but it should in the other user's language. Having attached the other user's online record, you know what language they're using. Use the function msg_getl() to obtain prompts in the other user's language, and sprintf() to embed information in them. Any substitution variables in the string will be expanded in the other user's context. The string should be smaller than the maximum System V IPC message size, MSGMAX (4080 bytes on Linux, your mileage may vary). This is acceptable, though. You should aim to send really small messages to other users. Large ones are bound to be annoying in the superlative.
force - If non-zero, the function will not respect the OLF_BUSY flag in the user's online record, sending the message even if the user is unable to receive it. Never do this unless absolutely necessary. The system does this to notify the user of imminent disconnections, but that's usually an emergency for the user. Bear in mind that the user may not be able to receive the message immediately. Stored pages work this way.

Returns:

Zero if the message could not be injected. One if it was successfully sent. This is asynchronous: the user may actually see the message at a later time.

See Also:

{\tt usr_injoth_ack()}.

Alphabetic index