man3rmt/rmtUserMsgCmd

Table of Contents

Name

rmtUserMsgCmd - remote - post a user message as a response to a command

Description

rmtUserMsgCmd posts a user message to dbman.

This is used by a client which needs to post a message as the result of a user action. For example, McSNICSmngr(8) uses this to post automatic rehome in progress messages.

The request is passed in remote mode.

This function is part of librmt.

Syntax

int rmtUserMsgCmd(
int fo,
char *L,
char *D,
int RecId,
char *Msg,
int chan,
int verbosity
);

Arguments

fo

The file descriptor for the connection to dbman.

L

label string

D

refname string

RecId

DATA.RecId (of the parameter designated by label and refname)

Msg

the message

chan

the file descriptor number in dbman where the command originated. This is obtained from the incoming transaction which is causing this message to be posted.

verbosity

Defines the amount of messages to print. This value is passed on to SendRec. A value of 0 produces no messages. See the SendRec manpage for full details on available values.

Return Values

ERRok is returned if the transaction is successful.
The error code from the transaction is returned if there is a communications error.

Notes

The RecId argument isn’t really used for anything.

See Also

librmt(3rmt)

Manual page revision

$Id: rmtUserMsgCmd.3,v 1.2 2008/08/22 16:23:09 mcnamer Exp $

Table of Contents