mtcp_create_context 3 2017-02-01 "Linux" "mOS Library Functions Manual"
NAME
mtcp_create_context - create mTCP context for network communication
SYNOPSIS
#include <mtcp_api.h> "mctx_t mtcp_create_context(int " cpu );
DESCRIPTION
mtcp_create_context () creates the underlying mTCP stack based on the parameters passed by the mtcp_init() function call. Each mTCP thread requires its own exclusive invocation of the mtcp_create_context() routine before the stack can be used for network communication. The function requires a sole "cpu" integer argument that passes the CPU core-id of the system on which the stack is instantiated. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""
RETURN VALUE
Returns "mctx" on success; NULL on failure. Please see the "NOTES" section for details. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
"""".SH CONFORMING TO
""""POSIX.1-2001.
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
NOTES
The user cannot call mtcp_create_context() function more than once using the same cpu-id in a process. Passing an invalid CPU core-id (value < 0 or value > max_cpus) will prevent the creation of the mTCP stack. It is suggested that the user creates only 1 mTCP context thread per core for performance reasons. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
AUTHORS
mOS development team <[email protected]> """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
SEE ALSO
mtcp_destroy_context (), mtcp_init (), mtcp_destroy () """""""""""""""""""""""""""""""""""""""""""""""""""""
COLOPHON
This page is part of mOS release 0.3 "docs" section. A description of the project, and information about reporting bugs, can be found at \%http://mos.kaist.edu/. """""""""""""""""""""""""""""""""""""""""""""""""""""