The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/man/mach_task_self.man

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 .\" 
    2 .\" Mach Operating System
    3 .\" Copyright (c) 1991,1990 Carnegie Mellon University
    4 .\" All Rights Reserved.
    5 .\" 
    6 .\" Permission to use, copy, modify and distribute this software and its
    7 .\" documentation is hereby granted, provided that both the copyright
    8 .\" notice and this permission notice appear in all copies of the
    9 .\" software, derivative works or modified versions, and any portions
   10 .\" thereof, and that both notices appear in supporting documentation.
   11 .\" 
   12 .\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
   13 .\" CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
   14 .\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
   15 .\" 
   16 .\" Carnegie Mellon requests users of this software to return to
   17 .\" 
   18 .\"  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
   19 .\"  School of Computer Science
   20 .\"  Carnegie Mellon University
   21 .\"  Pittsburgh PA 15213-3890
   22 .\" 
   23 .\" any improvements or extensions that they make and grant Carnegie Mellon
   24 .\" the rights to redistribute these changes.
   25 .\" 
   26 .\" 
   27 .\" HISTORY
   28 .\" $Log:       mach_task_self.man,v $
   29 .\" Revision 2.4  91/05/14  17:08:14  mrt
   30 .\"     Correcting copyright
   31 .\" 
   32 .\" Revision 2.3  91/02/14  14:12:21  mrt
   33 .\"     Changed to new Mach copyright
   34 .\"     [91/02/12  18:12:34  mrt]
   35 .\" 
   36 .\" Revision 2.2  90/08/07  18:38:52  rpd
   37 .\"     Created.
   38 .\" 
   39 .TH mach_task_self 2 9/19/86
   40 .CM 4
   41 .SH NAME
   42 .nf
   43 mach_task_self \- return calling thread's task port
   44 .SH SYNOPSIS
   45 .nf
   46 .ft B
   47 #include <mach/mach_traps.h>
   48 
   49 mach_port_t mach_task_self();
   50 .fi
   51 .ft P
   52 .SH DESCRIPTION
   53 The \fBmach_task_self\fR system call returns the calling thread's task port.
   54 
   55 \fBmach_task_self\fR has an effect equivalent to receiving
   56 a send right for the task port.  \fBmach_task_self\fR
   57 returns the name of the send right.  In particular,
   58 successive calls will increase the calling task's
   59 user-reference count for the send right.
   60 .SH DIAGNOSTICS
   61 .TP 25
   62 MACH_PORT_NULL
   63 A resource shortage prevented the reception of the send right.
   64 .TP 25
   65 MACH_PORT_NULL
   66 The task port is currently null.
   67 .TP 25
   68 MACH_PORT_DEAD
   69 The task port is currently dead.
   70 .SH SEE ALSO
   71 mach_thread_self(2), task_special_ports(2).
   72 .SH BUGS
   73 The file <mach_init.h> redefines \fBmach_task_self\fR
   74 to be a macro returning the value of a global variable.
   75 Before \fBmain\fR is called, libmach code uses the
   76 \fBmach_task_self\fR system call to initialize the global variable.

Cache object: e4cc7790d43f233efb7ac78a216b079d


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.