FreeBSD Manual Pages
dtpdmd(user cmd) dtpdmd(user cmd) NAME dtpdmd -- Print Dialog Manager daemon SYNOPSIS dtpdmd [-d display] [-a selection] [-p pdm] [-P pdm] [-s] [-l log- file] DESCRIPTION The dtpdmd command uses the Print Dialog Manager Selection Protocol to start a Print Dialog Manager (PDM) on behalf of an application. 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. PDMD/PDM Protocol dtpdmd uses a specific protocol to communicate with the PDM. Communica- tion to the PDM is done via a standardized command line and environ- ment. Communication from the PDM is done via standardized exit codes. 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-com- mand, 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/dt- pdmd.h) are as follows: PDM_EXIT_OK The PDM is telling the PDMD that the user selected OK to dis- miss 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 au- thority 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 au- thority 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 uncontrol- lable exit conditions often found in other libraries (for ex- ample, 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 cre- ate 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 exe- cution string can be derived, usually from the Server Attri- bute dt-pdm-command from the X-Server. By default, the exe- cution 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 ex- change 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 en- vironment variable: XAUTHORITY If the dtpdmd has come into possession of X-authority infor- mation that the PDM will need, it sets this environment vari- able 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. RESOURCES None. ACTIONS/MESSAGES None. ERRORS/WARNINGS None. FILES None. EXAMPLES None. SEE ALSO dtpdm1 dtpdmd(user cmd)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | RESOURCES | ACTIONS/MESSAGES | ERRORS/WARNINGS | FILES | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtpdmd&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>