IPC::Msg(3pm)

📦
version 5.42.3 · 8 versions
, in alpine 3.24

💖 NAME 💖

okay so bestie, this is IPC::Msg(3pm) from the Perl Programmers Reference Guide — IPC::Msg is the SysV Msg IPC object class, and it's here to make SysV IPC message queues feel less feral. 💅

✨ SYNOPSIS ✨

use IPC::SysV qw(IPC_PRIVATE S_IRUSR S_IWUSR);
use IPC::Msg;

$msg = IPC::Msg->new(IPC_PRIVATE, S_IRUSR | S_IWUSR);

$msg->snd($msgtype, $msgdata);

$msg->rcv($buf, 256);

$ds = $msg->stat;

$msg->remove;

🦋 DESCRIPTION 🦋

It's giving object-oriented glow-up: this is a class that gives you an object based interface to SysV IPC message queues. iconic, honestly. 🌈

💅 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 FLAGS & IPC_CREAT is true.

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

⚠️ careful, bestie: do not set any flags that the Sys V IPC implementation does not allow — on some systems, setting execute bits makes the operations fail. not a slay. 💀

🪪 id

Returns the system message queue identifier.

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

Reads a message from the queue. Returns the type of the message read. See msgrcv(2). The BUF becomes tainted. iykyk. 🍑

🧹 remove

Removes and destroys the message queue from the system. bye bestie 👋

🎚️ set ( STAT ) / set ( NAME => VALUE [, NAME => VALUE ...] )

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

  • uid
  • gid
  • mode (only the permission bits)
  • qbytes

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

📤 snd ( TYPE, MSG [, FLAGS ] )

Places a message on the queue with the data from MSG and with type TYPE. See msgsnd(2). send it, periodt 💌

📊 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 your system documentation:

  • uid
  • gid
  • cuid
  • cgid
  • mode
  • qnum
  • qbytes
  • lspid
  • lrpid
  • stime
  • rtime
  • ctime

🌈 SEE ALSO 🌈

  • IPC::SysV
  • Class::Struct

🎀 AUTHORS 🎀

  • Graham Barr <gbarr@pobox.com>
  • Marcus Holland-Moritz <mhx@cpan.org>

Version 2.x, Copyright (C) 2007-2013, Marcus Holland-Moritz.

Version 1.x, Copyright (c) 1997, Graham Barr.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. fr fr 🫶

okay that's the whole page, bestie — source/version is perl v5.42.3, dated 2026-11-03. now go make those message queues behave. 💖✨🎀

📦 where this page comes from