0001 TPNEWCTXT(3)
0002 ============
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tpnewctxt - Allocate new XATMI Context
0009
0010
0011 SYNOPSIS
0012 --------
0013 #include <atmi.h>
0014
0015 TPCONTEXT_T tpnewctxt(int 'auto_destroy', int 'auto_set')
0016
0017 Link with '-latmi -lubf -lnstd -lpthread -lrt -lm -ldl'
0018
0019 DESCRIPTION
0020 -----------
0021 Function allocates new XATMI context. This includes allocation of standard library TLS (NSTD), UBF library TLS (UBF) and ATMI library TLS. All is stored in object to which return value ('TPCONTEXT_T' type) points to.
0022
0023 The flag 'auto_destroy' if set to *1*, will make the allocated context to be automatically destroyed when thread exits (if at exit point of time this context was associated with it). To disable this functionality, set value to *0*.
0024
0025 if 'auto_set' flag is set to *1*, current thread is automatically associated with newly allocated context. To disable this functionality, use value *0*.
0026
0027
0028 RETURN VALUE
0029 ------------
0030 On success, *tpnewctxt()* return pointer to newly allocate ATMI context object; on error, NULL is returned. Additional infos might be found in ULOG.
0031
0032 ERRORS
0033 ------
0034 N/A
0035
0036 EXAMPLE
0037 -------
0038 See *atmitest/test032_oapi/atmiclt32.c* for sample code.
0039
0040 BUGS
0041 ----
0042 Report bugs to support@mavimax.com
0043
0044 SEE ALSO
0045 --------
0046 *tpsetctxt(3)* *tpfreectxt(3)* *tpnewctxt(3)*
0047
0048 COPYING
0049 -------
0050 (C) Mavimax, Ltd
0051
