summaryrefslogtreecommitdiff
path: root/doc/mach.info-2
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mach.info-2')
-rw-r--r--doc/mach.info-21663
1 files changed, 0 insertions, 1663 deletions
diff --git a/doc/mach.info-2 b/doc/mach.info-2
deleted file mode 100644
index 806539f..0000000
--- a/doc/mach.info-2
+++ /dev/null
@@ -1,1663 +0,0 @@
-This is ../doc/mach.info, produced by makeinfo version 4.8 from
-../doc/mach.texi.
-
-INFO-DIR-SECTION Kernel
-START-INFO-DIR-ENTRY
-* GNUMach: (mach). Using and programming the GNU Mach microkernel.
-END-INFO-DIR-ENTRY
-
- This file documents the GNU Mach microkernel.
-
- This is Edition 0.4, last updated 2001-09-01, of `The GNU Mach
-Reference Manual', for Version 1.3.99.
-
- Copyright (C) 2001 Free Software Foundation, Inc.
-
- Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being "Free Software Needs Free Documentation" and
-"GNU Lesser General Public License", the Front-Cover texts being (a)
-(see below), and with the Back-Cover Texts being (b) (see below). A
-copy of the license is included in the section entitled "GNU Free
-Documentation License".
-
- (a) The FSF's Front-Cover Text is:
-
- A GNU Manual
-
- (b) The FSF's Back-Cover Text is:
-
- You have freedom to copy and modify this GNU Manual, like GNU
-software. Copies published by the Free Software Foundation raise
-funds for GNU development.
-
- This work is based on manual pages under the following copyright and
-license:
-
-Mach Operating System
-Copyright (C) 1991,1990 Carnegie Mellon University
-All Rights Reserved.
-
- Permission to use, copy, modify and distribute this software and its
-documentation is hereby granted, provided that both the copyright
-notice and this permission notice appear in all copies of the software,
-derivative works or modified versions, and any portions thereof, and
-that both notices appear in supporting documentation.
-
- CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
-CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR ANY
-DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
-
-
-File: mach.info, Node: Commands, Next: Variables, Prev: Operation, Up: Kernel Debugger
-
-11.2 Commands
-=============
-
-`examine(x) [/MODIFIER] ADDR[,COUNT] [ THREAD ]'
- Display the addressed locations according to the formats in the
- modifier. Multiple modifier formats display multiple locations.
- If no format is specified, the last formats specified for this
- command is used. Address space other than that of the current
- thread can be specified with `t' option in the modifier and THREAD
- parameter. The format characters are
-
- `b'
- look at by bytes(8 bits)
-
- `h'
- look at by half words(16 bits)
-
- `l'
- look at by long words(32 bits)
-
- `a'
- print the location being displayed
-
- `,'
- skip one unit producing no output
-
- `A'
- print the location with a line number if possible
-
- `x'
- display in unsigned hex
-
- `z'
- display in signed hex
-
- `o'
- display in unsigned octal
-
- `d'
- display in signed decimal
-
- `u'
- display in unsigned decimal
-
- `r'
- display in current radix, signed
-
- `c'
- display low 8 bits as a character. Non-printing characters
- are displayed as an octal escape code (e.g. '\000').
-
- `s'
- display the null-terminated string at the location.
- Non-printing characters are displayed as octal escapes.
-
- `m'
- display in unsigned hex with character dump at the end of
- each line. The location is also displayed in hex at the
- beginning of each line.
-
- `i'
- display as an instruction
-
- `I'
- display as an instruction with possible alternate formats
- depending on the machine:
-
- `vax'
- don't assume that each external label is a procedure
- entry mask
-
- `i386'
- don't round to the next long word boundary
-
- `mips'
- print register contents
-
-`xf'
- Examine forward. It executes an examine command with the last
- specified parameters to it except that the next address displayed
- by it is used as the start address.
-
-`xb'
- Examine backward. It executes an examine command with the last
- specified parameters to it except that the last start address
- subtracted by the size displayed by it is used as the start
- address.
-
-`print[/axzodurc] ADDR1 [ ADDR2 ... ]'
- Print ADDR's according to the modifier character. Valid formats
- are: `a' `x' `z' `o' `d' `u' `r' `c'. If no modifier is
- specified, the last one specified to it is used. ADDR can be a
- string, and it is printed as it is. For example,
-
- print/x "eax = " $eax "\necx = " $ecx "\n"
-
- will print like
-
- eax = xxxxxx
- ecx = yyyyyy
-
-`write[/bhlt] ADDR [ THREAD ] EXPR1 [ EXPR2 ... ]'
- Write the expressions at succeeding locations. The write unit
- size can be specified in the modifier with a letter b (byte), h
- (half word) or l(long word) respectively. If omitted, long word
- is assumed. Target address space can also be specified with `t'
- option in the modifier and THREAD parameter. Warning: since there
- is no delimiter between expressions, strange things may happen.
- It's best to enclose each expression in parentheses.
-
-`set $VARIABLE [=] EXPR'
- Set the named variable or register with the value of EXPR. Valid
- variable names are described below.
-
-`break[/tuTU] ADDR[,COUNT] [ THREAD1 ... ]'
- Set a break point at ADDR. If count is supplied, continues
- (COUNT-1) times before stopping at the break point. If the break
- point is set, a break point number is printed with `#'. This
- number can be used in deleting the break point or adding
- conditions to it.
-
- `t'
- Set a break point only for a specific thread. The thread is
- specified by THREAD parameter, or default one is used if the
- parameter is omitted.
-
- `u'
- Set a break point in user space address. It may be combined
- with `t' or `T' option to specify the non-current target user
- space. Without `u' option, the address is considered in the
- kernel space, and wrong space address is rejected with an
- error message. This option can be used only if it is
- supported by machine dependent routines.
-
- `T'
- Set a break point only for threads in a specific task. It is
- like `t' option except that the break point is valid for all
- threads which belong to the same task as the specified target
- thread.
-
- `U'
- Set a break point in shared user space address. It is like
- `u' option, except that the break point is valid for all
- threads which share the same address space even if `t' option
- is specified. `t' option is used only to specify the target
- shared space. Without `t' option, `u' and `U' have the same
- meanings. `U' is useful for setting a user space break point
- in non-current address space with `t' option such as in an
- emulation library space. This option can be used only if it
- is supported by machine dependent routines.
-
- Warning: if a user text is shadowed by a normal user space
- debugger, user space break points may not work correctly. Setting
- a break point at the low-level code paths may also cause strange
- behavior.
-
-`delete[/tuTU] ADDR|#NUMBER [ THREAD1 ... ]'
- Delete the break point. The target break point can be specified
- by a break point number with `#', or by ADDR like specified in
- `break' command.
-
-`cond #NUMBER [ CONDITION COMMANDS ]'
- Set or delete a condition for the break point specified by the
- NUMBER. If the CONDITION and COMMANDS are null, the condition is
- deleted. Otherwise the condition is set for it. When the break
- point is hit, the CONDITION is evaluated. The COMMANDS will be
- executed if the condition is true and the break point count set by
- a break point command becomes zero. COMMANDS is a list of
- commands separated by semicolons. Each command in the list is
- executed in that order, but if a `continue' command is executed,
- the command execution stops there, and the stopped thread resumes
- execution. If the command execution reaches the end of the list,
- and it enters into a command input mode. For example,
-
- set $work0 0
- break/Tu xxx_start $task7.0
- cond #1 (1) set $work0 1; set $work1 0; cont
- break/T vm_fault $task7.0
- cond #2 ($work0) set $work1 ($work1+1); cont
- break/Tu xxx_end $task7.0
- cond #3 ($work0) print $work1 " faults\n"; set $work0 0
- cont
-
- will print page fault counts from `xxx_start' to `xxx_end' in
- `task7'.
-
-`step[/p] [,COUNT]'
- Single step COUNT times. If `p' option is specified, print each
- instruction at each step. Otherwise, only print the last
- instruction.
-
- Warning: depending on machine type, it may not be possible to
- single-step through some low-level code paths or user space code.
- On machines with software-emulated single-stepping (e.g., pmax),
- stepping through code executed by interrupt handlers will probably
- do the wrong thing.
-
-`continue[/c]'
- Continue execution until a breakpoint or watchpoint. If `/c',
- count instructions while executing. Some machines (e.g., pmax)
- also count loads and stores.
-
- Warning: when counting, the debugger is really silently
- single-stepping. This means that single-stepping on low-level
- code may cause strange behavior.
-
-`until'
- Stop at the next call or return instruction.
-
-`next[/p]'
- Stop at the matching return instruction. If `p' option is
- specified, print the call nesting depth and the cumulative
- instruction count at each call or return. Otherwise, only print
- when the matching return is hit.
-
-`match[/p]'
- A synonym for `next'.
-
-`trace[/tu] [ FRAME_ADDR|THREAD ][,COUNT]'
- Stack trace. `u' option traces user space; if omitted, only traces
- kernel space. If `t' option is specified, it shows the stack trace
- of the specified thread or a default target thread. Otherwise, it
- shows the stack trace of the current thread from the frame address
- specified by a parameter or from the current frame. COUNT is the
- number of frames to be traced. If the COUNT is omitted, all
- frames are printed.
-
- Warning: If the target thread's stack is not in the main memory at
- that time, the stack trace will fail. User space stack trace is
- valid only if the machine dependent code supports it.
-
-`search[/bhl] ADDR VALUE [MASK] [,COUNT]'
- Search memory for a value. This command might fail in interesting
- ways if it doesn't find the searched-for value. This is because
- `ddb' doesn't always recover from touching bad memory. The
- optional count argument limits the search.
-
-`macro NAME COMMANDS'
- Define a debugger macro as NAME. COMMANDS is a list of commands
- to be associated with the macro. In the expressions of the
- command list, a variable `$argxx' can be used to get a parameter
- passed to the macro. When a macro is called, each argument is
- evaluated as an expression, and the value is assigned to each
- parameter, `$arg1', `$arg2', ... respectively. 10 `$arg'
- variables are reserved to each level of macros, and they can be
- used as local variables. The nesting of macro can be allowed up
- to 5 levels. For example,
-
- macro xinit set $work0 $arg1
- macro xlist examine/m $work0,4; set $work0 *($work0)
- xinit *(xxx_list)
- xlist
- ....
-
- will print the contents of a list starting from `xxx_list' by each
- `xlist' command.
-
-`dmacro NAME'
- Delete the macro named NAME.
-
-`show all threads[/ul]'
- Display all tasks and threads information. This version of `ddb'
- prints more information than previous one. It shows UNIX process
- information like `ps' for each task. The UNIX process information
- may not be shown if it is not supported in the machine, or the
- bottom of the stack of the target task is not in the main memory at
- that time. It also shows task and thread identification numbers.
- These numbers can be used to specify a task or a thread
- symbolically in various commands. The numbers are valid only in
- the same debugger session. If the execution is resumed again, the
- numbers may change. The current thread can be distinguished from
- others by a `#' after the thread id instead of `:'. Without `l'
- option, it only shows thread id, thread structure address and the
- status for each thread. The status consists of 5 letters, R(run),
- W(wait), S(sus­ pended), O(swapped out) and N(interruptible), and
- if corresponding status bit is off, `.' is printed instead. If
- `l' option is specified, more detail information is printed for
- each thread.
-
-`show task [ ADDR ]'
- Display the information of a task specified by ADDR. If ADDR is
- omitted, current task information is displayed.
-
-`show thread [ ADDR ]'
- Display the information of a thread specified by ADDR. If ADDR is
- omitted, current thread information is displayed.
-
-`show registers[/tu [ THREAD ]]'
- Display the register set. Target thread can be specified with `t'
- option and THREAD parameter. If `u' option is specified, it
- displays user registers instead of kernel or currently saved one.
-
- Warning: The support of `t' and `u' option depends on the machine.
- If not supported, incorrect information will be displayed.
-
-`show map ADDR'
- Prints the `vm_map' at ADDR.
-
-`show object ADDR'
- Prints the `vm_object' at ADDR.
-
-`show page ADDR'
- Prints the `vm_page' structure at ADDR.
-
-`show port ADDR'
- Prints the `ipc_port' structure at ADDR.
-
-`show ipc_port[/t [ THREAD ]]'
- Prints all `ipc_port' structure's addresses the target thread has.
- The target thread is a current thread or that specified by a
- parameter.
-
-`show macro [ NAME ]'
- Show the definitions of macros. If NAME is specified, only the
- definition of it is displayed. Otherwise, definitions of all
- macros are displayed.
-
-`show watches'
- Displays all watchpoints.
-
-`watch[/T] ADDR,SIZE [ TASK ]'
- Set a watchpoint for a region. Execution stops when an attempt to
- modify the region occurs. The SIZE argument defaults to 4.
- Without `T' option, ADDR is assumed to be a kernel address. If
- you want to set a watch point in user space, specify `T' and TASK
- parameter where the address belongs to. If the TASK parameter is
- omitted, a task of the default target thread or a current task is
- assumed. If you specify a wrong space address, the request is
- rejected with an error message.
-
- Warning: Attempts to watch wired kernel memory may cause
- unrecoverable error in some systems such as i386. Watchpoints on
- user addresses work best.
-
-
-File: mach.info, Node: Variables, Next: Expressions, Prev: Commands, Up: Kernel Debugger
-
-11.3 Variables
-==============
-
-The debugger accesses registers and variables as $NAME. Register names
-are as in the `show registers' command. Some variables are suffixed
-with numbers, and may have some modifier following a colon immediately
-after the variable name. For example, register variables can have `u'
-and `t' modifier to indicate user register and that of a default target
-thread instead of that of the current thread (e.g. `$eax:tu').
-
- Built-in variables currently supported are:
-
-`taskXX[.YY]'
- Task or thread structure address. XX and YY are task and thread
- identification numbers printed by a `show all threads' command
- respectively. This variable is read only.
-
-`thread'
- The default target thread. The value is used when `t' option is
- specified without explicit thread structure address parameter in
- command lines or expression evaluation.
-
-`radix'
- Input and output radix
-
-`maxoff'
- Addresses are printed as SYMBOL+OFFSET unless offset is greater
- than maxoff.
-
-`maxwidth'
- The width of the displayed line.
-
-`lines'
- The number of lines. It is used by `more' feature.
-
-`tabstops'
- Tab stop width.
-
-`argXX'
- Parameters passed to a macro. XX can be 1 to 10.
-
-`workXX'
- Work variable. XX can be 0 to 31.
-
-
-File: mach.info, Node: Expressions, Prev: Variables, Up: Kernel Debugger
-
-11.4 Expressions
-================
-
-Almost all expression operators in C are supported except `~', `^', and
-unary `&'. Special rules in `ddb' are:
-
-`IDENTIFIER'
- name of a symbol. It is translated to the address(or value) of it.
- `.' and `:' can be used in the identifier. If supported by an
- object format dependent routine, [FILE_NAME:]FUNC[:LINE_NUMBER]
- [FILE_NAME:]VARIABLE, and FILE_NAME[:LINE_NUMBER] can be accepted
- as a symbol. The symbol may be prefixed with
- `SYMBOL_TABLE_NAME::' like `emulator::mach_msg_trap' to specify
- other than kernel symbols.
-
-`NUMBER'
- radix is determined by the first two letters:
- `0x'
- hex
-
- `0o'
- octal
-
- `0t'
- decimal
-
- otherwise, follow current radix.
-
-`.'
- dot
-
-`+'
- next
-
-`..'
- address of the start of the last line examined. Unlike dot or
- next, this is only changed by `examine' or `write' command.
-
-`´'
- last address explicitly specified.
-
-`$VARIABLE'
- register name or variable. It is translated to the value of it.
- It may be followed by a `:' and modifiers as described above.
-
-`a'
- multiple of right hand side.
-
-`*EXPR'
- indirection. It may be followed by a `:' and modifiers as
- described above.
-
-
-File: mach.info, Node: Copying, Next: Documentation License, Prev: Kernel Debugger, Up: Top
-
-Appendix A GNU GENERAL PUBLIC LICENSE
-*************************************
-
- Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
- 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
-
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-A.0.1 Preamble
---------------
-
-The licenses for most software are designed to take away your freedom
-to share and change it. By contrast, the GNU General Public License is
-intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users. This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it. (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.) You can apply it to
-your programs, too.
-
- When we speak of free software, we are referring to freedom, not
-price. Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it in
-new free programs; and that you know you can do these things.
-
- To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
- For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have. You must make sure that they, too, receive or can get the
-source code. And you must show them these terms so they know their
-rights.
-
- We protect your rights with two steps: (1) copyright the software,
-and (2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
- Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software. If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
- Finally, any free program is threatened constantly by software
-patents. We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary. To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
- The precise terms and conditions for copying, distribution and
-modification follow.
-
- TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
- 1. This License applies to any program or other work which contains a
- notice placed by the copyright holder saying it may be distributed
- under the terms of this General Public License. The "Program",
- below, refers to any such program or work, and a "work based on
- the Program" means either the Program or any derivative work under
- copyright law: that is to say, a work containing the Program or a
- portion of it, either verbatim or with modifications and/or
- translated into another language. (Hereinafter, translation is
- included without limitation in the term "modification".) Each
- licensee is addressed as "you".
-
- Activities other than copying, distribution and modification are
- not covered by this License; they are outside its scope. The act
- of running the Program is not restricted, and the output from the
- Program is covered only if its contents constitute a work based on
- the Program (independent of having been made by running the
- Program). Whether that is true depends on what the Program does.
-
- 2. You may copy and distribute verbatim copies of the Program's
- source code as you receive it, in any medium, provided that you
- conspicuously and appropriately publish on each copy an appropriate
- copyright notice and disclaimer of warranty; keep intact all the
- notices that refer to this License and to the absence of any
- warranty; and give any other recipients of the Program a copy of
- this License along with the Program.
-
- You may charge a fee for the physical act of transferring a copy,
- and you may at your option offer warranty protection in exchange
- for a fee.
-
- 3. You may modify your copy or copies of the Program or any portion
- of it, thus forming a work based on the Program, and copy and
- distribute such modifications or work under the terms of Section 1
- above, provided that you also meet all of these conditions:
-
- a. You must cause the modified files to carry prominent notices
- stating that you changed the files and the date of any change.
-
- b. You must cause any work that you distribute or publish, that
- in whole or in part contains or is derived from the Program
- or any part thereof, to be licensed as a whole at no charge
- to all third parties under the terms of this License.
-
- c. If the modified program normally reads commands interactively
- when run, you must cause it, when started running for such
- interactive use in the most ordinary way, to print or display
- an announcement including an appropriate copyright notice and
- a notice that there is no warranty (or else, saying that you
- provide a warranty) and that users may redistribute the
- program under these conditions, and telling the user how to
- view a copy of this License. (Exception: if the Program
- itself is interactive but does not normally print such an
- announcement, your work based on the Program is not required
- to print an announcement.)
-
- These requirements apply to the modified work as a whole. If
- identifiable sections of that work are not derived from the
- Program, and can be reasonably considered independent and separate
- works in themselves, then this License, and its terms, do not
- apply to those sections when you distribute them as separate
- works. But when you distribute the same sections as part of a
- whole which is a work based on the Program, the distribution of
- the whole must be on the terms of this License, whose permissions
- for other licensees extend to the entire whole, and thus to each
- and every part regardless of who wrote it.
-
- Thus, it is not the intent of this section to claim rights or
- contest your rights to work written entirely by you; rather, the
- intent is to exercise the right to control the distribution of
- derivative or collective works based on the Program.
-
- In addition, mere aggregation of another work not based on the
- Program with the Program (or with a work based on the Program) on
- a volume of a storage or distribution medium does not bring the
- other work under the scope of this License.
-
- 4. You may copy and distribute the Program (or a work based on it,
- under Section 2) in object code or executable form under the terms
- of Sections 1 and 2 above provided that you also do one of the
- following:
-
- a. Accompany it with the complete corresponding machine-readable
- source code, which must be distributed under the terms of
- Sections 1 and 2 above on a medium customarily used for
- software interchange; or,
-
- b. Accompany it with a written offer, valid for at least three
- years, to give any third party, for a charge no more than your
- cost of physically performing source distribution, a complete
- machine-readable copy of the corresponding source code, to be
- distributed under the terms of Sections 1 and 2 above on a
- medium customarily used for software interchange; or,
-
- c. Accompany it with the information you received as to the offer
- to distribute corresponding source code. (This alternative is
- allowed only for noncommercial distribution and only if you
- received the program in object code or executable form with
- such an offer, in accord with Subsection b above.)
-
- The source code for a work means the preferred form of the work for
- making modifications to it. For an executable work, complete
- source code means all the source code for all modules it contains,
- plus any associated interface definition files, plus the scripts
- used to control compilation and installation of the executable.
- However, as a special exception, the source code distributed need
- not include anything that is normally distributed (in either
- source or binary form) with the major components (compiler,
- kernel, and so on) of the operating system on which the executable
- runs, unless that component itself accompanies the executable.
-
- If distribution of executable or object code is made by offering
- access to copy from a designated place, then offering equivalent
- access to copy the source code from the same place counts as
- distribution of the source code, even though third parties are not
- compelled to copy the source along with the object code.
-
- 5. You may not copy, modify, sublicense, or distribute the Program
- except as expressly provided under this License. Any attempt
- otherwise to copy, modify, sublicense or distribute the Program is
- void, and will automatically terminate your rights under this
- License. However, parties who have received copies, or rights,
- from you under this License will not have their licenses
- terminated so long as such parties remain in full compliance.
-
- 6. You are not required to accept this License, since you have not
- signed it. However, nothing else grants you permission to modify
- or distribute the Program or its derivative works. These actions
- are prohibited by law if you do not accept this License.
- Therefore, by modifying or distributing the Program (or any work
- based on the Program), you indicate your acceptance of this
- License to do so, and all its terms and conditions for copying,
- distributing or modifying the Program or works based on it.
-
- 7. Each time you redistribute the Program (or any work based on the
- Program), the recipient automatically receives a license from the
- original licensor to copy, distribute or modify the Program
- subject to these terms and conditions. You may not impose any
- further restrictions on the recipients' exercise of the rights
- granted herein. You are not responsible for enforcing compliance
- by third parties to this License.
-
- 8. If, as a consequence of a court judgment or allegation of patent
- infringement or for any other reason (not limited to patent
- issues), conditions are imposed on you (whether by court order,
- agreement or otherwise) that contradict the conditions of this
- License, they do not excuse you from the conditions of this
- License. If you cannot distribute so as to satisfy simultaneously
- your obligations under this License and any other pertinent
- obligations, then as a consequence you may not distribute the
- Program at all. For example, if a patent license would not permit
- royalty-free redistribution of the Program by all those who
- receive copies directly or indirectly through you, then the only
- way you could satisfy both it and this License would be to refrain
- entirely from distribution of the Program.
-
- If any portion of this section is held invalid or unenforceable
- under any particular circumstance, the balance of the section is
- intended to apply and the section as a whole is intended to apply
- in other circumstances.
-
- It is not the purpose of this section to induce you to infringe any
- patents or other property right claims or to contest validity of
- any such claims; this section has the sole purpose of protecting
- the integrity of the free software distribution system, which is
- implemented by public license practices. Many people have made
- generous contributions to the wide range of software distributed
- through that system in reliance on consistent application of that
- system; it is up to the author/donor to decide if he or she is
- willing to distribute software through any other system and a
- licensee cannot impose that choice.
-
- This section is intended to make thoroughly clear what is believed
- to be a consequence of the rest of this License.
-
- 9. If the distribution and/or use of the Program is restricted in
- certain countries either by patents or by copyrighted interfaces,
- the original copyright holder who places the Program under this
- License may add an explicit geographical distribution limitation
- excluding those countries, so that distribution is permitted only
- in or among countries not thus excluded. In such case, this
- License incorporates the limitation as if written in the body of
- this License.
-
- 10. The Free Software Foundation may publish revised and/or new
- versions of the General Public License from time to time. Such
- new versions will be similar in spirit to the present version, but
- may differ in detail to address new problems or concerns.
-
- Each version is given a distinguishing version number. If the
- Program specifies a version number of this License which applies
- to it and "any later version", you have the option of following
- the terms and conditions either of that version or of any later
- version published by the Free Software Foundation. If the Program
- does not specify a version number of this License, you may choose
- any version ever published by the Free Software Foundation.
-
- 11. If you wish to incorporate parts of the Program into other free
- programs whose distribution conditions are different, write to the
- author to ask for permission. For software which is copyrighted
- by the Free Software Foundation, write to the Free Software
- Foundation; we sometimes make exceptions for this. Our decision
- will be guided by the two goals of preserving the free status of
- all derivatives of our free software and of promoting the sharing
- and reuse of software generally.
-
- NO WARRANTY
- 12. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
- WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
- LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
- HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
- WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
- NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
- QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
- PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
- SERVICING, REPAIR OR CORRECTION.
-
- 13. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
- WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
- MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
- LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
- INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
- INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
- DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
- OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
- OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
- ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
- END OF TERMS AND CONDITIONS
-How to Apply These Terms to Your New Programs
-=============================================
-
-If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these
-terms.
-
- To do so, attach the following notices to the program. It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
- ONE LINE TO GIVE THE PROGRAM'S NAME AND AN IDEA OF WHAT IT DOES.
- Copyright (C) 19YY NAME OF AUTHOR
-
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- as published by the Free Software Foundation; either version 2
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-
- Also add information on how to contact you by electronic and paper
-mail.
-
- If the program is interactive, make it output a short notice like
-this when it starts in an interactive mode:
-
- Gnomovision version 69, Copyright (C) 19YY NAME OF AUTHOR
- Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
- type `show w'. This is free software, and you are welcome
- to redistribute it under certain conditions; type `show c'
- for details.
-
- The hypothetical commands `show w' and `show c' should show the
-appropriate parts of the General Public License. Of course, the
-commands you use may be called something other than `show w' and `show
-c'; they could even be mouse-clicks or menu items--whatever suits your
-program.
-
- You should also get your employer (if you work as a programmer) or
-your school, if any, to sign a "copyright disclaimer" for the program,
-if necessary. Here is a sample; alter the names:
-
- Yoyodyne, Inc., hereby disclaims all copyright
- interest in the program `Gnomovision'
- (which makes passes at compilers) written
- by James Hacker.
-
- SIGNATURE OF TY COON, 1 April 1989
- Ty Coon, President of Vice
-
- This General Public License does not permit incorporating your
-program into proprietary programs. If your program is a subroutine
-library, you may consider it more useful to permit linking proprietary
-applications with the library. If this is what you want to do, use the
-GNU Library General Public License instead of this License.
-
-
-File: mach.info, Node: Documentation License, Next: Concept Index, Prev: Copying, Up: Top
-
-Appendix B Documentation License
-********************************
-
-This manual is copyrighted and licensed under the GNU Free Documentation
-license.
-
- Parts of this manual are derived from the Mach manual packages
-originally provided by Carnegie Mellon University.
-
-* Menu:
-
-* Free Documentation License:: The GNU Free Documentation License.
-* CMU License:: The CMU license applies to the original Mach
- kernel and its documentation.
-
-
-File: mach.info, Node: Free Documentation License, Next: CMU License, Up: Documentation License
-
-B.1 GNU Free Documentation License
-==================================
-
- Version 1.1, March 2000
-
- Copyright (C) 2000 Free Software Foundation, Inc.
- 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
-
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
- 0. PREAMBLE
-
- The purpose of this License is to make a manual, textbook, or other
- written document "free" in the sense of freedom: to assure everyone
- the effective freedom to copy and redistribute it, with or without
- modifying it, either commercially or noncommercially. Secondarily,
- this License preserves for the author and publisher a way to get
- credit for their work, while not being considered responsible for
- modifications made by others.
-
- This License is a kind of "copyleft", which means that derivative
- works of the document must themselves be free in the same sense.
- It complements the GNU General Public License, which is a copyleft
- license designed for free software.
-
- We have designed this License in order to use it for manuals for
- free software, because free software needs free documentation: a
- free program should come with manuals providing the same freedoms
- that the software does. But this License is not limited to
- software manuals; it can be used for any textual work, regardless
- of subject matter or whether it is published as a printed book.
- We recommend this License principally for works whose purpose is
- instruction or reference.
-
- 1. APPLICABILITY AND DEFINITIONS
-
- This License applies to any manual or other work that contains a
- notice placed by the copyright holder saying it can be distributed
- under the terms of this License. The "Document", below, refers to
- any such manual or work. Any member of the public is a licensee,
- and is addressed as "you".
-
- A "Modified Version" of the Document means any work containing the
- Document or a portion of it, either copied verbatim, or with
- modifications and/or translated into another language.
-
- A "Secondary Section" is a named appendix or a front-matter
- section of the Document that deals exclusively with the
- relationship of the publishers or authors of the Document to the
- Document's overall subject (or to related matters) and contains
- nothing that could fall directly within that overall subject.
- (For example, if the Document is in part a textbook of
- mathematics, a Secondary Section may not explain any mathematics.)
- The relationship could be a matter of historical connection with
- the subject or with related matters, or of legal, commercial,
- philosophical, ethical or political position regarding them.
-
- The "Invariant Sections" are certain Secondary Sections whose
- titles are designated, as being those of Invariant Sections, in
- the notice that says that the Document is released under this
- License.
-
- The "Cover Texts" are certain short passages of text that are
- listed, as Front-Cover Texts or Back-Cover Texts, in the notice
- that says that the Document is released under this License.
-
- A "Transparent" copy of the Document means a machine-readable copy,
- represented in a format whose specification is available to the
- general public, whose contents can be viewed and edited directly
- and straightforwardly with generic text editors or (for images
- composed of pixels) generic paint programs or (for drawings) some
- widely available drawing editor, and that is suitable for input to
- text formatters or for automatic translation to a variety of
- formats suitable for input to text formatters. A copy made in an
- otherwise Transparent file format whose markup has been designed
- to thwart or discourage subsequent modification by readers is not
- Transparent. A copy that is not "Transparent" is called "Opaque".
-
- Examples of suitable formats for Transparent copies include plain
- ASCII without markup, Texinfo input format, LaTeX input format,
- SGML or XML using a publicly available DTD, and
- standard-conforming simple HTML designed for human modification.
- Opaque formats include PostScript, PDF, proprietary formats that
- can be read and edited only by proprietary word processors, SGML
- or XML for which the DTD and/or processing tools are not generally
- available, and the machine-generated HTML produced by some word
- processors for output purposes only.
-
- The "Title Page" means, for a printed book, the title page itself,
- plus such following pages as are needed to hold, legibly, the
- material this License requires to appear in the title page. For
- works in formats which do not have any title page as such, "Title
- Page" means the text near the most prominent appearance of the
- work's title, preceding the beginning of the body of the text.
-
- 2. VERBATIM COPYING
-
- You may copy and distribute the Document in any medium, either
- commercially or noncommercially, provided that this License, the
- copyright notices, and the license notice saying this License
- applies to the Document are reproduced in all copies, and that you
- add no other conditions whatsoever to those of this License. You
- may not use technical measures to obstruct or control the reading
- or further copying of the copies you make or distribute. However,
- you may accept compensation in exchange for copies. If you
- distribute a large enough number of copies you must also follow
- the conditions in section 3.
-
- You may also lend copies, under the same conditions stated above,
- and you may publicly display copies.
-
- 3. COPYING IN QUANTITY
-
- If you publish printed copies of the Document numbering more than
- 100, and the Document's license notice requires Cover Texts, you
- must enclose the copies in covers that carry, clearly and legibly,
- all these Cover Texts: Front-Cover Texts on the front cover, and
- Back-Cover Texts on the back cover. Both covers must also clearly
- and legibly identify you as the publisher of these copies. The
- front cover must present the full title with all words of the
- title equally prominent and visible. You may add other material
- on the covers in addition. Copying with changes limited to the
- covers, as long as they preserve the title of the Document and
- satisfy these conditions, can be treated as verbatim copying in
- other respects.
-
- If the required texts for either cover are too voluminous to fit
- legibly, you should put the first ones listed (as many as fit
- reasonably) on the actual cover, and continue the rest onto
- adjacent pages.
-
- If you publish or distribute Opaque copies of the Document
- numbering more than 100, you must either include a
- machine-readable Transparent copy along with each Opaque copy, or
- state in or with each Opaque copy a publicly-accessible
- computer-network location containing a complete Transparent copy
- of the Document, free of added material, which the general
- network-using public has access to download anonymously at no
- charge using public-standard network protocols. If you use the
- latter option, you must take reasonably prudent steps, when you
- begin distribution of Opaque copies in quantity, to ensure that
- this Transparent copy will remain thus accessible at the stated
- location until at least one year after the last time you
- distribute an Opaque copy (directly or through your agents or
- retailers) of that edition to the public.
-
- It is requested, but not required, that you contact the authors of
- the Document well before redistributing any large number of
- copies, to give them a chance to provide you with an updated
- version of the Document.
-
- 4. MODIFICATIONS
-
- You may copy and distribute a Modified Version of the Document
- under the conditions of sections 2 and 3 above, provided that you
- release the Modified Version under precisely this License, with
- the Modified Version filling the role of the Document, thus
- licensing distribution and modification of the Modified Version to
- whoever possesses a copy of it. In addition, you must do these
- things in the Modified Version:
-
- A. Use in the Title Page (and on the covers, if any) a title
- distinct from that of the Document, and from those of
- previous versions (which should, if there were any, be listed
- in the History section of the Document). You may use the
- same title as a previous version if the original publisher of
- that version gives permission.
-
- B. List on the Title Page, as authors, one or more persons or
- entities responsible for authorship of the modifications in
- the Modified Version, together with at least five of the
- principal authors of the Document (all of its principal
- authors, if it has less than five).
-
- C. State on the Title page the name of the publisher of the
- Modified Version, as the publisher.
-
- D. Preserve all the copyright notices of the Document.
-
- E. Add an appropriate copyright notice for your modifications
- adjacent to the other copyright notices.
-
- F. Include, immediately after the copyright notices, a license
- notice giving the public permission to use the Modified
- Version under the terms of this License, in the form shown in
- the Addendum below.
-
- G. Preserve in that license notice the full lists of Invariant
- Sections and required Cover Texts given in the Document's
- license notice.
-
- H. Include an unaltered copy of this License.
-
- I. Preserve the section entitled "History", and its title, and
- add to it an item stating at least the title, year, new
- authors, and publisher of the Modified Version as given on
- the Title Page. If there is no section entitled "History" in
- the Document, create one stating the title, year, authors,
- and publisher of the Document as given on its Title Page,
- then add an item describing the Modified Version as stated in
- the previous sentence.
-
- J. Preserve the network location, if any, given in the Document
- for public access to a Transparent copy of the Document, and
- likewise the network locations given in the Document for
- previous versions it was based on. These may be placed in
- the "History" section. You may omit a network location for a
- work that was published at least four years before the
- Document itself, or if the original publisher of the version
- it refers to gives permission.
-
- K. In any section entitled "Acknowledgments" or "Dedications",
- preserve the section's title, and preserve in the section all
- the substance and tone of each of the contributor
- acknowledgments and/or dedications given therein.
-
- L. Preserve all the Invariant Sections of the Document,
- unaltered in their text and in their titles. Section numbers
- or the equivalent are not considered part of the section
- titles.
-
- M. Delete any section entitled "Endorsements". Such a section
- may not be included in the Modified Version.
-
- N. Do not retitle any existing section as "Endorsements" or to
- conflict in title with any Invariant Section.
-
- If the Modified Version includes new front-matter sections or
- appendices that qualify as Secondary Sections and contain no
- material copied from the Document, you may at your option
- designate some or all of these sections as invariant. To do this,
- add their titles to the list of Invariant Sections in the Modified
- Version's license notice. These titles must be distinct from any
- other section titles.
-
- You may add a section entitled "Endorsements", provided it contains
- nothing but endorsements of your Modified Version by various
- parties--for example, statements of peer review or that the text
- has been approved by an organization as the authoritative
- definition of a standard.
-
- You may add a passage of up to five words as a Front-Cover Text,
- and a passage of up to 25 words as a Back-Cover Text, to the end
- of the list of Cover Texts in the Modified Version. Only one
- passage of Front-Cover Text and one of Back-Cover Text may be
- added by (or through arrangements made by) any one entity. If the
- Document already includes a cover text for the same cover,
- previously added by you or by arrangement made by the same entity
- you are acting on behalf of, you may not add another; but you may
- replace the old one, on explicit permission from the previous
- publisher that added the old one.
-
- The author(s) and publisher(s) of the Document do not by this
- License give permission to use their names for publicity for or to
- assert or imply endorsement of any Modified Version.
-
- 5. COMBINING DOCUMENTS
-
- You may combine the Document with other documents released under
- this License, under the terms defined in section 4 above for
- modified versions, provided that you include in the combination
- all of the Invariant Sections of all of the original documents,
- unmodified, and list them all as Invariant Sections of your
- combined work in its license notice.
-
- The combined work need only contain one copy of this License, and
- multiple identical Invariant Sections may be replaced with a single
- copy. If there are multiple Invariant Sections with the same name
- but different contents, make the title of each such section unique
- by adding at the end of it, in parentheses, the name of the
- original author or publisher of that section if known, or else a
- unique number. Make the same adjustment to the section titles in
- the list of Invariant Sections in the license notice of the
- combined work.
-
- In the combination, you must combine any sections entitled
- "History" in the various original documents, forming one section
- entitled "History"; likewise combine any sections entitled
- "Acknowledgments", and any sections entitled "Dedications". You
- must delete all sections entitled "Endorsements."
-
- 6. COLLECTIONS OF DOCUMENTS
-
- You may make a collection consisting of the Document and other
- documents released under this License, and replace the individual
- copies of this License in the various documents with a single copy
- that is included in the collection, provided that you follow the
- rules of this License for verbatim copying of each of the
- documents in all other respects.
-
- You may extract a single document from such a collection, and
- distribute it individually under this License, provided you insert
- a copy of this License into the extracted document, and follow
- this License in all other respects regarding verbatim copying of
- that document.
-
- 7. AGGREGATION WITH INDEPENDENT WORKS
-
- A compilation of the Document or its derivatives with other
- separate and independent documents or works, in or on a volume of
- a storage or distribution medium, does not as a whole count as a
- Modified Version of the Document, provided no compilation
- copyright is claimed for the compilation. Such a compilation is
- called an "aggregate", and this License does not apply to the
- other self-contained works thus compiled with the Document, on
- account of their being thus compiled, if they are not themselves
- derivative works of the Document.
-
- If the Cover Text requirement of section 3 is applicable to these
- copies of the Document, then if the Document is less than one
- quarter of the entire aggregate, the Document's Cover Texts may be
- placed on covers that surround only the Document within the
- aggregate. Otherwise they must appear on covers around the whole
- aggregate.
-
- 8. TRANSLATION
-
- Translation is considered a kind of modification, so you may
- distribute translations of the Document under the terms of section
- 4. Replacing Invariant Sections with translations requires special
- permission from their copyright holders, but you may include
- translations of some or all Invariant Sections in addition to the
- original versions of these Invariant Sections. You may include a
- translation of this License provided that you also include the
- original English version of this License. In case of a
- disagreement between the translation and the original English
- version of this License, the original English version will prevail.
-
- 9. TERMINATION
-
- You may not copy, modify, sublicense, or distribute the Document
- except as expressly provided for under this License. Any other
- attempt to copy, modify, sublicense or distribute the Document is
- void, and will automatically terminate your rights under this
- License. However, parties who have received copies, or rights,
- from you under this License will not have their licenses
- terminated so long as such parties remain in full compliance.
-
- 10. FUTURE REVISIONS OF THIS LICENSE
-
- The Free Software Foundation may publish new, revised versions of
- the GNU Free Documentation License from time to time. Such new
- versions will be similar in spirit to the present version, but may
- differ in detail to address new problems or concerns. See
- `http://www.gnu.org/copyleft/'.
-
- Each version of the License is given a distinguishing version
- number. If the Document specifies that a particular numbered
- version of this License "or any later version" applies to it, you
- have the option of following the terms and conditions either of
- that specified version or of any later version that has been
- published (not as a draft) by the Free Software Foundation. If
- the Document does not specify a version number of this License,
- you may choose any version ever published (not as a draft) by the
- Free Software Foundation.
-
-B.1.0.1 ADDENDUM: How to use this License for your documents
-............................................................
-
-To use this License in a document you have written, include a copy of
-the License in the document and put the following copyright and license
-notices just after the title page:
-
- Copyright (C) YEAR YOUR NAME.
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the GNU Free Documentation License, Version 1.1
- or any later version published by the Free Software Foundation;
- with the Invariant Sections being LIST THEIR TITLES, with the
- Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
- A copy of the license is included in the section entitled ``GNU
- Free Documentation License''.
-
- If you have no Invariant Sections, write "with no Invariant Sections"
-instead of saying which ones are invariant. If you have no Front-Cover
-Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being
-LIST"; likewise for Back-Cover Texts.
-
- If your document contains nontrivial examples of program code, we
-recommend releasing these examples in parallel under your choice of
-free software license, such as the GNU General Public License, to
-permit their use in free software.
-
-
-File: mach.info, Node: CMU License, Prev: Free Documentation License, Up: Documentation License
-
-B.2 CMU License
-===============
-
- Mach Operating System
- Copyright (C) 1991,1990,1989 Carnegie Mellon University
- All Rights Reserved.
-
- Permission to use, copy, modify and distribute this software and
- its documentation is hereby granted, provided that both the
- copyright notice and this permission notice appear in all copies
- of the software, derivative works or modified versions, and any
- portions thereof, and that both notices appear in supporting
- documentation.
-
- CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
- CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
- ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
-
- Carnegie Mellon requests users of this software to return to
-
- Software Distribution Coordinator
- School of Computer Science
- Carnegie Mellon University
- Pittsburgh PA 15213-3890
-
- or <Software.Distribution@CS.CMU.EDU> any improvements or
- extensions that they make and grant Carnegie Mellon the rights to
- redistribute these changes.
-
-
-File: mach.info, Node: Concept Index, Next: Function and Data Index, Prev: Documentation License, Up: Top
-
-Concept Index
-*************
-
-
-* Menu:
-
-* communication between tasks: Major Concepts. (line 6)
-* composing messages: Message Format. (line 6)
-* device port: Device Interface. (line 13)
-* FDL, GNU Free Documentation License: Free Documentation License.
- (line 6)
-* format of a message: Message Format. (line 6)
-* GPL, GNU General Public License: Copying. (line 6)
-* GRand Unified Bootloader: Bootloader. (line 13)
-* GRUB: Bootloader. (line 13)
-* host control port: Host Ports. (line 34)
-* host interface: Host Interface. (line 6)
-* host name port: Host Ports. (line 6)
-* host ports: Host Ports. (line 6)
-* interprocess communication (IPC): Major Concepts. (line 6)
-* IPC (interprocess communication): Major Concepts. (line 6)
-* IPC space port: Port Manipulation Interface.
- (line 9)
-* message composition: Message Format. (line 6)
-* message format: Message Format. (line 6)
-* messages: Major Concepts. (line 6)
-* moving port rights: Exchanging Port Rights.
- (line 6)
-* port representing a device: Device Interface. (line 13)
-* port representing a processor: Processor Interface. (line 6)
-* port representing a processor set name: Processor Set Ports. (line 6)
-* port representing a task: Task Interface. (line 6)
-* port representing a thread: Thread Interface. (line 6)
-* port representing a virtual memory map: Virtual Memory Interface.
- (line 6)
-* port representing an IPC space: Port Manipulation Interface.
- (line 9)
-* ports representing a host: Host Ports. (line 6)
-* ports representing a processor set: Processor Set Ports. (line 6)
-* processor port: Processor Interface. (line 6)
-* processor set name port: Processor Set Ports. (line 6)
-* processor set port: Processor Set Ports. (line 13)
-* processor set ports: Processor Set Ports. (line 6)
-* receiving memory: Memory. (line 6)
-* receiving port rights: Exchanging Port Rights.
- (line 6)
-* remote procedure calls (RPC): Major Concepts. (line 6)
-* RPC (remote procedure calls): Major Concepts. (line 6)
-* sending memory: Memory. (line 6)
-* sending messages: Message Send. (line 6)
-* sending port rights: Exchanging Port Rights.
- (line 6)
-* serverboot: Modules. (line 6)
-* task port: Task Interface. (line 6)
-* thread port: Thread Interface. (line 6)
-* virtual memory map port: Virtual Memory Interface.
- (line 6)
-
-
-File: mach.info, Node: Function and Data Index, Prev: Concept Index, Up: Top
-
-Function and Data Index
-***********************
-
-
-* Menu:
-
-* catch_exception_raise: Exceptions. (line 9)
-* device_close: Device Close. (line 7)
-* device_get_status: Device Status. (line 20)
-* device_map: Device Map. (line 9)
-* device_open: Device Open. (line 8)
-* device_open_request: Device Open. (line 36)
-* device_read: Device Read. (line 9)
-* device_read_inband: Device Read. (line 27)
-* device_read_request: Device Read. (line 34)
-* device_read_request_inband: Device Read. (line 51)
-* device_reply_server: Device Reply Server. (line 12)
-* device_set_filter: Device Filter. (line 10)
-* device_set_status: Device Status. (line 9)
-* device_t: Device Interface. (line 14)
-* device_write: Device Write. (line 9)
-* device_write_inband: Device Write. (line 24)
-* device_write_request: Device Write. (line 31)
-* device_write_request_inband: Device Write. (line 49)
-* ds_device_open_reply: Device Open. (line 39)
-* ds_device_read_reply: Device Read. (line 37)
-* ds_device_read_reply_inband: Device Read. (line 54)
-* ds_device_write_reply: Device Write. (line 34)
-* ds_device_write_reply_inband: Device Write. (line 52)
-* evc_wait: Exceptions. (line 18)
-* exception_raise: Exceptions. (line 15)
-* host_adjust_time: Host Time. (line 43)
-* host_basic_info_t: Host Information. (line 75)
-* host_get_boot_info: Host Information. (line 114)
-* host_get_time: Host Time. (line 34)
-* host_info: Host Information. (line 9)
-* host_kernel_version: Host Information. (line 96)
-* host_priv_t: Host Ports. (line 35)
-* host_processor_set_priv: Processor Set Access.
- (line 25)
-* host_processor_sets: Processor Set Access.
- (line 9)
-* host_processors: Hosted Processors. (line 9)
-* host_reboot: Host Reboot. (line 8)
-* host_sched_info_t: Host Information. (line 92)
-* host_set_time: Host Time. (line 39)
-* host_t: Host Ports. (line 7)
-* ipc_space_t: Port Manipulation Interface.
- (line 10)
-* mach_host_self: Host Ports. (line 14)
-* mach_msg: Mach Message Call. (line 13)
-* mach_msg_bits_t: Message Format. (line 21)
-* mach_msg_header_t: Message Format. (line 33)
-* mach_msg_id_t: Message Format. (line 29)
-* mach_msg_size_t: Message Format. (line 25)
-* mach_msg_timeout_t: Mach Message Call. (line 61)
-* mach_msg_type_long_t: Message Format. (line 248)
-* mach_msg_type_name_t: Message Format. (line 128)
-* mach_msg_type_number_t: Message Format. (line 138)
-* MACH_MSG_TYPE_PORT_ANY: Message Format. (line 234)
-* MACH_MSG_TYPE_PORT_ANY_RIGHT: Message Format. (line 244)
-* MACH_MSG_TYPE_PORT_ANY_SEND: Message Format. (line 239)
-* mach_msg_type_size_t: Message Format. (line 133)
-* mach_msg_type_t: Message Format. (line 143)
-* MACH_MSGH_BITS: Message Format. (line 96)
-* MACH_MSGH_BITS_LOCAL: Message Format. (line 108)
-* MACH_MSGH_BITS_OTHER: Message Format. (line 117)
-* MACH_MSGH_BITS_PORTS: Message Format. (line 112)
-* MACH_MSGH_BITS_REMOTE: Message Format. (line 103)
-* mach_port_allocate: Port Creation. (line 8)
-* mach_port_allocate_name: Port Creation. (line 66)
-* mach_port_deallocate: Port Destruction. (line 8)
-* mach_port_destroy: Port Destruction. (line 30)
-* mach_port_extract_right: Ports and other Tasks.
- (line 59)
-* mach_port_get_receive_status: Receive Rights. (line 57)
-* mach_port_get_refs: Port Rights. (line 9)
-* mach_port_get_set_status: Port Sets. (line 9)
-* mach_port_insert_right: Ports and other Tasks.
- (line 9)
-* mach_port_mod_refs: Port Rights. (line 42)
-* mach_port_move_member: Port Sets. (line 28)
-* mach_port_mscount_t: Receive Rights. (line 11)
-* mach_port_msgcount_t: Receive Rights. (line 15)
-* mach_port_names: Port Names. (line 9)
-* mach_port_rename: Port Names. (line 77)
-* mach_port_request_notification: Request Notifications.
- (line 10)
-* mach_port_rights_t: Receive Rights. (line 19)
-* mach_port_seqno_t: Receive Rights. (line 7)
-* mach_port_set_mscount: Receive Rights. (line 73)
-* mach_port_set_qlimit: Receive Rights. (line 90)
-* mach_port_set_seqno: Receive Rights. (line 108)
-* mach_port_status_t: Receive Rights. (line 23)
-* mach_port_t: Message Format. (line 14)
-* mach_port_type: Port Names. (line 35)
-* mach_reply_port: Port Creation. (line 48)
-* mach_task_self: Task Information. (line 7)
-* mach_thread_self: Thread Information. (line 7)
-* mapped_time_value_t: Host Time. (line 51)
-* memory_object_change_attributes: Memory Object Attributes.
- (line 30)
-* memory_object_change_completed: Memory Object Attributes.
- (line 63)
-* memory_object_copy: Memory Objects and Data.
- (line 209)
-* memory_object_create: Default Memory Manager.
- (line 30)
-* memory_object_data_error: Memory Objects and Data.
- (line 157)
-* memory_object_data_initialize: Default Memory Manager.
- (line 73)
-* memory_object_data_provided: Memory Objects and Data.
- (line 289)
-* memory_object_data_request: Memory Objects and Data.
- (line 49)
-* memory_object_data_return: Memory Objects and Data.
- (line 11)
-* memory_object_data_supply: Memory Objects and Data.
- (line 84)
-* memory_object_data_unavailable: Memory Objects and Data.
- (line 177)
-* memory_object_data_unlock: Memory Object Locking.
- (line 85)
-* memory_object_data_write: Memory Objects and Data.
- (line 260)
-* memory_object_default_server: Memory Object Server.
- (line 10)
-* memory_object_destroy: Memory Object Termination.
- (line 37)
-* memory_object_get_attributes: Memory Object Attributes.
- (line 10)
-* memory_object_init: Memory Object Creation.
- (line 11)
-* memory_object_lock_completed: Memory Object Locking.
- (line 59)
-* memory_object_lock_request: Memory Object Locking.
- (line 11)
-* memory_object_ready: Memory Object Creation.
- (line 52)
-* memory_object_server: Memory Object Server.
- (line 8)
-* memory_object_set_attributes: Memory Object Attributes.
- (line 82)
-* memory_object_supply_completed: Memory Objects and Data.
- (line 127)
-* memory_object_terminate: Memory Object Termination.
- (line 10)
-* processor_assign: Processors and Sets. (line 8)
-* processor_basic_info_t: Processor Info. (line 67)
-* processor_control: Processor Control. (line 10)
-* processor_exit: Processor Control. (line 8)
-* processor_get_assignment: Processors and Sets. (line 32)
-* processor_info: Processor Info. (line 9)
-* processor_set_basic_info_t: Processor Set Info. (line 75)
-* processor_set_create: Processor Set Creation.
- (line 8)
-* processor_set_default: Processor Set Access.
- (line 36)
-* processor_set_destroy: Processor Set Destruction.
- (line 8)
-* processor_set_info: Processor Set Info. (line 10)
-* processor_set_max_priority: Processor Set Priority.
- (line 9)
-* processor_set_name_t: Processor Set Ports. (line 7)
-* processor_set_policy_disable: Processor Set Policy.
- (line 11)
-* processor_set_policy_enable: Processor Set Policy.
- (line 8)
-* processor_set_sched_info_t: Processor Set Info. (line 93)
-* processor_set_t: Processor Set Ports. (line 14)
-* processor_set_tasks: Tasks and Threads on Sets.
- (line 9)
-* processor_set_threads: Tasks and Threads on Sets.
- (line 23)
-* processor_start: Processor Control. (line 7)
-* processor_t: Processor Interface. (line 7)
-* sampled_pc_flavor_t: Profiling. (line 67)
-* sampled_pc_t: Profiling. (line 52)
-* seqnos_memory_object_change_completed: Memory Object Attributes.
- (line 67)
-* seqnos_memory_object_copy: Memory Objects and Data.
- (line 214)
-* seqnos_memory_object_create: Default Memory Manager.
- (line 35)
-* seqnos_memory_object_data_initialize: Default Memory Manager.
- (line 77)
-* seqnos_memory_object_data_request: Memory Objects and Data.
- (line 53)
-* seqnos_memory_object_data_return: Memory Objects and Data.
- (line 16)
-* seqnos_memory_object_data_unlock: Memory Object Locking.
- (line 89)
-* seqnos_memory_object_data_write: Memory Objects and Data.
- (line 264)
-* seqnos_memory_object_default_server: Memory Object Server.
- (line 14)
-* seqnos_memory_object_init: Memory Object Creation.
- (line 16)
-* seqnos_memory_object_lock_completed: Memory Object Locking.
- (line 63)
-* seqnos_memory_object_server: Memory Object Server.
- (line 12)
-* seqnos_memory_object_supply_completed: Memory Objects and Data.
- (line 132)
-* seqnos_memory_object_terminate: Memory Object Termination.
- (line 14)
-* struct host_basic_info: Host Information. (line 48)
-* struct host_sched_info: Host Information. (line 78)
-* struct processor_basic_info: Processor Info. (line 44)
-* struct processor_set_basic_info: Processor Set Info. (line 51)
-* struct processor_set_sched_info: Processor Set Info. (line 78)
-* struct task_basic_info: Task Information. (line 82)
-* struct task_events_info: Task Information. (line 114)
-* struct task_thread_times_info: Task Information. (line 145)
-* struct thread_basic_info: Thread Information. (line 66)
-* struct thread_sched_info: Thread Information. (line 128)
-* swtch: Hand-Off Scheduling. (line 81)
-* swtch_pri: Hand-Off Scheduling. (line 93)
-* task_assign: Tasks and Threads on Sets.
- (line 36)
-* task_assign_default: Tasks and Threads on Sets.
- (line 49)
-* task_basic_info_t: Task Information. (line 111)
-* task_create: Task Creation. (line 8)
-* task_disable_pc_sampling: Profiling. (line 22)
-* task_enable_pc_sampling: Profiling. (line 8)
-* task_events_info_t: Task Information. (line 142)
-* task_get_assignment: Tasks and Threads on Sets.
- (line 60)
-* task_get_bootstrap_port: Task Special Ports. (line 42)
-* task_get_emulation_vector: Syscall Emulation. (line 9)
-* task_get_exception_port: Task Special Ports. (line 36)
-* task_get_kernel_port: Task Special Ports. (line 30)
-* task_get_sampled_pcs: Profiling. (line 36)
-* task_get_special_port: Task Special Ports. (line 8)
-* task_info: Task Information. (line 44)
-* task_priority: Task Execution. (line 29)
-* task_ras_control: Task Execution. (line 47)
-* task_resume: Task Execution. (line 19)
-* task_set_bootstrap_port: Task Special Ports. (line 78)
-* task_set_emulation: Syscall Emulation. (line 22)
-* task_set_emulation_vector: Syscall Emulation. (line 15)
-* task_set_exception_port: Task Special Ports. (line 72)
-* task_set_kernel_port: Task Special Ports. (line 66)
-* task_set_special_port: Task Special Ports. (line 48)
-* task_suspend: Task Execution. (line 7)
-* task_t: Task Interface. (line 7)
-* task_terminate: Task Termination. (line 7)
-* task_thread_times_info_t: Task Information. (line 159)
-* task_threads: Task Information. (line 33)
-* thread_abort: Thread Execution. (line 38)
-* thread_assign: Tasks and Threads on Sets.
- (line 72)
-* thread_assign_default: Tasks and Threads on Sets.
- (line 85)
-* thread_basic_info_t: Thread Information. (line 125)
-* thread_create: Thread Creation. (line 8)
-* thread_depress_abort: Hand-Off Scheduling. (line 74)
-* thread_disable_pc_sampling: Profiling. (line 24)
-* thread_enable_pc_sampling: Profiling. (line 10)
-* thread_get_assignment: Tasks and Threads on Sets.
- (line 96)
-* thread_get_exception_port: Thread Special Ports.
- (line 27)
-* thread_get_kernel_port: Thread Special Ports.
- (line 21)
-* thread_get_sampled_pcs: Profiling. (line 39)
-* thread_get_special_port: Thread Special Ports.
- (line 8)
-* thread_get_state: Thread Execution. (line 102)
-* thread_info: Thread Information. (line 33)
-* thread_max_priority: Thread Priority. (line 38)
-* thread_policy: Scheduling Policy. (line 8)
-* thread_priority: Thread Priority. (line 20)
-* thread_resume: Thread Execution. (line 29)
-* thread_sched_info_t: Thread Information. (line 159)
-* thread_set_exception_port: Thread Special Ports.
- (line 52)
-* thread_set_kernel_port: Thread Special Ports.
- (line 46)
-* thread_set_special_port: Thread Special Ports.
- (line 33)
-* thread_set_state: Thread Execution. (line 126)
-* thread_suspend: Thread Execution. (line 7)
-* thread_switch: Hand-Off Scheduling. (line 8)
-* thread_t: Thread Interface. (line 7)
-* thread_terminate: Thread Termination. (line 7)
-* thread_wire: Thread Settings. (line 8)
-* time_value_add: Host Time. (line 25)
-* time_value_add_usec: Host Time. (line 21)
-* time_value_t: Host Time. (line 7)
-* vm_allocate: Memory Allocation. (line 8)
-* vm_copy: Data Transfer. (line 53)
-* vm_deallocate: Memory Deallocation. (line 8)
-* vm_inherit: Memory Attributes. (line 70)
-* vm_machine_attribute: Memory Attributes. (line 134)
-* vm_map: Mapping Memory Objects.
- (line 11)
-* vm_protect: Memory Attributes. (line 36)
-* vm_read: Data Transfer. (line 9)
-* vm_region: Memory Attributes. (line 11)
-* vm_set_default_memory_manager: Default Memory Manager.
- (line 8)
-* vm_statistics: Memory Statistics. (line 52)
-* vm_statistics_data_t: Memory Statistics. (line 7)
-* vm_task_t: Virtual Memory Interface.
- (line 7)
-* vm_wire: Memory Attributes. (line 101)
-* vm_write: Data Transfer. (line 34)
-
-