dacs_remote_mem_create

NAME

dacs_remote_mem_create - Designate a region in the memory space of the current process for access by remote processes.

SYNOPSIS

DACS_ERR_T dacs_remote_mem_create ( void *addr, uint64_t size, DACS_MEMORY_ACCESS_MODE_T access_mode, dacs_remote_mem_t *mem )

Call parameters  
*addr A pointer to the base address of the memory region to be shared.
size The size of the memory region in bytes.
access_mode The access mode to be given to the memory region. This may be:
  • DACS_READ_ONLY,
  • DACS_WRITE_ONLY, or
  • DACS_READ_WRITE.
Return parameter  
*mem A pointer to a remote memory handle to be filled in.

DESCRIPTION

The dacs_remote_mem_create service creates and returns a handle associated with the given memory region. The returned handle can be used with the dacs_remote_mem_share() and dacs_remote_mem_accept() services to share and gain access to remote shared memory.

RETURN VALUE

The service dacs_remote_mem_create returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: the pointer is invalid.
  • DACS_ERR_INVALID_ATTR: the flag or enumerated constant is invalid.
  • DACS_ERR_NO_RESOURCE: unable to allocate required resources.
  • DACS_ERR_INVALID_SIZE: a size of zero was requested.

SEE ALSO

dacs_remote_mem_share(3), dacs_remote_mem_accept(3), dacs_remote_mem_release(3), dacs_remote_mem_destroy(3), dacs_remote_mem_query(3)
Parent topic: Remote Direct Memory Access (rDMA)