NAME¶

qb_ipcc_connect - Create a connection to an IPC service.

SYNOPSIS¶

#include <qb/qbipcc.h>

qb_ipcc_connection_t * qb_ipcc_connect(


    const char   *name,          /* name of the service. */


    size_t        max_msg_size   /* biggest msg size. */
);

PARAMS¶

name name of the service.

max_msg_size biggest msg size.

DESCRIPTION¶

RETURN VALUE¶

NULL (error: see errno) or a connection object.

NOTE¶

It is recommended to do a one time check on the max_msg_size value using qb_ipcc_verify_dgram_max_msg_size BEFORE calling the connect function when IPC_SOCKET is in use. Some distributions while allow large message buffers to be set on the socket, but not actually honor them because of kernel state values. The qb_ipcc_verify_dgram_max_msg_size function both sets the socket buffer size and verifies it by doing a send/recv.

SEE ALSO¶

qb_ipcc_send(3), qb_ipcc_sendv_recv(3), qb_ipcc_recv(3), qb_ipcc_event_recv(3), qb_ipcc_connect_async(3), qb_ipcc_fc_enable_max_set(3), qb_ipcc_is_connected(3), qb_ipcc_connect_continue(3), qb_ipcc_auth_get(3), qb_ipcc_sendv(3), qb_ipcc_context_set(3), qb_ipcc_context_get(3), qb_ipcc_verify_dgram_max_msg_size(3), qb_ipcc_get_buffer_size(3), qb_ipcc_disconnect(3), qb_ipcc_fd_get(3)

COPYRIGHT¶

Copyright (C) 2010-2020 Red Hat, Inc.