IPCRM(1POSIX)

📦 version 2017a, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

👑 IPCRM — the POSIX Programmer's Manual era 💅

okay bestie, so this page lives in the POSIX Programmer's Manual (that's the manual name, it's giving official), and heads up before we even start: the Linux implementation of this interface may differ — so if you're on Linux, go check the corresponding Linux manual page for the real tea. or honestly? the interface might not even be implemented on Linux at all. 🙈

✨ PROLOG ✨

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

no cap, read that twice. it's the fine print that saves you. 🫶

🌸 NAME 🌸

ipcrm — remove an XSI message queue, semaphore set, or shared memory segment identifier

like. it deletes your interprocess communication stuff. that's the whole job. iconic honestly.

⭐ SYNOPSIS ⭐

ipcrm [-q msgid|-Q msgkey|-s semid|-S semkey|-m shmid|-M shmkey]...

see those ... at the end? yeah, you can stack these. multiple things, one command, one slay. 🔥

💖 DESCRIPTION 💖

The ipcrm utility shall remove zero or more message queues, semaphore sets, or shared memory segments. Which interprocess communication facilities get removed? that's decided entirely by the options you pass, bestie. you point, it deletes.

Only a user with appropriate privileges shall be allowed to remove an interprocess communication facility that was not created by or owned by the user invoking ipcrm.

translation: if it's not yours and you're not privileged, hands off. 🚫 no touching other people's stuff.

🎀 OPTIONS 🎀

The ipcrm utility shall conform to the Base Definitions volume of POSIX.1‐2017, Section 12.2, Utility Syntax Guidelines. (yes, there's a whole guideline situation and it's following it. well behaved king. 👑)

The following options shall be supported:

  • -q msgid — remove the message queue identifier msgid from the system, and destroy the message queue and the data structure associated with it. gone. bye. 💀
  • -m shmid — remove the shared memory identifier shmid from the system. the shared memory segment and the data structure associated with it shall be destroyed after the last detach. so like, it's not instant-instant, it waits its turn.
  • -s semid — remove the semaphore identifier semid from the system and destroy the set of semaphores and the data structure associated with it. ✨
  • -Q msgkey — remove the message queue identifier created with key msgkey from the system, and destroy the message queue and the data structure associated with it. (yes, by key this time, not by id — very iykyk)
  • -M shmkey — remove the shared memory identifier created with key shmkey from the system. the shared memory segment and the data structure associated with it shall be destroyed after the last detach. same detach drama as -m.
  • -S semkey — remove the semaphore identifier created with key semkey from the system and destroy the set of semaphores and the data structure associated with it. 💅

so real talk: lowercase = you're giving it an id. uppercase = you're giving it a key. that's the pattern, that's the vibe check, you're welcome. 🌈

🦋 OPERANDS 🦋

None.

literally none. this one does not take operands. everything comes in through the options. periodt.

💜 STDIN 💜

Not used.

it is not reading from you. it is not listening. 😭

🌸 INPUT FILES 🌸

None.

🧚 ENVIRONMENT VARIABLES 🧚

The following environment variables shall affect the execution of ipcrm:

  • LANG — provide a default value for the internationalization variables that are unset or null. (see the Base Definitions volume of POSIX.1‐2017, Section 8.2, Internationalization Variables for the precedence of internationalization variables used to determine the values of locale categories.)
  • LC_ALL — if set to a non-empty string value, override the values of all the other internationalization variables. it's the main character, it overrides everybody. 👑
  • LC_CTYPE — determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as opposed to multi-byte characters in arguments).
  • LC_MESSAGES — determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.
  • NLSPATH — determine the location of message catalogs for the processing of LC_MESSAGES.

⭐ ASYNCHRONOUS EVENTS ⭐

Default.

no special signal choreography here, just the default behavior. chill. 🫶

✨ STDOUT ✨

Not used.

not a single character goes out. it's silent, it's mysterious, it's doing its thing in the dark. 💅

💖 STDERR 💖

The standard error shall be used only for diagnostic messages.

that's it. that's the only place it speaks. and only when something's up. 😭

🎀 OUTPUT FILES 🎀

None.

🌈 EXTENDED DESCRIPTION 🌈

None.

no extra lore. the description was the description. we move. 🔥

👑 EXIT STATUS 👑

The following exit values shall be returned:

  1. 0 — Successful completion. ate. 💅
  2. >0 — An error occurred. 😭

💀 CONSEQUENCES OF ERRORS 💀

Default.

The following sections are informative.

ok so heads up: everything from here down is informative, meaning it's context and lore, not requirements. just so you know what you're reading, bestie.

🦋 APPLICATION USAGE 🦋

None.

🍓 EXAMPLES 🍓

None.

no examples on this one. shocking, I know. 🙈

💜 RATIONALE 💜

None.

⭐ FUTURE DIRECTIONS ⭐

None.

🌸 SEE ALSO 🌸

  • ipcs
  • The Base Definitions volume of POSIX.1‐2017, Chapter 8, Environment Variables, Section 12.2, Utility Syntax Guidelines
  • The System Interfaces volume of POSIX.1‐2017, msgctl(), semctl(), shmctl()

like yeah, go read ipcs to see what's there, then come back here to remove it. and those three system interfaces? that's where the actual machinery lives. iykyk. ✨

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

ok that's the whole thing, bestie 💖 this page came to you from the IEEE/The Open Group, dated 2017, and its manual name is IPCRM(1POSIX) — go forth and clean up your IPC like the icon you are. 🎀✨🦋

📦 where this page comes from