Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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>

home | help