Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3dax/dax_thread_init.3dax
Real path: /usr/share/man/man3dax/dax_thread_init.3dax
Zurück

'\" te .\" Copyright (c) 2016, 2020, Oracle and/or its affiliates. .TH dax_thread_init 3DAX "26 Nov 2018" "Oracle Solaris 11.4" "DAX Library Functions" .SH NAME dax_thread_init \- create a command context .SH SYNOPSIS .LP .nf cc [ flag... ] file... -ldax [ library...] #include <dax.h> dax_status_t dax_thread_init(unsigned \fImajor\fR, unsigned \fIminor\fR, uint64_t \fIoptions\fR, dax_init_options_t *\fIargs\fR, dax_context_t **\fIctx\fR); .fi .SH DESCRIPTION .sp .LP This function initializes the DAX for use by the calling thread and returns a DAX context in \fIctx\fR. Only the thread that creates the context should use it. .sp .LP The \fImajor\fR parameter identifies the major version of the \fBlibdax\fR API to be used, and \fIminor\fR identifies the minor version. Supported combinations are: .sp .TS tab( ); cw(i) cw(i) cw(i) cw(i) . major minor _ 1 1 2 1 .TE .sp .sp .LP The following are the values for the \fIoptions\fR parameter, and they can be logically OR'd together: .sp .ne 2 .mk .na \fBDAX_ALLOC\fR .ad .br .sp .6 .RS 4n The \fBlibdax\fR library uses the \fBargs->alloc_func()\fR and \fBargs->free_func()\fR functions to allocate and free memory in DAX functions that use \fIctx\fR. The \fBalloc_func()\fR must return a pointer that is at least 8 byte aligned. The functions use the following arguments: .sp .in +2 .nf ptr = alloc_func(size, args->cb_data); free_func(ptr, size, args->cb_data); .fi .in -2 .sp .RE .sp .ne 2 .mk .na \fBDAX_EMULATE\fR .ad .br .sp .6 .RS 4n By default, DAX operations are done in hardware when possible, and emulated in software when hardware support is not present. \fBDAX_EMULATE\fR forces software emulation to be used in all cases. Software emulation can also be selected at runtime, by setting the \fBDAX_EMULATE\fR environment variable to 1. .RE .sp .LP Sets debug options for \fIctx\fR to the value of the \fBDAX_DEBUG_OPTIONS\fR environment variable if it is defined, else sets options to \fBDAX_DEBUG_ARG\fR. The format of \fBDAX_DEBUG_OPTIONS\fR is a comma separated list of option names with no whitespace. Recognized names are "\fBarg\fR", "\fBextra\fR", and "\fBall\fR". The latter enables all options. For more information, see the \fBdax_set_debug\fR(3DAX) man page. .sp .LP Sets log options for \fIctx\fR to the value of the \fBDAX_LOG_OPTIONS\fR environment variable if it is defined, else sets the options to \fBDAX_LOG_OFF\fR. The format of \fBDAX_LOG_OPTIONS\fR is a comma separated list of option names with no whitespace. Recognized names are "\fBerror\fR", "\fBwarn\fR", "\fBentry\fR", "\fBreturn\fR", "\fBperf\fR", "\fBverbose\fR", and "\fBall\fR". The latter enables all options. For more information, see the \fBdax_set_log\fR(3DAX) man page. .sp .LP Sends log messages to the file descriptor specified by the \fBDAX_LOG_FD\fR environment variable. Its format is an integer. Sends messages to \fBsyslog(3c)\fR if \fBDAX_LOG_OPTIONS\fR is set but \fBDAX_LOG_FD\fR is not defined. .SH RETURN VALUES .sp .ne 2 .mk .na \fBDAX_SUCCESS\fR .ad .RS 17n .rt Operation completed successfully .RE .sp .ne 2 .mk .na \fBDAX_EBADVER\fR .ad .RS 17n .rt Bad API version .RE .sp .ne 2 .mk .na \fBDAX_ENOACCESS\fR .ad .RS 17n .rt Caller does not have permission to use DAX .RE .sp .ne 2 .mk .na \fBDAX_ENOMEM\fR .ad .RS 17n .rt Memory resources are unavailable .RE .sp .ne 2 .mk .na \fBDAX_ENODEV\fR .ad .RS 17n .rt No DAX device present .RE .sp .ne 2 .mk .na \fBDAX_EINVAL\fR .ad .RS 17n .rt Unknown \fIoptions\fR, or \fBDAX_ALLOC\fR is specified and \fBalloc_func()\fR or \fBfree_func()\fR is \fBNULL\fR. .RE .sp .ne 2 .mk .na \fBDAX_EINTERNAL\fR .ad .RS 17n .rt Unknown internal error .RE .SH USAGE .sp .LP For best performance, the \fBalloc_func()\fR function should return memory backed by large pages. Oracle Solaris creates large pages by default, and you can change the default page size by using the \fBMC_HAT_ADVISE\fR option of \fBmemcntl\fR(2). .sp .LP \fBDAX_EMULATE\fR is useful for developing \fBlibdax\fR applications on platforms that do not support DAX hardware. But emulation is not recommended for production, as the emulation functions are not optimized and performance will be low. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Availability system/library _ Interface Stability Committed .TE .sp .SH SEE ALSO .sp .LP \fBdax_thread_fini\fR(3DAX), \fBdax_set_debug\fR(3DAX), \fBdax_set_log\fR(3DAX), \fBlibdax\fR(3LIB), \fBprivileges\fR(5), \fBmemcntl\fR(2)