Functional specification
55
CDE/Motif PST
CDEnext
ERRORS/WARNINGS
SEE ALSO
2.26
XpSendAuth
2.26.1
Short Description
A standard convenience function to select and send display-connection authorization information in accordance
with the PDM Selection Protocol
2.26.2
Long Description
NAME
XpSendAuth - select and send display-connection authorization information in accordance with the PDM
Selection Protocol
SYNOPSIS
#include <X11/extensions/Print.h>
Status XpSendAuth (
Display
*display
,
Window
window
)
ARGUMENTS
display
Specifies a pointer to the print
Display
structure; returned from
XOpenDisplay
on the Selection Print Server.
window
Specifies the "mailbox window" as described in the PDM Selection
Protocol for the PDM_MBOX target.
RETURN VALUE
NULL status if an error occured, non-NULL otherwise.
DESCRIPTION
XpSendAuth
is a convenience routine that determines what display-connection authorization information
needs to be sent to a PDM, and sends it. Programmers can write their own code to figure out what
information needs to be sent, and then call
XpSendOneTicket
, or can simply call
XpSendAuth
and
let Xp do the right thing. See
XpGetAuthParams
for the necessary setup details.
XpSendAuth
considers authorization information in a .Xauthority style file pointed to by the
environment variable XPDMXAUTHORITY. Any and all authorization information in the file may be
sent to the PDM by the time
XpSendAuth
returns. Users can set XPDMXAUTHORITY to be the same