LSMP(1)

LSMP(1) 💅

okay so this is LSMP(1) straight out of the General Commands Manual, and she's here to spill all the tea on mach ports for processes on the system. 🫖✨

🌸 NAME 🌸

lsmp — display mach port information for processes on the system.

⭐ SYNOPSIS ⭐

No cap, here's the whole lineup:

lsmp -h
lsmp -p <pid>
lsmp -v
lsmp -a
lsmp -j <path>

What each one means, bestie:

• lsmp -h — the -h invocation, right here, periodt. 💅
• lsmp -p <pid> — show mach port usage for <pid>. Run with root privileges to see detailed info about port destinations etc.
• lsmp -v — show information in detail for Kernel object based ports. Including thread ports and special ports attached to it.
• lsmp -a — show mach port usage for all tasks in the system.
• lsmp -j <path> — save output as JSON to <path>.

🦋 DESCRIPTION 🦋

The lsmp command prints information about every active right in a task's port space, giving a view into the inter-process communication behavior of that task. It's giving full port-space main character energy, honestly. 👑

Following is an explanation of each symbol and values from the output:

• name — Task unique name for a port. A - signifies that this is a member of a port-set.
• ipc-object — A unique identifier for a kernel object. A + sign implies that this entry is expanded from above ipc-object.
• rights — Rights corresponding to this name. Possible values are recv, send, send-once and port-set.
• flags — Flags indicating port status.
  • T — Port has tempowner set
  • G — Port is guarded
  • S — Port has strict guarding restrictions
  • I — Port has importance donation flag set
  • R — Port is marked reviving
  • P — Port has task pointer set
• boost — Importance boost count.
• reqs — Notifications armed on this port.
  • D — Dead name notification
  • N — No sender notification
  • P — Port Destroy requests
• recv — Number of recv rights for this name.
• send — Number of send rights stored at this name. This does NOT reflect the total number of send rights for this recv right.
• sonce — Number of outstanding send-once rights for this receive right.
• oref — Do send rights exist somewhere for this receive right?
• qlimit — Queue limit for this port. If orefs column shows -> then it indicates the queue limit on the destination port. And a <- indicates this port right is destined to receive messages from process referred in identifier column.
• msgcount — Number of messages enqueued on this port. See qlimit for -> and <- explanations.
• context — Mach port context value.
• identifier — A unique identifier for a kernel object or task's name for this right. This field is described by the type column.

💜 SEE ALSO 💜

Go bother these besties too:

• ddt(1)
• top(1)

🌸 macOS · July 24, 2012 · LSMP(1) — okay love u, bye bestie 💋