Manual

Reference

Modules

  • A • B • C • D • E
  • F • G • H • I • L
  • M • N • O • P • S
  • T • U • X

Tools

IPC::Msg

Perl 5 version 8.8 documentation
Go to top • Download PDF
Show page index • Show recent pages
Recently read

IPC::Msg

NAME

IPC::Msg - SysV Msg IPC object class

SYNOPSIS

  1.     use IPC::SysV qw(IPC_PRIVATE S_IRWXU);
  2.     use IPC::Msg;
  4.     $msg = new IPC::Msg(IPC_PRIVATE, S_IRWXU);
  6.     $msg->snd(pack("l! a*",$msgtype,$msg));
  8.     $msg->rcv($buf,256);
  10.     $ds = $msg->stat;
  12.     $msg->remove;

DESCRIPTION

A class providing an object based interface to SysV IPC message queues.

METHODS

  • new ( KEY , FLAGS )

    Creates a new message queue associated with KEY . A new queue is created if

    • KEY is equal to IPC_PRIVATE

    • KEY does not already have a message queue associated with it, and <i>FLAGS</i> & IPC_CREAT is true.

    On creation of a new message queue FLAGS is used to set the permissions.

  • id

    Returns the system message queue identifier.

  • rcv ( BUF, LEN [, TYPE [, FLAGS ]] )

    Read a message from the queue. Returns the type of the message read. See msgrcv. The BUF becomes tainted.

  • remove

    Remove and destroy the message queue from the system.

  • set ( STAT )
  • set ( NAME => VALUE [, NAME => VALUE ...] )

    set will set the following values of the stat structure associated with the message queue.

    1.     uid
    2.     gid
    3.     mode (oly the permission bits)
    4.     qbytes

    set accepts either a stat object, as returned by the stat method, or a list of name-value pairs.

  • snd ( TYPE, MSG [, FLAGS ] )

    Place a message on the queue with the data from MSG and with type TYPE . See msgsnd.

  • stat

    Returns an object of type IPC::Msg::stat which is a sub-class of Class::Struct . It provides the following fields. For a description of these fields see you system documentation.

    1.     uid
    2.     gid
    3.     cuid
    4.     cgid
    5.     mode
    6.     qnum
    7.     qbytes
    8.     lspid
    9.     lrpid
    10.     stime
    11.     rtime
    12.     ctime

SEE ALSO

IPC::SysV Class::Struct

AUTHOR

Graham Barr <gbarr@pobox.com>

COPYRIGHT

Copyright (c) 1997 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Page index