.\"  Automatically generated man page, do not edit
.TH QB_IPCC_CONNECT 3 2023-07-21 "LIBQB" "libqb Programmer's Manual"
.SH NAME
qb_ipcc_connect \- Create a connection to an IPC service. 

.SH SYNOPSIS
.nf
.B #include <qb/qbipcc.h>
.sp
\fBqb_ipcc_connection_t * qb_ipcc_connect\fP(
    \fBconst char   *\fP\fIname\fP,\fR          /* name of the service. */
    \fBsize_t        \fP\fImax_msg_size\fP\fR   /* biggest msg size. */
);
.fi
.SH PARAMS
\fBname         \fP\fIname of the service. \fP
.PP
\fBmax_msg_size \fP\fIbiggest msg size. \fP
.PP
.SH DESCRIPTION
.SH RETURN VALUE
.PP
NULL (error: see errno) or a connection object.
.PP
.SH NOTE
.PP
It is recommended to do a one time check on the max_msg_size value using qb_ipcc_verify_dgram_max_msg_size \fBBEFORE\fR 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. 
.SH SEE ALSO
.PP
.nh
.ad l
\fIqb_ipcc_send\fR(3), \fIqb_ipcc_sendv_recv\fR(3), \fIqb_ipcc_recv\fR(3), \fIqb_ipcc_event_recv\fR(3), \fIqb_ipcc_connect_async\fR(3), \fIqb_ipcc_fc_enable_max_set\fR(3), \fIqb_ipcc_is_connected\fR(3), \fIqb_ipcc_connect_continue\fR(3), \fIqb_ipcc_auth_get\fR(3), \fIqb_ipcc_sendv\fR(3), \fIqb_ipcc_context_set\fR(3), \fIqb_ipcc_context_get\fR(3), \fIqb_ipcc_verify_dgram_max_msg_size\fR(3), \fIqb_ipcc_get_buffer_size\fR(3), \fIqb_ipcc_disconnect\fR(3), \fIqb_ipcc_fd_get\fR(3)
.ad
.hy
.SH "COPYRIGHT"
.PP
Copyright (C) 2010-2020 Red Hat, Inc.