Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20652 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

tnfctl_kernel_open(3TNF)     TNF Library Functions    tnfctl_kernel_open(3TNF)

NAME
       tnfctl_kernel_open - create handle for kernel probe control

SYNOPSIS
       cc [ flag ... ] file ... -ltnfctl [ library ... ]
       #include <tnf/tnfctl.h>

       tnfctl_errcode_t tnfctl_kernel_open(tnfctl_handle_t **ret_val);

DESCRIPTION
       tnfctl_kernel_open()  starts  a	kernel	tracing session and returns in
       ret_val an opaque handle that can be used to control tracing and probes
       in  the	kernel.	 Only one kernel tracing session is possible at a time
       on a given machine.  An error code of  TNFCTL_ERR_BUSY is  returned  if
       there is another process using kernel tracing.
	Use the command

       fuser -f /dev/tnfctl

       to  print the process id of the process currently using kernel tracing.
       Only a  superuser  may  use  tnfctl_kernel_open().  An  error  code  of
       TNFCTL_ERR_ACCES	 is returned if the caller does not have the necessary
       privileges.

RETURN VALUES
       tnfctl_kernel_open returns TNFCTL_ERR_NONE upon success.

ERRORS
       TNFCTL_ERR_ACCES		       Permission  denied.   Superuser	privi‐
				       leges are needed for kernel tracing.

       TNFCTL_ERR_BUSY		       Another	client is currently using ker‐
				       nel tracing.

       TNFCTL_ERR_ALLOCFAIL	       Memory allocation failed.

       TNFCTL_ERR_FILENOTFOUND	       /dev/tnfctl not found.

       TNFCTL_ERR_INTERNAL	       Some other failure occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWtnfc			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       prex(1), fuser(1M),  TNF_PROBE(3TNF),  libtnfctl(3TNF),	tracing(3TNF),
       tnf_kernel_probes (4), attributes(5)

SunOS 5.10			  4 Mar 1997	      tnfctl_kernel_open(3TNF)

Vote for polarhome