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_port_set_qlimit.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_port_set_qlimit.man,v $
   29 .\" Revision 2.6  93/05/10  19:31:47  rvb
   30 .\"     updated
   31 .\"     [93/04/21  16:04:02  lli]
   32 .\" 
   33 .\" Revision 2.5  91/12/11  08:43:21  jsb
   34 .\"     Changed <mach/mach.h> to <mach.h>.
   35 .\"     [91/11/25  10:55:59  rpd]
   36 .\" 
   37 .\" Revision 2.4  91/05/14  17:07:42  mrt
   38 .\"     Correcting copyright
   39 .\" 
   40 .\" Revision 2.3  91/02/14  14:12:07  mrt
   41 .\"     Changed to new Mach copyright
   42 .\"     [91/02/12  18:12:15  mrt]
   43 .\" 
   44 .\" Revision 2.2  90/08/07  18:38:19  rpd
   45 .\"     Created.
   46 .\" 
   47 .TH mach_port_set_qlimit 2 1/13/87
   48 .CM 4
   49 .SH NAME
   50 .nf
   51 mach_port_set_qlimit \- changes the queue limit of a port
   52 .SH SYNOPSIS
   53 .nf
   54 .ft B
   55 #include <mach.h>
   56 
   57 kern_return_t
   58 mach_port_set_qlimit(task, name, qlimit)
   59         mach_port_t task;
   60         mach_port_t name;
   61         mach_port_qlimit_t qlimit;
   62 .fi
   63 .ft P
   64 .SH ARGUMENTS
   65 .TP 12
   66 .B
   67 task
   68 The task owning the receive right.
   69 .TP 12
   70 .B
   71 name
   72 \fBtask\fR's name for the receive right.
   73 .TP 12
   74 .B
   75 qlimit
   76 The number of messages which may be queued to this port
   77 without causing the sender to block.
   78 .SH DESCRIPTION
   79 .B mach_port_set_qlimit
   80 changes the queue limit of \fBtask\fR's receive right
   81 named \fBname\fR.  Valid values for \fBqlimit\fR are between zero and
   82 MACH_PORT_QLIMIT_MAX, inclusive.
   83 .SH DIAGNOSTICS
   84 .TP 25
   85 KERN_SUCCESS
   86 The call succeeded.
   87 .TP 25
   88 KERN_INVALID_TASK
   89 \fBtask\fR was invalid.
   90 .TP 25
   91 KERN_INVALID_NAME
   92 \fBname\fR did not denote a right.
   93 .TP 25
   94 KERN_INVALID_RIGHT
   95 \fBname\fR denoted a right, but not a receive right.
   96 .TP 25
   97 KERN_INVALID_VALUE
   98 \fBqlimit\fR was invalid.
   99 .PP
  100 The \fBmach_port_set_qlimit\fR call is actually an RPC to \fBtask\fR,
  101 normally a send right for a task port, but potentially any send right.
  102 In addition to the normal diagnostic
  103 return codes from the call's server (normally the kernel),
  104 the call may return \fBmach_msg(2)\fR return codes.
  105 .SH SEE ALSO
  106 mach_port_get_receive_status(2), mach_port_set_mscount(2).

Cache object: 6d698050f3f79d92ed136e3cdb1cbc2c


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