path: root/man/v1.3.0/nn_poll.3compat.html

---
version: v1.3.0
layout: manpage
title: nn_poll(3compat)
---
<nav id="toc" class="toc2">
<div id="toctitle">Table of Contents</div>
<ul class="sectlevel1
">
<li>Commands and Utilities</li>
<ul class="sectlevel2">
<li><a href="nngcat.1.html">nngcat</a></li>
</ul>
<li>Library Functions</li>
<ul class="sectlevel2">
<li><a href="libnng.3.html">libnng</a></li>
<li><a href="nng_aio_abort.3.html">nng_aio_abort</a></li>
<li><a href="nng_aio_alloc.3.html">nng_aio_alloc</a></li>
<li><a href="nng_aio_begin.3.html">nng_aio_begin</a></li>
<li><a href="nng_aio_cancel.3.html">nng_aio_cancel</a></li>
<li><a href="nng_aio_count.3.html">nng_aio_count</a></li>
<li><a href="nng_aio_defer.3.html">nng_aio_defer</a></li>
<li><a href="nng_aio_finish.3.html">nng_aio_finish</a></li>
<li><a href="nng_aio_free.3.html">nng_aio_free</a></li>
<li><a href="nng_aio_get_input.3.html">nng_aio_get_input</a></li>
<li><a href="nng_aio_get_msg.3.html">nng_aio_get_msg</a></li>
<li><a href="nng_aio_get_output.3.html">nng_aio_get_output</a></li>
<li><a href="nng_aio_result.3.html">nng_aio_result</a></li>
<li><a href="nng_aio_set_input.3.html">nng_aio_set_input</a></li>
<li><a href="nng_aio_set_iov.3.html">nng_aio_set_iov</a></li>
<li><a href="nng_aio_set_msg.3.html">nng_aio_set_msg</a></li>
<li><a href="nng_aio_set_output.3.html">nng_aio_set_output</a></li>
<li><a href="nng_aio_set_timeout.3.html">nng_aio_set_timeout</a></li>
<li><a href="nng_aio_stop.3.html">nng_aio_stop</a></li>
<li><a href="nng_aio_wait.3.html">nng_aio_wait</a></li>
<li><a href="nng_alloc.3.html">nng_alloc</a></li>
<li><a href="nng_bus_open.3.html">nng_bus_open</a></li>
<li><a href="nng_close.3.html">nng_close</a></li>
<li><a href="nng_ctx_close.3.html">nng_ctx_close</a></li>
<li><a href="nng_ctx_get.3.html">nng_ctx_get</a></li>
<li><a href="nng_ctx_getopt.3.html">nng_ctx_getopt</a></li>
<li><a href="nng_ctx_id.3.html">nng_ctx_id</a></li>
<li><a href="nng_ctx_open.3.html">nng_ctx_open</a></li>
<li><a href="nng_ctx_recv.3.html">nng_ctx_recv</a></li>
<li><a href="nng_ctx_send.3.html">nng_ctx_send</a></li>
<li><a href="nng_ctx_set.3.html">nng_ctx_set</a></li>
<li><a href="nng_ctx_setopt.3.html">nng_ctx_setopt</a></li>
<li><a href="nng_device.3.html">nng_device</a></li>
<li><a href="nng_dial.3.html">nng_dial</a></li>
<li><a href="nng_dialer_close.3.html">nng_dialer_close</a></li>
<li><a href="nng_dialer_create.3.html">nng_dialer_create</a></li>
<li><a href="nng_dialer_get.3.html">nng_dialer_get</a></li>
<li><a href="nng_dialer_getopt.3.html">nng_dialer_getopt</a></li>
<li><a href="nng_dialer_id.3.html">nng_dialer_id</a></li>
<li><a href="nng_dialer_set.3.html">nng_dialer_set</a></li>
<li><a href="nng_dialer_setopt.3.html">nng_dialer_setopt</a></li>
<li><a href="nng_dialer_start.3.html">nng_dialer_start</a></li>
<li><a href="nng_free.3.html">nng_free</a></li>
<li><a href="nng_getopt.3.html">nng_getopt</a></li>
<li><a href="nng_inproc_register.3.html">nng_inproc_register</a></li>
<li><a href="nng_ipc_register.3.html">nng_ipc_register</a></li>
<li><a href="nng_listen.3.html">nng_listen</a></li>
<li><a href="nng_listener_close.3.html">nng_listener_close</a></li>
<li><a href="nng_listener_create.3.html">nng_listener_create</a></li>
<li><a href="nng_listener_get.3.html">nng_listener_get</a></li>
<li><a href="nng_listener_getopt.3.html">nng_listener_getopt</a></li>
<li><a href="nng_listener_id.3.html">nng_listener_id</a></li>
<li><a href="nng_listener_set.3.html">nng_listener_set</a></li>
<li><a href="nng_listener_setopt.3.html">nng_listener_setopt</a></li>
<li><a href="nng_listener_start.3.html">nng_listener_start</a></li>
<li><a href="nng_msg_alloc.3.html">nng_msg_alloc</a></li>
<li><a href="nng_msg_append.3.html">nng_msg_append</a></li>
<li><a href="nng_msg_body.3.html">nng_msg_body</a></li>
<li><a href="nng_msg_chop.3.html">nng_msg_chop</a></li>
<li><a href="nng_msg_clear.3.html">nng_msg_clear</a></li>
<li><a href="nng_msg_dup.3.html">nng_msg_dup</a></li>
<li><a href="nng_msg_free.3.html">nng_msg_free</a></li>
<li><a href="nng_msg_get_pipe.3.html">nng_msg_get_pipe</a></li>
<li><a href="nng_msg_header.3.html">nng_msg_header</a></li>
<li><a href="nng_msg_header_append.3.html">nng_msg_header_append</a></li>
<li><a href="nng_msg_header_chop.3.html">nng_msg_header_chop</a></li>
<li><a href="nng_msg_header_clear.3.html">nng_msg_header_clear</a></li>
<li><a href="nng_msg_header_insert.3.html">nng_msg_header_insert</a></li>
<li><a href="nng_msg_header_len.3.html">nng_msg_header_len</a></li>
<li><a href="nng_msg_header_trim.3.html">nng_msg_header_trim</a></li>
<li><a href="nng_msg_insert.3.html">nng_msg_insert</a></li>
<li><a href="nng_msg_len.3.html">nng_msg_len</a></li>
<li><a href="nng_msg_realloc.3.html">nng_msg_realloc</a></li>
<li><a href="nng_msg_set_pipe.3.html">nng_msg_set_pipe</a></li>
<li><a href="nng_msg_trim.3.html">nng_msg_trim</a></li>
<li><a href="nng_pair_open.3.html">nng_pair_open</a></li>
<li><a href="nng_pipe_close.3.html">nng_pipe_close</a></li>
<li><a href="nng_pipe_dialer.3.html">nng_pipe_dialer</a></li>
<li><a href="nng_pipe_get.3.html">nng_pipe_get</a></li>
<li><a href="nng_pipe_getopt.3.html">nng_pipe_getopt</a></li>
<li><a href="nng_pipe_id.3.html">nng_pipe_id</a></li>
<li><a href="nng_pipe_listener.3.html">nng_pipe_listener</a></li>
<li><a href="nng_pipe_notify.3.html">nng_pipe_notify</a></li>
<li><a href="nng_pipe_socket.3.html">nng_pipe_socket</a></li>
<li><a href="nng_pub_open.3.html">nng_pub_open</a></li>
<li><a href="nng_pull_open.3.html">nng_pull_open</a></li>
<li><a href="nng_push_open.3.html">nng_push_open</a></li>
<li><a href="nng_recv.3.html">nng_recv</a></li>
<li><a href="nng_recv_aio.3.html">nng_recv_aio</a></li>
<li><a href="nng_recvmsg.3.html">nng_recvmsg</a></li>
<li><a href="nng_rep_open.3.html">nng_rep_open</a></li>
<li><a href="nng_req_open.3.html">nng_req_open</a></li>
<li><a href="nng_respondent_open.3.html">nng_respondent_open</a></li>
<li><a href="nng_send.3.html">nng_send</a></li>
<li><a href="nng_send_aio.3.html">nng_send_aio</a></li>
<li><a href="nng_sendmsg.3.html">nng_sendmsg</a></li>
<li><a href="nng_setopt.3.html">nng_setopt</a></li>
<li><a href="nng_sleep_aio.3.html">nng_sleep_aio</a></li>
<li><a href="nng_socket_get.3.html">nng_socket_get</a></li>
<li><a href="nng_socket_id.3.html">nng_socket_id</a></li>
<li><a href="nng_socket_set.3.html">nng_socket_set</a></li>
<li><a href="nng_stat_child.3.html">nng_stat_child</a></li>
<li><a href="nng_stat_desc.3.html">nng_stat_desc</a></li>
<li><a href="nng_stat_find.3.html">nng_stat_find</a></li>
<li><a href="nng_stat_find_dialer.3.html">nng_stat_find_dialer</a></li>
<li><a href="nng_stat_find_listener.3.html">nng_stat_find_listener</a></li>
<li><a href="nng_stat_find_socket.3.html">nng_stat_find_socket</a></li>
<li><a href="nng_stat_name.3.html">nng_stat_name</a></li>
<li><a href="nng_stat_next.3.html">nng_stat_next</a></li>
<li><a href="nng_stat_string.3.html">nng_stat_string</a></li>
<li><a href="nng_stat_timestamp.3.html">nng_stat_timestamp</a></li>
<li><a href="nng_stat_type.3.html">nng_stat_type</a></li>
<li><a href="nng_stat_unit.3.html">nng_stat_unit</a></li>
<li><a href="nng_stat_value.3.html">nng_stat_value</a></li>
<li><a href="nng_stats_free.3.html">nng_stats_free</a></li>
<li><a href="nng_stats_get.3.html">nng_stats_get</a></li>
<li><a href="nng_strdup.3.html">nng_strdup</a></li>
<li><a href="nng_strerror.3.html">nng_strerror</a></li>
<li><a href="nng_strfree.3.html">nng_strfree</a></li>
<li><a href="nng_sub_open.3.html">nng_sub_open</a></li>
<li><a href="nng_surveyor_open.3.html">nng_surveyor_open</a></li>
<li><a href="nng_tcp_register.3.html">nng_tcp_register</a></li>
<li><a href="nng_tls_register.3.html">nng_tls_register</a></li>
<li><a href="nng_url_clone.3.html">nng_url_clone</a></li>
<li><a href="nng_url_free.3.html">nng_url_free</a></li>
<li><a href="nng_url_parse.3.html">nng_url_parse</a></li>
<li><a href="nng_version.3.html">nng_version</a></li>
<li><a href="nng_ws_register.3.html">nng_ws_register</a></li>
<li><a href="nng_wss_register.3.html">nng_wss_register</a></li>
<li><a href="nng_zt_register.3.html">nng_zt_register</a></li>
</ul>
<li>Compatible Library Functions</li>
<ul class="sectlevel2">
<li><a href="nn_allocmsg.3compat.html">nn_allocmsg</a></li>
<li><a href="nn_bind.3compat.html">nn_bind</a></li>
<li><a href="nn_close.3compat.html">nn_close</a></li>
<li><a href="nn_cmsg.3compat.html">nn_cmsg</a></li>
<li><a href="nn_connect.3compat.html">nn_connect</a></li>
<li><a href="nn_device.3compat.html">nn_device</a></li>
<li><a href="nn_errno.3compat.html">nn_errno</a></li>
<li><a href="nn_freemsg.3compat.html">nn_freemsg</a></li>
<li><a href="nn_get_statistic.3compat.html">nn_get_statistic</a></li>
<li><a href="nn_getsockopt.3compat.html">nn_getsockopt</a></li>
<li><a href="nn_poll.3compat.html">nn_poll</a></li>
<li><a href="nn_reallocmsg.3compat.html">nn_reallocmsg</a></li>
<li><a href="nn_recv.3compat.html">nn_recv</a></li>
<li><a href="nn_recvmsg.3compat.html">nn_recvmsg</a></li>
<li><a href="nn_send.3compat.html">nn_send</a></li>
<li><a href="nn_sendmsg.3compat.html">nn_sendmsg</a></li>
<li><a href="nn_setsockopt.3compat.html">nn_setsockopt</a></li>
<li><a href="nn_shutdown.3compat.html">nn_shutdown</a></li>
<li><a href="nn_socket.3compat.html">nn_socket</a></li>
<li><a href="nn_strerror.3compat.html">nn_strerror</a></li>
<li><a href="nn_term.3compat.html">nn_term</a></li>
<li><a href="nng_compat.3compat.html">nng_compat</a></li>
</ul>
<li>Supplemental HTTP Functions</li>
<ul class="sectlevel2">
<li><a href="nng_http_client_alloc.3http.html">nng_http_client_alloc</a></li>
<li><a href="nng_http_client_connect.3http.html">nng_http_client_connect</a></li>
<li><a href="nng_http_client_free.3http.html">nng_http_client_free</a></li>
<li><a href="nng_http_client_get_tls.3http.html">nng_http_client_get_tls</a></li>
<li><a href="nng_http_client_set_tls.3http.html">nng_http_client_set_tls</a></li>
<li><a href="nng_http_client_transact.3http.html">nng_http_client_transact</a></li>
<li><a href="nng_http_conn_close.3http.html">nng_http_conn_close</a></li>
<li><a href="nng_http_conn_read.3http.html">nng_http_conn_read</a></li>
<li><a href="nng_http_conn_read_all.3http.html">nng_http_conn_read_all</a></li>
<li><a href="nng_http_conn_read_req.3http.html">nng_http_conn_read_req</a></li>
<li><a href="nng_http_conn_read_res.3http.html">nng_http_conn_read_res</a></li>
<li><a href="nng_http_conn_transact.3http.html">nng_http_conn_transact</a></li>
<li><a href="nng_http_conn_write.3http.html">nng_http_conn_write</a></li>
<li><a href="nng_http_conn_write_all.3http.html">nng_http_conn_write_all</a></li>
<li><a href="nng_http_conn_write_req.3http.html">nng_http_conn_write_req</a></li>
<li><a href="nng_http_conn_write_res.3http.html">nng_http_conn_write_res</a></li>
<li><a href="nng_http_handler_alloc.3http.html">nng_http_handler_alloc</a></li>
<li><a href="nng_http_handler_collect_body.3http.html">nng_http_handler_collect_body</a></li>
<li><a href="nng_http_handler_free.3http.html">nng_http_handler_free</a></li>
<li><a href="nng_http_handler_get_data.3http.html">nng_http_handler_get_data</a></li>
<li><a href="nng_http_handler_set_data.3http.html">nng_http_handler_set_data</a></li>
<li><a href="nng_http_handler_set_host.3http.html">nng_http_handler_set_host</a></li>
<li><a href="nng_http_handler_set_method.3http.html">nng_http_handler_set_method</a></li>
<li><a href="nng_http_handler_set_tree.3http.html">nng_http_handler_set_tree</a></li>
<li><a href="nng_http_hijack.3http.html">nng_http_hijack</a></li>
<li><a href="nng_http_req_add_header.3http.html">nng_http_req_add_header</a></li>
<li><a href="nng_http_req_alloc.3http.html">nng_http_req_alloc</a></li>
<li><a href="nng_http_req_copy_data.3http.html">nng_http_req_copy_data</a></li>
<li><a href="nng_http_req_del_header.3http.html">nng_http_req_del_header</a></li>
<li><a href="nng_http_req_free.3http.html">nng_http_req_free</a></li>
<li><a href="nng_http_req_get_data.3http.html">nng_http_req_get_data</a></li>
<li><a href="nng_http_req_get_header.3http.html">nng_http_req_get_header</a></li>
<li><a href="nng_http_req_get_method.3http.html">nng_http_req_get_method</a></li>
<li><a href="nng_http_req_get_uri.3http.html">nng_http_req_get_uri</a></li>
<li><a href="nng_http_req_get_version.3http.html">nng_http_req_get_version</a></li>
<li><a href="nng_http_req_reset.3http.html">nng_http_req_reset</a></li>
<li><a href="nng_http_req_set_data.3http.html">nng_http_req_set_data</a></li>
<li><a href="nng_http_req_set_header.3http.html">nng_http_req_set_header</a></li>
<li><a href="nng_http_req_set_method.3http.html">nng_http_req_set_method</a></li>
<li><a href="nng_http_req_set_uri.3http.html">nng_http_req_set_uri</a></li>
<li><a href="nng_http_req_set_version.3http.html">nng_http_req_set_version</a></li>
<li><a href="nng_http_res_add_header.3http.html">nng_http_res_add_header</a></li>
<li><a href="nng_http_res_alloc.3http.html">nng_http_res_alloc</a></li>
<li><a href="nng_http_res_alloc_error.3http.html">nng_http_res_alloc_error</a></li>
<li><a href="nng_http_res_copy_data.3http.html">nng_http_res_copy_data</a></li>
<li><a href="nng_http_res_del_header.3http.html">nng_http_res_del_header</a></li>
<li><a href="nng_http_res_free.3http.html">nng_http_res_free</a></li>
<li><a href="nng_http_res_get_data.3http.html">nng_http_res_get_data</a></li>
<li><a href="nng_http_res_get_header.3http.html">nng_http_res_get_header</a></li>
<li><a href="nng_http_res_get_reason.3http.html">nng_http_res_get_reason</a></li>
<li><a href="nng_http_res_get_status.3http.html">nng_http_res_get_status</a></li>
<li><a href="nng_http_res_get_version.3http.html">nng_http_res_get_version</a></li>
<li><a href="nng_http_res_reset.3http.html">nng_http_res_reset</a></li>
<li><a href="nng_http_res_set_data.3http.html">nng_http_res_set_data</a></li>
<li><a href="nng_http_res_set_header.3http.html">nng_http_res_set_header</a></li>
<li><a href="nng_http_res_set_reason.3http.html">nng_http_res_set_reason</a></li>
<li><a href="nng_http_res_set_status.3http.html">nng_http_res_set_status</a></li>
<li><a href="nng_http_res_set_version.3http.html">nng_http_res_set_version</a></li>
<li><a href="nng_http_server_add_handler.3http.html">nng_http_server_add_handler</a></li>
<li><a href="nng_http_server_del_handler.3http.html">nng_http_server_del_handler</a></li>
<li><a href="nng_http_server_get_addr.3http.html">nng_http_server_get_addr</a></li>
<li><a href="nng_http_server_get_tls.3http.html">nng_http_server_get_tls</a></li>
<li><a href="nng_http_server_hold.3http.html">nng_http_server_hold</a></li>
<li><a href="nng_http_server_release.3http.html">nng_http_server_release</a></li>
<li><a href="nng_http_server_res_error.3http.html">nng_http_server_res_error</a></li>
<li><a href="nng_http_server_set_error_file.3http.html">nng_http_server_set_error_file</a></li>
<li><a href="nng_http_server_set_error_page.3http.html">nng_http_server_set_error_page</a></li>
<li><a href="nng_http_server_set_tls.3http.html">nng_http_server_set_tls</a></li>
<li><a href="nng_http_server_start.3http.html">nng_http_server_start</a></li>
<li><a href="nng_http_server_stop.3http.html">nng_http_server_stop</a></li>
</ul>
<li>Supplemental TCP Functions</li>
<ul class="sectlevel2">
<li><a href="nng_stream_close.3str.html">nng_stream_close</a></li>
<li><a href="nng_stream_dialer_alloc.3str.html">nng_stream_dialer_alloc</a></li>
<li><a href="nng_stream_dialer_close.3str.html">nng_stream_dialer_close</a></li>
<li><a href="nng_stream_dialer_dial.3str.html">nng_stream_dialer_dial</a></li>
<li><a href="nng_stream_dialer_free.3str.html">nng_stream_dialer_free</a></li>
<li><a href="nng_stream_dialer_get.3str.html">nng_stream_dialer_get</a></li>
<li><a href="nng_stream_dialer_set.3str.html">nng_stream_dialer_set</a></li>
<li><a href="nng_stream_free.3str.html">nng_stream_free</a></li>
<li><a href="nng_stream_get.3str.html">nng_stream_get</a></li>
<li><a href="nng_stream_listener_accept.3str.html">nng_stream_listener_accept</a></li>
<li><a href="nng_stream_listener_alloc.3str.html">nng_stream_listener_alloc</a></li>
<li><a href="nng_stream_listener_close.3str.html">nng_stream_listener_close</a></li>
<li><a href="nng_stream_listener_free.3str.html">nng_stream_listener_free</a></li>
<li><a href="nng_stream_listener_get.3str.html">nng_stream_listener_get</a></li>
<li><a href="nng_stream_listener_listen.3str.html">nng_stream_listener_listen</a></li>
<li><a href="nng_stream_listener_set.3str.html">nng_stream_listener_set</a></li>
<li><a href="nng_stream_recv.3str.html">nng_stream_recv</a></li>
<li><a href="nng_stream_send.3str.html">nng_stream_send</a></li>
<li><a href="nng_stream_set.3str.html">nng_stream_set</a></li>
</ul>
<li>Supplemental Functions</li>
<ul class="sectlevel2">
<li><a href="nng_clock.3supp.html">nng_clock</a></li>
<li><a href="nng_cv_alloc.3supp.html">nng_cv_alloc</a></li>
<li><a href="nng_cv_free.3supp.html">nng_cv_free</a></li>
<li><a href="nng_cv_until.3supp.html">nng_cv_until</a></li>
<li><a href="nng_cv_wait.3supp.html">nng_cv_wait</a></li>
<li><a href="nng_cv_wake.3supp.html">nng_cv_wake</a></li>
<li><a href="nng_cv_wake1.3supp.html">nng_cv_wake1</a></li>
<li><a href="nng_msleep.3supp.html">nng_msleep</a></li>
<li><a href="nng_mtx_alloc.3supp.html">nng_mtx_alloc</a></li>
<li><a href="nng_mtx_free.3supp.html">nng_mtx_free</a></li>
<li><a href="nng_mtx_lock.3supp.html">nng_mtx_lock</a></li>
<li><a href="nng_mtx_unlock.3supp.html">nng_mtx_unlock</a></li>
<li><a href="nng_opts_parse.3supp.html">nng_opts_parse</a></li>
<li><a href="nng_random.3supp.html">nng_random</a></li>
<li><a href="nng_thread_create.3supp.html">nng_thread_create</a></li>
<li><a href="nng_thread_destroy.3supp.html">nng_thread_destroy</a></li>
</ul>
<li>Supplemental TLS Functions</li>
<ul class="sectlevel2">
<li><a href="nng_tls_config_alloc.3tls.html">nng_tls_config_alloc</a></li>
<li><a href="nng_tls_config_auth_mode.3tls.html">nng_tls_config_auth_mode</a></li>
<li><a href="nng_tls_config_ca_chain.3tls.html">nng_tls_config_ca_chain</a></li>
<li><a href="nng_tls_config_ca_file.3tls.html">nng_tls_config_ca_file</a></li>
<li><a href="nng_tls_config_cert_key_file.3tls.html">nng_tls_config_cert_key_file</a></li>
<li><a href="nng_tls_config_free.3tls.html">nng_tls_config_free</a></li>
<li><a href="nng_tls_config_hold.3tls.html">nng_tls_config_hold</a></li>
<li><a href="nng_tls_config_own_cert.3tls.html">nng_tls_config_own_cert</a></li>
<li><a href="nng_tls_config_server_name.3tls.html">nng_tls_config_server_name</a></li>
<li><a href="nng_tls_config_version.3tls.html">nng_tls_config_version</a></li>
<li><a href="nng_tls_engine_description.3tls.html">nng_tls_engine_description</a></li>
<li><a href="nng_tls_engine_fips_mode.3tls.html">nng_tls_engine_fips_mode</a></li>
<li><a href="nng_tls_engine_name.3tls.html">nng_tls_engine_name</a></li>
</ul>
<li>Macros and Types</li>
<ul class="sectlevel2">
<li><a href="nng_aio.5.html">nng_aio</a></li>
<li><a href="nng_ctx.5.html">nng_ctx</a></li>
<li><a href="nng_dialer.5.html">nng_dialer</a></li>
<li><a href="nng_duration.5.html">nng_duration</a></li>
<li><a href="nng_iov.5.html">nng_iov</a></li>
<li><a href="nng_ipc_options.5.html">nng_ipc_options</a></li>
<li><a href="nng_listener.5.html">nng_listener</a></li>
<li><a href="nng_msg.5.html">nng_msg</a></li>
<li><a href="nng_options.5.html">nng_options</a></li>
<li><a href="nng_pipe.5.html">nng_pipe</a></li>
<li><a href="nng_sockaddr.5.html">nng_sockaddr</a></li>
<li><a href="nng_sockaddr_in.5.html">nng_sockaddr_in</a></li>
<li><a href="nng_sockaddr_in6.5.html">nng_sockaddr_in6</a></li>
<li><a href="nng_sockaddr_inproc.5.html">nng_sockaddr_inproc</a></li>
<li><a href="nng_sockaddr_ipc.5.html">nng_sockaddr_ipc</a></li>
<li><a href="nng_sockaddr_zt.5.html">nng_sockaddr_zt</a></li>
<li><a href="nng_socket.5.html">nng_socket</a></li>
<li><a href="nng_stat.5.html">nng_stat</a></li>
<li><a href="nng_stream.5.html">nng_stream</a></li>
<li><a href="nng_stream_dialer.5.html">nng_stream_dialer</a></li>
<li><a href="nng_stream_listener.5.html">nng_stream_listener</a></li>
<li><a href="nng_tcp.5.html">nng_tcp</a></li>
<li><a href="nng_tcp_options.5.html">nng_tcp_options</a></li>
<li><a href="nng_tls.5.html">nng_tls</a></li>
<li><a href="nng_tls_config.5.html">nng_tls_config</a></li>
<li><a href="nng_tls_engine.5.html">nng_tls_engine</a></li>
<li><a href="nng_tls_options.5.html">nng_tls_options</a></li>
</ul>
<li>Protocols and Transports</li>
<ul class="sectlevel2">
<li><a href="nng.7.html">nng</a></li>
<li><a href="nng_bus.7.html">nng_bus</a></li>
<li><a href="nng_inproc.7.html">nng_inproc</a></li>
<li><a href="nng_ipc.7.html">nng_ipc</a></li>
<li><a href="nng_pair.7.html">nng_pair</a></li>
<li><a href="nng_pub.7.html">nng_pub</a></li>
<li><a href="nng_pull.7.html">nng_pull</a></li>
<li><a href="nng_push.7.html">nng_push</a></li>
<li><a href="nng_rep.7.html">nng_rep</a></li>
<li><a href="nng_req.7.html">nng_req</a></li>
<li><a href="nng_respondent.7.html">nng_respondent</a></li>
<li><a href="nng_sub.7.html">nng_sub</a></li>
<li><a href="nng_surveyor.7.html">nng_surveyor</a></li>
<li><a href="nng_tcp.7.html">nng_tcp</a></li>
<li><a href="nng_tls.7.html">nng_tls</a></li>
<li><a href="nng_ws.7.html">nng_ws</a></li>
<li><a href="nng_zerotier.7.html">nng_zerotier</a></li>
</ul>
</ul>
</nav>
<main>
{% if page.version and page.version != site.latest  %}
{% if page.version == "tip" %}
{% include manpage-tip.html %}
{% else %}
{% include manpage-old.html %}
{% endif %}
{% endif %}
<div id="header">
<h1>nn_poll(3compat) Manual Page</h1>
<h2 id="_name">NAME</h2>
<div class="sectionbody">
<p>nn_poll - poll sockets (compatible API)</p>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
<div class="listingblock">
<div class="content">
<pre class="pygments highlight"><code data-lang="c"><span></span><span class="tok-cp">#include</span> <span class="tok-cpf">&lt;nanomsg/nn.h&gt;</span><span class="tok-cp"></span>

<span class="tok-cp">#define NN_POLLIN  1</span>
<span class="tok-cp">#define NN_POLLOUT 2</span>

<span class="tok-k">struct</span> <span class="tok-n">nn_pollfd</span> <span class="tok-p">{</span>
<span class="tok-kt">int</span>      <span class="tok-n">fd</span><span class="tok-p">;</span>
<span class="tok-kt">uint16_t</span> <span class="tok-n">events</span><span class="tok-p">;</span>
<span class="tok-kt">uint16_t</span> <span class="tok-n">revents</span><span class="tok-p">;</span>
<span class="tok-p">};</span>

<span class="tok-kt">int</span> <span class="tok-nf">nn_poll</span><span class="tok-p">(</span><span class="tok-k">struct</span> <span class="tok-n">nn_pollfd</span> <span class="tok-o">*</span><span class="tok-n">pfds</span><span class="tok-p">,</span> <span class="tok-kt">int</span> <span class="tok-n">npfd</span><span class="tok-p">,</span> <span class="tok-kt">int</span> <span class="tok-n">timeout</span><span class="tok-p">);</span></code></pre>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>nn_poll()</code> function polls a group of sockets for readiness to send or receive.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
This function is provided for API
<a href="nng_compat.3compat.html">compatibility</a> with legacy <em>libnanomsg</em>.
Consider using the relevant <a href="libnng.3.html">modern API</a> instead.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>The array of <em>nfds</em> sockets to poll for are passed into <em>pfds</em>.
Each member of this array is initialized with the <code>fd</code> field set to
the socket, and the <code>events</code> field set to a mask that can contain either or both
of the flags <code>NN_POLLIN</code> and <code>NN_POLLOUT</code>.</p>
</div>
<div class="paragraph">
<p>The flag <code>NN_POLLIN</code> indicates that a socket is ready for receiving without
blocking (a message is available on the socket), and the flag <code>NN_POLLOUT</code>
indicates that a socket is ready for sending without blocking.</p>
</div>
<div class="paragraph">
<p>Upon success, the function returns the number of updates the <code>revents</code>
field of each member of the <em>pfds</em> array, setting it to indicate
whether the requested status is true or not.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
The <code>revents</code> field will only have a flag set if the corresponding
flag was also set in the <code>events</code> field.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>If the <em>timeout</em> field is positive, then this function will wait for
up the that many milliseconds.
If none of the requested events occurs before that timeout occurs, then
the function will return -1 and set the error to <code>ETIMEDOUT</code>.</p>
</div>
<div class="paragraph">
<p>If the <em>timeout</em> is zero, then this function will return immediately,
after updating the current status of the sockets.</p>
</div>
<div class="paragraph">
<p>If the <em>timeout</em> is -1, then the function waits forever, or until one of the
requested events occurs.</p>
</div>
<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
This function is only suitable for use with sockets obtained with the
<a href="nn_socket.3compat.html"><code>nn_socket()</code></a> function, and is not compatible
with file descriptors obtained via any other means.
This includes file descriptors obtained using the <code>NN_SNDFD</code> or <code>NN_RCVFD</code>
options with <a href="nn_getsockopt.3compat.html"><code>nn_getsockopt()</code></a>
</td>
</tr>
</table>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
This function is significantly less efficient than other polling
or asynchronous I/O mechanisms, and is provided for API compatibility only.
It&#8217;s use is discouraged.
</td>
</tr>
</table>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
This function is <strong>not</strong> supported on systems other than POSIX derived
platforms and Windows.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_return_values">RETURN VALUES</h2>
<div class="sectionbody">
<div class="paragraph">
<p>This function returns the number of sockets with events on success, or -1 on error.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_errors">ERRORS</h2>
<div class="sectionbody">
<div class="hdlist">
<table>
<tr>
<td class="hdlist1">
<code>ENOMEM</code>
</td>
<td class="hdlist2">
<p>Insufficient memory available.</p>
</td>
</tr>
<tr>
<td class="hdlist1">
<code>EBADF</code>
</td>
<td class="hdlist2">
<p>One of the sockets is not open.</p>
</td>
</tr>
<tr>
<td class="hdlist1">
<code>ETIMEDOUT</code>
</td>
<td class="hdlist2">
<p>Operation timed out.</p>
</td>
</tr>
<tr>
<td class="hdlist1">
<code>ENOTSUP</code>
</td>
<td class="hdlist2">
<p>This function is not supported on this platform.</p>
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
<div class="paragraph text-left">
<p><a href="nn_errno.3compat.html">nn_errno(3compat)</a>,
<a href="nn_recv.3compat.html">nn_recv(3compat)</a>,
<a href="nn_send.3compat.html">nn_send(3compat)</a>,
<a href="nn_socket.3compat.html">nn_socket(3compat)</a>,
<a href="nng_compat.3compat.html">nn_compat(3compat)</a>,
<a href="nng.7.html">nng(7)</a></p>
</div>
</div>
</div>
</div>
</main>