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

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

Version: -  FREEBSD  -  FREEBSD10  -  FREEBSD9  -  FREEBSD92  -  FREEBSD91  -  FREEBSD90  -  FREEBSD8  -  FREEBSD82  -  FREEBSD81  -  FREEBSD80  -  FREEBSD7  -  FREEBSD74  -  FREEBSD73  -  FREEBSD72  -  FREEBSD71  -  FREEBSD70  -  FREEBSD6  -  FREEBSD64  -  FREEBSD63  -  FREEBSD62  -  FREEBSD61  -  FREEBSD60  -  FREEBSD5  -  FREEBSD55  -  FREEBSD54  -  FREEBSD53  -  FREEBSD52  -  FREEBSD51  -  FREEBSD50  -  FREEBSD4  -  FREEBSD3  -  FREEBSD22  -  cheribsd  -  linux-2.6  -  linux-2.4.22  -  MK83  -  MK84  -  PLAN9  -  DFBSD  -  NETBSD  -  NETBSD5  -  NETBSD4  -  NETBSD3  -  NETBSD20  -  OPENBSD  -  xnu-517  -  xnu-792  -  xnu-792.6.70  -  xnu-1228  -  xnu-1456.1.26  -  xnu-1699.24.8  -  xnu-2050.18.24  -  OPENSOLARIS  -  minix-3-1-1  -  FREEBSD-LIBC  -  FREEBSD8-LIBC  -  FREEBSD7-LIBC  -  FREEBSD6-LIBC  -  GLIBC27 
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:       task_assign.man,v $
   29 .\" Revision 2.5  93/03/18  15:14:41  mrt
   30 .\"     corrected types
   31 .\"     [93/03/12  16:51:54  lli]
   32 .\" 
   33 .\" Revision 2.4  91/05/14  17:12:18  mrt
   34 .\"     Correcting copyright
   35 .\" 
   36 .\" Revision 2.3  91/02/14  14:14:26  mrt
   37 .\"     Changed to new Mach copyright
   38 .\"     [91/02/12  18:15:16  mrt]
   39 .\" 
   40 .\" Revision 2.2  90/08/07  18:43:23  rpd
   41 .\"     Created.
   42 .\" 
   43 .TH task_assign 2 8/13/89
   44 .CM 4
   45 .SH NAME
   46 .nf
   47 task_assign  \-  assign task to processor set
   48 task_assign_default  \-  assign task to default processor set
   49 task_get_assignment  \-  get processor set to which task is assigned
   50 .SH SYNOPSIS
   51 .nf
   52 .ft B
   53 #include <mach.h>
   54 
   55 .nf
   56 .ft B
   57 kern_return_t
   58 task_assign(task, processor_set, assign_threads)
   59         mach_port_t task;
   60         mach_port_t processor_set;
   61         boolean_t       assign_threads;
   62 
   63 
   64 .fi
   65 .ft P
   66 .nf
   67 .ft B
   68 kern_return_t
   69 task_assign_default(task, assign_threads)
   70         mach_port_t     task;
   71         boolean_t       assign_threads;
   72 
   73 
   74 .fi
   75 .ft P
   76 .nf
   77 .ft B
   78 kern_return_t
   79 task_get_assignment(task, processor_set)
   80         mach_port_t             task;
   81         mach_port_t     *processor_set;
   82 
   83 
   84 .fi
   85 .ft P
   86 .SH ARGUMENTS
   87 .TP 15
   88 .B
   89 task
   90 The task to be affected.
   91 .TP 15
   92 .B
   93 processor_set
   94 The processor set to assign it to, or the processor 
   95 set to which it is assigned.
   96 .TP 15
   97 .B
   98 assign_threads
   99 Boolean indicating whether this assignment applies 
  100 to existing threads in the task.
  101 
  102 .SH DESCRIPTION
  103 .B task_assign
  104 assigns 
  105 .B task
  106 the the set 
  107 .B processor_set.
  108 This assignment is for the purposes of determining the initial assignment
  109 of newly created threads in 
  110 .B task.
  111 Any previous assignment of
  112 the task is nullified.  Existing threads within the task are also reassigned
  113 if 
  114 .B assign_threads
  115 is TRUE.  They are not affected if it is FALSE.
  116 
  117 .B task_assign_default
  118 is a variant of 
  119 .B task_assign
  120 that assigns the task to the default processor set on that task's host.
  121 This variant exists
  122 because the control port for the default processor set is privileged and
  123 not ususally available to users.
  124 
  125 
  126 .B task_get_assignment
  127 returns the current assignment of the task.
  128 
  129 .SH DIAGNOSTICS
  130 .TP 25
  131 KERN_SUCCESS
  132 The assignment has been performed.
  133 .TP 25
  134 KERN_INVALID_ARGUMENT
  135 .B task
  136 is not a task, or
  137 .B processor_set
  138 is not a processor_set on the same host as
  139 .B task
  140 .
  141 
  142 .SH BUGS
  143 Availability limited
  144 
  145 .SH SEE ALSO
  146 .B processor_set_create, processor_set_info, processor_assign, thread_assign
  147 ,
  148 .B host_processor_set_priv
  149 

Cache object: af1de9ff103069bd3677792c546d24e2


[ 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.