man pages section 3: Library Interfaces and Headers

libdat(3LIB)

Name

libdat– direct access transport library

Synopsis

cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>

Description

The libdat library provides an application with the User Direct Access Programming Library (uDAPL) 1.2 functions to access the underlying RDMA-able interconnects. Different uDAPL service providers listed in the DAT static registry dat.conf(4) can be registered during runtime with the DAT library. After an application opens an interface adapter belonging to a particular service provider, all function calls will be redirected to that service provider's library.

INTERFACES

The shared object libdat.so.1 provides the public interfaces defined below for applications. See Intro(3) for additional information on shared object interfaces.

uDAPL 1.1

`dat_cno_create`	`dat_cno_free`
`dat_cno_modify_agent`	`dat_cno_query`
`dat_cno_wait`	`dat_cr_accept`
`dat_cr_handoff`	`dat_cr_query`
`dat_cr_reject`	`dat_ep_connect`
`dat_ep_create`	`dat_ep_disconnect`
`dat_ep_dup_connect`	`dat_ep_free`
`dat_ep_get_status`	`dat_ep_modify`
`dat_ep_post_rdma_read`	`dat_ep_post_rdma_write`
`dat_ep_post_recv`	`dat_ep_post_send`
`dat_ep_query`	`dat_ep_reset`
`dat_evd_clear_unwaitable`	`dat_evd_create`
`dat_evd_dequeue`	`dat_evd_disable`
`dat_evd_enable`	`dat_evd_free`
`dat_evd_modify_cno`	`dat_evd_post_se`
`dat_evd_query`	`dat_evd_resize`
`dat_evd_set_unwaitable`	`dat_evd_wait`
`dat_get_consumer_context`	`dat_get_handle_type`
`dat_ia_close`	`dat_ia_open`
`dat_ia_query`	`dat_lmr_create`
`dat_lmr_free`	`dat_lmr_query`
`dat_provider_fini`	`dat_provider_init`
`dat_psp_create`	`dat_psp_create_any`
`dat_psp_free`	`dat_psp_query`
`dat_pz_create`	`dat_pz_free`
`dat_pz_query`	`dat_registry_list_providers`
`dat_rmr_bind`	`dat_rmr_create`
`dat_rmr_free`	`dat_rmr_query`
`dat_rsp_create`	`dat_rsp_free`
`dat_rsp_query`	`dat_set_consumer_context`
`dat_strerror`

uDAPL 1.2

`dat_ep_create_with_srq`	`dat_ep_recv_query`
`dat_ep_set_watermark`	`dat_lmr_sync_rdma_read`
`dat_lmr_sync_rdma_write`	`dat_srq_create`
`dat_srq_free`	`dat_srq_post_recv`
`dat_srq_query`	`dat_srq_resize`
`dat_srq_set_lw`

The shared object libdat.so.1 also provides the public interfaces defined below for service providers.

dat_registry_add_provider

dat_registry_remove_provider

Files

/usr/lib/libdat.so.1: shared object
/usr/lib/64/libdat.so.1: 64–bit shared object

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWudaplu (user)
	SUNWudaplr (root)
Interface Stability	Standard: uDAPL, 1.1, 1.2
MT-Level	Unsafe

Notes

The libdat library supports service providers written according to the uDAPL 1.2 specification. A service provider library has to be a dynamic loadable shared object with two public entry points exported:

dat_provider_init

dat_provider_fini

In terms of installation, the service provider package should include a service_provider.conf(4) file. The datadm(1M) administrative configuration program should be used to add and remove service provider's entries in the system-wide dat.conf(4).

SunOS 5.10 Last Revised 16 Jul 2004