You are here: Administration > Man Pages > LCMI_mailboxes(1M)

LCMI_mailboxes(1M)

NAME

LCMI-mailboxes(1M) — shell interface to mailboxes

SYNOPSIS

cre_mbox -b boxname

rcv_msg -b boxname [-t timeout]

empty_mbox -b boxname

snd_msg [-s system] -b boxname [-m message]

can_talk -s system

DESCRIPTION

Mailbox routines provide an interface between shell programs and the LCM mailbox facility. A mailbox is needed to receive messages; no mailbox needs to exist to send messages.

SYNTAX

cre_mbox -b boxname

Creates a receiving mailbox named boxname. If the mailbox already exists, the command does nothing.

rcv_msg -b boxname [-t timeout]

Reads a message from mailbox boxname, waiting indefinitely until a message arrives. The message is sent to stdout. If the -t option is used, the program will wait for the timeout period specified (in seconds) and then return. Return value is 0 for success; nonzero, for failure.

empty_mbox -b boxname

Tests for messages in mailbox boxname. Returns 1, if there are messages; 0, if it is empty.

snd_msg [-s system] -b boxname [-m message]

Sends an asynchronous message (specified by -m) to mailbox boxname on system, if specified, or the current system, if unspecified.

can_talk -s system

Determines accessibility of system, <system>.

NOTES

The location of this utility, LKROOT, is defined in the default file /etc/default/LifeKeeper.

FILES

 /etc/default/LifeKeeper

© 2012 SIOS Technology Corp., the industry's leading provider of business continuity solutions, data replication for continuous data protection.