DTPDMD(1)

okay so bestie, welcome to dtpdmd from the user cmd manual — the Print Dialog Manager daemon, and she is lowkey a long-lived icon 👑. this page is about how she gets a Print Dialog Manager (PDM) on behalf of an application, and honestly? the protocol lore ate. let's go 🫶

🌸 NAME 🌸

dtpdmd — Print Dialog Manager daemon, your fave daemon bestie 💅

✨ SYNOPSIS ✨

dtpdmd [-d display] [-a selection] [-p pdm] [-P pdm] [-s] [-l logfile]

🦋 DESCRIPTION 🦋

the dtpdmd command uses the Print Dialog Manager Selection Protocol to start a Print Dialog Manager (PDM) on behalf of an application. no cap, that's the whole job and she's serving it.

dtpdmd is a long-lived daemon process that receives client requests for a PDM, uses some lookup rules, and then starts an appropriate PDM to service the request. when the PDM finishes, control returns to dtpdmd, and dtpdmd in turn responds to the client with the final status. it's giving main character daemon energy, fr fr ✨

💬 PDMD/PDM Protocol 💬

dtpdmd uses a specific protocol to communicate with the PDM. communication to the PDM is done via a standardized command line and environment. communication from the PDM is done via standardized exit codes. iykyk 🫶

📎 Standardized Command Line 📎

the standardized command line is as follows:

dt-pdm-command [dt-pdm-options] -vdisplay vdpy -window vwid -pdisplay pdpy -pcontext pcid

• dt-pdm-command — specifies the path for the PDM executable. it is derived by the dtpdmd from either the -p or -P option.
• dt-pdm-options — specifies options that may have accompanied the dt-pdm-command, whether specified on the dtpdmd command line by the -p or -P option or from other sources.
• -vdisplay vdpy — specifies the display connection to the Video X-Server.
• -window vwid — specifies the window id on the Video X-Server to which the PDM's dialogs should be posted as transient windows.
• -pdisplay pdpy — specifies the display connection to the Print X-Server.
• -pcontext pcid — specifies the print context id on the Print X-Server. the PDM uses this id to gain access to the print context being used by the requesting application.

💀 Standardized Exit Codes 💀

the standardized exit codes (defined as integer constants in Dt/dtpdmd.h) are as follows:

• PDM_EXIT_OK — the PDM is telling the PDMD that the user selected OK to dismiss the PDM.
• PDM_EXIT_CANCEL — the PDM is telling the PDMD that the user selected CANCEL to dismiss the PDM.
• DM_EXIT_VXAUTH — the PDM is telling the PDMD that it did not have proper authority to make a display connection on the Video X-Server.
• PDM_EXIT_PXAUTH — the PDM is telling the PDMD that it did not have proper authority to make a display connection to the Print X-Server.
• PDM_EXIT_ERROR — the PDM is telling the PDMD that it encountered an error.
• all other values — the PDMD treats all unknown return values the same as PDM_EXIT_ERROR. such return values are likely from uncontrollable exit conditions often found in other libraries (for example, untrapped XIO errors from libX).

🎀 OPTIONS 🎀

the following options are available:

• -d display — specifies the display connection to an X-Server upon which an X-selection will be created and managed for requests. if specified, it overrides the environment variable XPDMDISPLAY.
• -a selection — specifies an alternative X-selection name for dtpdmd to create and manage. if specified, it overrides the environment variable XPDMSELECTION. by default, the selection name is PDM_MANAGER.
• -p pdm — specifies a PDM execution string to use if no other PDM execution string can be derived, usually from the Server Attribute dt-pdm-command from the X-Server. by default, the execution string is dtpdm. all execution strings are applied against the current search path.
• -P pdm — specifies an alternative PDM execution string that overrides all other sources of such execution strings. all execution strings are applied against the current search path.
• -s — instructs dtpdmd to turn on the security exchange portion of the PDM Selection Protocol. by default, dtpdmd does not exchange security information with an application over the wire, so the appearance of auto hosting cannot be done.
• -l logfile — specifies a file for dtpdmd to use for logging errors and warnings. entries are time-stamped and may be generated by dtpdmd or any child PDM via stderr. the previous contents of the log file are destroyed. by default, /dev/null is used.

🌈 ENVIRONMENT VARIABLES 🌈

prior to starting a PDM, the dtpdmd may first modify the following environment variable:

• XAUTHORITY — if the dtpdmd has come into possession of X-authority information that the PDM will need, it sets this environment variable so that the PDM will automatically have access to the proper X-authority information.

in addition, the dtpdmd may set a locale hint passed to it by the PDM Selection Protocol from the client prior to starting a PDM. on POSIX systems, setlocale(3C) will be used. cute, functional, and locale-aware 🧚

🍓 RESOURCES 🍓

None. literally none bestie 💀

🧚 ACTIONS/MESSAGES 🧚

None. no actions, no messages, just vibes 🫶

🙈 ERRORS/WARNINGS 🙈

None. iconic behavior, honestly 💅

📁 FILES 📁

None. not a file in sight 🌸

⭐ EXAMPLES ⭐

None. the original page said None, and we respect the minimalist queen 💖

👑 SEE ALSO 👑

dtpdm1

---

that's the whole page, bestie — signed off by dtpdmd from the user cmd manual; the footer has no date listed, so we're not inventing one, and we're leaving you with footer energy 🎀💖