Poster of Linux kernelThe best gift for a Linux geek
IBV_FORK_INIT

IBV_FORK_INIT

Section: Libibverbs Programmer's Manual (3) Updated: 2006-10-31
Local index Up
 

NAME

ibv_fork_init - initialize libibverbs to support fork()  

SYNOPSIS

#include <infiniband/verbs.h>

int ibv_fork_init(void);
 

DESCRIPTION

ibv_fork_init() initializes libibverbs's data structures to handle fork() function calls correctly and avoid data corruption, whether fork() is called explicitly or implicitly (such as in system()).

It is not necessary to use this function if all parent process threads are always blocked until all child processes end or change address spaces via an exec() operation.  

RETURN VALUE

ibv_fork_init() returns 0 on success, or the value of errno on failure (which indicates the failure reason).  

NOTES

ibv_fork_init() works on Linux kernels supporting the MADV_DONTFORK flag for madvise() (2.6.17 and higher).

Setting the environment variable RDMAV_FORK_SAFE or IBV_FORK_SAFE has the same effect as calling ibv_fork_init().

Calling ibv_fork_init() will reduce performance due to an extra system call for every memory registration, and the additional memory allocated to track memory regions. The precise performance impact depends on the workload and usually will not be significant.  

SEE ALSO

fork(2), wait(2), system(3), exec(3), ibv_get_device_list(3)  

AUTHORS

Dotan Barak <dotanba@gmail.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
NOTES
SEE ALSO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 21:48:05 GMT, April 16, 2011