1
0
Fork 0
python-docs-fr/library/select.po

995 lines
26 KiB
Plaintext
Raw Permalink Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
2016-10-30 09:46:26 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: library/select.rst:2
2016-10-30 09:46:26 +00:00
msgid ":mod:`select` --- Waiting for I/O completion"
msgstr ""
#: library/select.rst:9
2016-10-30 09:46:26 +00:00
msgid ""
"This module provides access to the :c:func:`select` and :c:func:`poll` "
"functions available in most operating systems, :c:func:`devpoll` available "
"on Solaris and derivatives, :c:func:`epoll` available on Linux 2.5+ and :c:"
"func:`kqueue` available on most BSD. Note that on Windows, it only works for "
"sockets; on other operating systems, it also works for other file types (in "
"particular, on Unix, it works on pipes). It cannot be used on regular files "
"to determine whether a file has grown since it was last read."
msgstr ""
#: library/select.rst:20
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`selectors` module allows high-level and efficient I/O "
"multiplexing, built upon the :mod:`select` module primitives. Users are "
"encouraged to use the :mod:`selectors` module instead, unless they want "
"precise control over the OS-level primitives used."
msgstr ""
#: includes/wasm-notavail.rst:None
#, fuzzy
msgid ":ref:`Availability <availability>`: not Emscripten, not WASI."
msgstr ":ref:`Disponibilité <availability>` : Unix"
#: includes/wasm-notavail.rst:5
msgid ""
"This module does not work or is not available on WebAssembly platforms "
"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for "
"more information."
msgstr ""
#: library/select.rst:27
2016-10-30 09:46:26 +00:00
msgid "The module defines the following:"
msgstr "Le module définit :"
2016-10-30 09:46:26 +00:00
#: library/select.rst:32
2016-10-30 09:46:26 +00:00
msgid "A deprecated alias of :exc:`OSError`."
msgstr ""
#: library/select.rst:34
2016-10-30 09:46:26 +00:00
msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`."
msgstr ""
#: library/select.rst:40
2016-10-30 09:46:26 +00:00
msgid ""
"(Only supported on Solaris and derivatives.) Returns a ``/dev/poll`` "
"polling object; see section :ref:`devpoll-objects` below for the methods "
"supported by devpoll objects."
msgstr ""
#: library/select.rst:44
2016-10-30 09:46:26 +00:00
msgid ""
":c:func:`devpoll` objects are linked to the number of file descriptors "
"allowed at the time of instantiation. If your program reduces this value, :c:"
"func:`devpoll` will fail. If your program increases this value, :c:func:"
"`devpoll` may return an incomplete list of active file descriptors."
msgstr ""
#: library/select.rst:79 library/select.rst:106
2016-10-30 09:46:26 +00:00
msgid "The new file descriptor is :ref:`non-inheritable <fd_inheritance>`."
msgstr ""
#: library/select.rst:108
2016-10-30 09:46:26 +00:00
msgid "The new file descriptor is now non-inheritable."
msgstr "Le nouveau descripteur de fichier est maintenant non-héritable."
#: library/select.rst:59
2016-10-30 09:46:26 +00:00
msgid ""
"(Only supported on Linux 2.5.44 and newer.) Return an edge polling object, "
"which can be used as Edge or Level Triggered interface for I/O events."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:63
2016-10-30 09:46:26 +00:00
msgid ""
"*sizehint* informs epoll about the expected number of events to be "
"registered. It must be positive, or ``-1`` to use the default. It is only "
"used on older systems where :c:func:`epoll_create1` is not available; "
"otherwise it has no effect (though its value is still checked)."
msgstr ""
#: library/select.rst:68
msgid ""
"*flags* is deprecated and completely ignored. However, when supplied, its "
"value must be ``0`` or ``select.EPOLL_CLOEXEC``, otherwise ``OSError`` is "
"raised."
msgstr ""
#: library/select.rst:72
msgid ""
2016-10-30 09:46:26 +00:00
"See the :ref:`epoll-objects` section below for the methods supported by "
"epolling objects."
msgstr ""
#: library/select.rst:75
2016-10-30 09:46:26 +00:00
msgid ""
"``epoll`` objects support the context management protocol: when used in a :"
"keyword:`with` statement, the new file descriptor is automatically closed at "
"the end of the block."
msgstr ""
#: library/select.rst:81
2016-10-30 09:46:26 +00:00
msgid "Added the *flags* parameter."
msgstr ""
#: library/select.rst:84
2016-10-30 09:46:26 +00:00
msgid ""
"Support for the :keyword:`with` statement was added. The new file descriptor "
"is now non-inheritable."
msgstr ""
#: library/select.rst:88
2016-10-30 09:46:26 +00:00
msgid ""
"The *flags* parameter. ``select.EPOLL_CLOEXEC`` is used by default now. "
"Use :func:`os.set_inheritable` to make the file descriptor inheritable."
msgstr ""
#: library/select.rst:95
2016-10-30 09:46:26 +00:00
msgid ""
"(Not supported by all operating systems.) Returns a polling object, which "
"supports registering and unregistering file descriptors, and then polling "
"them for I/O events; see section :ref:`poll-objects` below for the methods "
"supported by polling objects."
msgstr ""
#: library/select.rst:103
2016-10-30 09:46:26 +00:00
msgid ""
"(Only supported on BSD.) Returns a kernel queue object; see section :ref:"
"`kqueue-objects` below for the methods supported by kqueue objects."
msgstr ""
#: library/select.rst:114
2016-10-30 09:46:26 +00:00
msgid ""
"(Only supported on BSD.) Returns a kernel event object; see section :ref:"
"`kevent-objects` below for the methods supported by kevent objects."
msgstr ""
#: library/select.rst:120
2016-10-30 09:46:26 +00:00
msgid ""
"This is a straightforward interface to the Unix :c:func:`select` system "
2020-06-05 07:32:47 +00:00
"call. The first three arguments are iterables of 'waitable objects': either "
2016-10-30 09:46:26 +00:00
"integers representing file descriptors or objects with a parameterless "
"method named :meth:`~io.IOBase.fileno` returning such an integer:"
msgstr ""
#: library/select.rst:125
2016-10-30 09:46:26 +00:00
msgid "*rlist*: wait until ready for reading"
msgstr ""
#: library/select.rst:126
2016-10-30 09:46:26 +00:00
msgid "*wlist*: wait until ready for writing"
msgstr ""
#: library/select.rst:127
2016-10-30 09:46:26 +00:00
msgid ""
"*xlist*: wait for an \"exceptional condition\" (see the manual page for what "
"your system considers such a condition)"
msgstr ""
#: library/select.rst:130
2016-10-30 09:46:26 +00:00
msgid ""
2020-06-05 07:32:47 +00:00
"Empty iterables are allowed, but acceptance of three empty iterables is "
2016-10-30 09:46:26 +00:00
"platform-dependent. (It is known to work on Unix but not on Windows.) The "
"optional *timeout* argument specifies a time-out as a floating point number "
"in seconds. When the *timeout* argument is omitted the function blocks "
"until at least one file descriptor is ready. A time-out value of zero "
"specifies a poll and never blocks."
msgstr ""
#: library/select.rst:137
2016-10-30 09:46:26 +00:00
msgid ""
"The return value is a triple of lists of objects that are ready: subsets of "
"the first three arguments. When the time-out is reached without a file "
"descriptor becoming ready, three empty lists are returned."
msgstr ""
#: library/select.rst:145
2016-10-30 09:46:26 +00:00
msgid ""
2020-06-05 07:32:47 +00:00
"Among the acceptable object types in the iterables are Python :term:`file "
2016-10-30 09:46:26 +00:00
"objects <file object>` (e.g. ``sys.stdin``, or objects returned by :func:"
"`open` or :func:`os.popen`), socket objects returned by :func:`socket."
"socket`. You may also define a :dfn:`wrapper` class yourself, as long as it "
"has an appropriate :meth:`~io.IOBase.fileno` method (that really returns a "
"file descriptor, not just a random integer)."
msgstr ""
#: library/select.rst:156
2016-10-30 09:46:26 +00:00
msgid ""
"File objects on Windows are not acceptable, but sockets are. On Windows, "
"the underlying :c:func:`select` function is provided by the WinSock library, "
"and does not handle file descriptors that don't originate from WinSock."
msgstr ""
#: library/select.rst:267 library/select.rst:455 library/select.rst:496
2016-10-30 09:46:26 +00:00
msgid ""
"The function is now retried with a recomputed timeout when interrupted by a "
"signal, except if the signal handler raises an exception (see :pep:`475` for "
"the rationale), instead of raising :exc:`InterruptedError`."
msgstr ""
#: library/select.rst:170
2016-10-30 09:46:26 +00:00
msgid ""
"The minimum number of bytes which can be written without blocking to a pipe "
"when the pipe has been reported as ready for writing by :func:`~select."
"select`, :func:`poll` or another interface in this module. This doesn't "
"apply to other kind of file-like objects such as sockets."
msgstr ""
#: library/select.rst:175
2018-11-29 15:13:39 +00:00
msgid "This value is guaranteed by POSIX to be at least 512."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:178
2018-11-29 15:13:39 +00:00
msgid ":ref:`Availability <availability>`: Unix"
msgstr ":ref:`Disponibilité <availability>` : Unix"
2016-10-30 09:46:26 +00:00
#: library/select.rst:185
2018-11-29 15:13:39 +00:00
msgid "``/dev/poll`` Polling Objects"
msgstr ""
#: library/select.rst:187
2016-10-30 09:46:26 +00:00
msgid ""
"Solaris and derivatives have ``/dev/poll``. While :c:func:`select` is "
"O(highest file descriptor) and :c:func:`poll` is O(number of file "
"descriptors), ``/dev/poll`` is O(active file descriptors)."
msgstr ""
#: library/select.rst:191
2016-10-30 09:46:26 +00:00
msgid ""
"``/dev/poll`` behaviour is very close to the standard :c:func:`poll` object."
msgstr ""
#: library/select.rst:197
2016-10-30 09:46:26 +00:00
msgid "Close the file descriptor of the polling object."
msgstr ""
#: library/select.rst:204
2016-10-30 09:46:26 +00:00
msgid "``True`` if the polling object is closed."
msgstr ""
#: library/select.rst:211
2016-10-30 09:46:26 +00:00
msgid "Return the file descriptor number of the polling object."
msgstr ""
#: library/select.rst:390
2016-10-30 09:46:26 +00:00
msgid ""
"Register a file descriptor with the polling object. Future calls to the :"
"meth:`poll` method will then check whether the file descriptor has any "
"pending I/O events. *fd* can be either an integer, or an object with a :"
"meth:`~io.IOBase.fileno` method that returns an integer. File objects "
"implement :meth:`!fileno`, so they can also be used as the argument."
msgstr ""
#: library/select.rst:224
2016-10-30 09:46:26 +00:00
msgid ""
"*eventmask* is an optional bitmask describing the type of events you want to "
"check for. The constants are the same that with :c:func:`poll` object. The "
"default value is a combination of the constants :const:`POLLIN`, :const:"
"`POLLPRI`, and :const:`POLLOUT`."
msgstr ""
#: library/select.rst:231
2016-10-30 09:46:26 +00:00
msgid ""
"Registering a file descriptor that's already registered is not an error, but "
"the result is undefined. The appropriate action is to unregister or modify "
"it first. This is an important difference compared with :c:func:`poll`."
msgstr ""
#: library/select.rst:239
2016-10-30 09:46:26 +00:00
msgid ""
"This method does an :meth:`unregister` followed by a :meth:`register`. It is "
"(a bit) more efficient that doing the same explicitly."
msgstr ""
#: library/select.rst:434
2016-10-30 09:46:26 +00:00
msgid ""
"Remove a file descriptor being tracked by a polling object. Just like the :"
"meth:`register` method, *fd* can be an integer or an object with a :meth:"
"`~io.IOBase.fileno` method that returns an integer."
msgstr ""
#: library/select.rst:250
2016-10-30 09:46:26 +00:00
msgid ""
"Attempting to remove a file descriptor that was never registered is safely "
"ignored."
msgstr ""
#: library/select.rst:256
2016-10-30 09:46:26 +00:00
msgid ""
"Polls the set of registered file descriptors, and returns a possibly empty "
2016-10-30 09:46:26 +00:00
"list containing ``(fd, event)`` 2-tuples for the descriptors that have "
"events or errors to report. *fd* is the file descriptor, and *event* is a "
"bitmask with bits set for the reported events for that descriptor --- :const:"
"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor "
"can be written to, and so forth. An empty list indicates that the call timed "
"out and no file descriptors had any events to report. If *timeout* is given, "
"it specifies the length of time in milliseconds which the system will wait "
"for events before returning. If *timeout* is omitted, -1, or :const:`None`, "
"the call will block until there is an event for this poll object."
msgstr ""
#: library/select.rst:277
2016-10-30 09:46:26 +00:00
msgid "Edge and Level Trigger Polling (epoll) Objects"
msgstr ""
#: library/select.rst:279
2018-06-28 13:32:56 +00:00
msgid "https://linux.die.net/man/4/epoll"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:281
2016-10-30 09:46:26 +00:00
msgid "*eventmask*"
msgstr ""
#: library/select.rst:402 library/select.rst:551 library/select.rst:590
#: library/select.rst:633
2016-10-30 09:46:26 +00:00
msgid "Constant"
msgstr "Constante"
2016-10-30 09:46:26 +00:00
#: library/select.rst:402 library/select.rst:551 library/select.rst:590
#: library/select.rst:633
2016-10-30 09:46:26 +00:00
msgid "Meaning"
msgstr "Signification"
#: library/select.rst:286
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLIN`"
msgstr ":const:`EPOLLIN`"
#: library/select.rst:286
2016-10-30 09:46:26 +00:00
msgid "Available for read"
msgstr ""
#: library/select.rst:288
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLOUT`"
msgstr ":const:`EPOLLOUT`"
#: library/select.rst:288
2016-10-30 09:46:26 +00:00
msgid "Available for write"
msgstr ""
#: library/select.rst:290
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLPRI`"
msgstr ":const:`EPOLLPRI`"
#: library/select.rst:290
2016-10-30 09:46:26 +00:00
msgid "Urgent data for read"
msgstr ""
#: library/select.rst:292
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLERR`"
msgstr ":const:`EPOLLERR`"
#: library/select.rst:292
2016-10-30 09:46:26 +00:00
msgid "Error condition happened on the assoc. fd"
msgstr ""
#: library/select.rst:294
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLHUP`"
msgstr ":const:`EPOLLHUP`"
#: library/select.rst:294
2016-10-30 09:46:26 +00:00
msgid "Hang up happened on the assoc. fd"
msgstr ""
#: library/select.rst:296
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLET`"
msgstr ":const:`EPOLLET`"
#: library/select.rst:296
2016-10-30 09:46:26 +00:00
msgid "Set Edge Trigger behavior, the default is Level Trigger behavior"
msgstr ""
#: library/select.rst:299
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLONESHOT`"
msgstr ":const:`EPOLLONESHOT`"
#: library/select.rst:299
2016-10-30 09:46:26 +00:00
msgid ""
"Set one-shot behavior. After one event is pulled out, the fd is internally "
"disabled"
msgstr ""
#: library/select.rst:302
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLEXCLUSIVE`"
msgstr ":const:`EPOLLEXCLUSIVE`"
2016-10-30 09:46:26 +00:00
#: library/select.rst:302
2016-10-30 09:46:26 +00:00
msgid ""
"Wake only one epoll object when the associated fd has an event. The default "
2017-05-27 17:46:38 +00:00
"(if this flag is not set) is to wake all epoll objects polling on a fd."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:307
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLRDHUP`"
2020-02-14 10:18:53 +00:00
msgstr ":const:`EPOLLHUP`"
2016-10-30 09:46:26 +00:00
#: library/select.rst:307
2016-10-30 09:46:26 +00:00
msgid ""
"Stream socket peer closed connection or shut down writing half of connection."
msgstr ""
#: library/select.rst:310
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLRDNORM`"
msgstr ":const:`EPOLLRDNORM`"
#: library/select.rst:310
2016-10-30 09:46:26 +00:00
msgid "Equivalent to :const:`EPOLLIN`"
msgstr ""
#: library/select.rst:312
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLRDBAND`"
msgstr ":const:`EPOLLRDBAND`"
#: library/select.rst:312
2016-10-30 09:46:26 +00:00
msgid "Priority data band can be read."
msgstr ""
#: library/select.rst:314
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLWRNORM`"
msgstr ":const:`EPOLLWRNORM`"
#: library/select.rst:314
2016-10-30 09:46:26 +00:00
msgid "Equivalent to :const:`EPOLLOUT`"
msgstr ""
#: library/select.rst:316
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLWRBAND`"
msgstr ":const:`EPOLLWRBAND`"
#: library/select.rst:316
2016-10-30 09:46:26 +00:00
msgid "Priority data may be written."
msgstr ""
#: library/select.rst:318
2016-10-30 09:46:26 +00:00
msgid ":const:`EPOLLMSG`"
msgstr ":const:`EPOLLMSG`"
#: library/select.rst:318
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "Ignored."
2020-02-14 10:18:53 +00:00
msgstr "Ignoré"
2016-10-30 09:46:26 +00:00
#: library/select.rst:321
2018-12-24 13:20:55 +00:00
msgid ""
":const:`EPOLLEXCLUSIVE` was added. It's only supported by Linux Kernel 4.5 "
"or later."
msgstr ""
#: library/select.rst:327
2016-10-30 09:46:26 +00:00
msgid "Close the control file descriptor of the epoll object."
msgstr ""
#: library/select.rst:332
2016-10-30 09:46:26 +00:00
msgid "``True`` if the epoll object is closed."
msgstr ""
#: library/select.rst:479
2016-10-30 09:46:26 +00:00
msgid "Return the file descriptor number of the control fd."
msgstr ""
#: library/select.rst:342
2016-10-30 09:46:26 +00:00
msgid "Create an epoll object from a given file descriptor."
msgstr ""
#: library/select.rst:347
2016-10-30 09:46:26 +00:00
msgid "Register a fd descriptor with the epoll object."
msgstr ""
#: library/select.rst:352
2016-10-30 09:46:26 +00:00
msgid "Modify a registered file descriptor."
msgstr ""
#: library/select.rst:357
2016-10-30 09:46:26 +00:00
msgid "Remove a registered file descriptor from the epoll object."
msgstr ""
#: library/select.rst:359
2020-07-20 08:56:42 +00:00
msgid "The method no longer ignores the :data:`~errno.EBADF` error."
msgstr ""
#: library/select.rst:365
2016-10-30 09:46:26 +00:00
msgid "Wait for events. timeout in seconds (float)"
msgstr ""
#: library/select.rst:377
2016-10-30 09:46:26 +00:00
msgid "Polling Objects"
msgstr ""
#: library/select.rst:379
2016-10-30 09:46:26 +00:00
msgid ""
"The :c:func:`poll` system call, supported on most Unix systems, provides "
"better scalability for network servers that service many, many clients at "
"the same time. :c:func:`poll` scales better because the system call only "
"requires listing the file descriptors of interest, while :c:func:`select` "
"builds a bitmap, turns on bits for the fds of interest, and then afterward "
"the whole bitmap has to be linearly scanned again. :c:func:`select` is "
"O(highest file descriptor), while :c:func:`poll` is O(number of file "
"descriptors)."
msgstr ""
#: library/select.rst:396
2016-10-30 09:46:26 +00:00
msgid ""
"*eventmask* is an optional bitmask describing the type of events you want to "
"check for, and can be a combination of the constants :const:`POLLIN`, :const:"
"`POLLPRI`, and :const:`POLLOUT`, described in the table below. If not "
"specified, the default value used will check for all 3 types of events."
msgstr ""
#: library/select.rst:404
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLIN`"
msgstr ":const:`POLLIN`"
#: library/select.rst:404
2016-10-30 09:46:26 +00:00
msgid "There is data to read"
msgstr ""
#: library/select.rst:406
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLPRI`"
msgstr ":const:`POLLPRI`"
#: library/select.rst:406
2016-10-30 09:46:26 +00:00
msgid "There is urgent data to read"
msgstr ""
#: library/select.rst:408
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLOUT`"
msgstr ":const:`POLLOUT`"
#: library/select.rst:408
2016-10-30 09:46:26 +00:00
msgid "Ready for output: writing will not block"
msgstr ""
#: library/select.rst:410
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLERR`"
msgstr ":const:`POLLERR`"
#: library/select.rst:410
2016-10-30 09:46:26 +00:00
msgid "Error condition of some sort"
msgstr ""
#: library/select.rst:412
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLHUP`"
msgstr ":const:`POLLHUP`"
#: library/select.rst:412
2016-10-30 09:46:26 +00:00
msgid "Hung up"
msgstr ""
#: library/select.rst:414
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLRDHUP`"
2020-02-14 10:18:53 +00:00
msgstr ":const:`POLLHUP`"
2016-10-30 09:46:26 +00:00
#: library/select.rst:414
2016-10-30 09:46:26 +00:00
msgid ""
"Stream socket peer closed connection, or shut down writing half of connection"
msgstr ""
#: library/select.rst:417
2016-10-30 09:46:26 +00:00
msgid ":const:`POLLNVAL`"
msgstr ":const:`POLLNVAL`"
#: library/select.rst:417
2016-10-30 09:46:26 +00:00
msgid "Invalid request: descriptor not open"
msgstr ""
#: library/select.rst:420
2016-10-30 09:46:26 +00:00
msgid ""
"Registering a file descriptor that's already registered is not an error, and "
"has the same effect as registering the descriptor exactly once."
msgstr ""
#: library/select.rst:426
2016-10-30 09:46:26 +00:00
msgid ""
"Modifies an already registered fd. This has the same effect as "
"``register(fd, eventmask)``. Attempting to modify a file descriptor that "
"was never registered causes an :exc:`OSError` exception with errno :const:"
"`ENOENT` to be raised."
msgstr ""
#: library/select.rst:438
2016-10-30 09:46:26 +00:00
msgid ""
"Attempting to remove a file descriptor that was never registered causes a :"
"exc:`KeyError` exception to be raised."
msgstr ""
#: library/select.rst:444
2016-10-30 09:46:26 +00:00
msgid ""
"Polls the set of registered file descriptors, and returns a possibly empty "
2016-10-30 09:46:26 +00:00
"list containing ``(fd, event)`` 2-tuples for the descriptors that have "
"events or errors to report. *fd* is the file descriptor, and *event* is a "
"bitmask with bits set for the reported events for that descriptor --- :const:"
"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor "
"can be written to, and so forth. An empty list indicates that the call timed "
"out and no file descriptors had any events to report. If *timeout* is given, "
"it specifies the length of time in milliseconds which the system will wait "
"for events before returning. If *timeout* is omitted, negative, or :const:"
"`None`, the call will block until there is an event for this poll object."
msgstr ""
#: library/select.rst:465
2016-10-30 09:46:26 +00:00
msgid "Kqueue Objects"
msgstr ""
#: library/select.rst:469
2016-10-30 09:46:26 +00:00
msgid "Close the control file descriptor of the kqueue object."
msgstr ""
#: library/select.rst:474
2016-10-30 09:46:26 +00:00
msgid "``True`` if the kqueue object is closed."
msgstr ""
#: library/select.rst:484
2016-10-30 09:46:26 +00:00
msgid "Create a kqueue object from a given file descriptor."
msgstr ""
#: library/select.rst:489
2016-10-30 09:46:26 +00:00
msgid "Low level interface to kevent"
msgstr ""
#: library/select.rst:491
2019-09-04 09:35:23 +00:00
msgid "changelist must be an iterable of kevent objects or ``None``"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:492
2016-10-30 09:46:26 +00:00
msgid "max_events must be 0 or a positive integer"
msgstr ""
#: library/select.rst:493
2019-09-04 09:35:23 +00:00
msgid ""
"timeout in seconds (floats possible); the default is ``None``, to wait "
"forever"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:506
2016-10-30 09:46:26 +00:00
msgid "Kevent Objects"
msgstr ""
#: library/select.rst:508
2016-10-30 09:46:26 +00:00
msgid "https://www.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2"
msgstr ""
#: library/select.rst:512
2016-10-30 09:46:26 +00:00
msgid ""
"Value used to identify the event. The interpretation depends on the filter "
"but it's usually the file descriptor. In the constructor ident can either be "
"an int or an object with a :meth:`~io.IOBase.fileno` method. kevent stores "
"the integer internally."
msgstr ""
#: library/select.rst:519
2016-10-30 09:46:26 +00:00
msgid "Name of the kernel filter."
msgstr ""
#: library/select.rst:524
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_READ`"
msgstr ":const:`KQ_FILTER_READ`"
#: library/select.rst:524
2016-10-30 09:46:26 +00:00
msgid "Takes a descriptor and returns whenever there is data available to read"
msgstr ""
#: library/select.rst:527
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_WRITE`"
msgstr ":const:`KQ_FILTER_WRITE`"
#: library/select.rst:527
2016-10-30 09:46:26 +00:00
msgid ""
"Takes a descriptor and returns whenever there is data available to write"
msgstr ""
#: library/select.rst:530
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_AIO`"
msgstr ":const:`KQ_FILTER_AIO`"
#: library/select.rst:530
2016-10-30 09:46:26 +00:00
msgid "AIO requests"
msgstr ""
#: library/select.rst:532
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_VNODE`"
msgstr ":const:`KQ_FILTER_VNODE`"
#: library/select.rst:532
2016-10-30 09:46:26 +00:00
msgid ""
"Returns when one or more of the requested events watched in *fflag* occurs"
msgstr ""
#: library/select.rst:535
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_PROC`"
msgstr ":const:`KQ_FILTER_PROC`"
#: library/select.rst:535
2016-10-30 09:46:26 +00:00
msgid "Watch for events on a process id"
msgstr ""
#: library/select.rst:537
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_NETDEV`"
msgstr ":const:`KQ_FILTER_NETDEV`"
#: library/select.rst:537
msgid "Watch for events on a network device [not available on macOS]"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:540
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_SIGNAL`"
msgstr ":const:`KQ_FILTER_SIGNAL`"
#: library/select.rst:540
2016-10-30 09:46:26 +00:00
msgid "Returns whenever the watched signal is delivered to the process"
msgstr ""
#: library/select.rst:543
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_TIMER`"
msgstr ":const:`KQ_FILTER_TIMER`"
#: library/select.rst:543
2016-10-30 09:46:26 +00:00
msgid "Establishes an arbitrary timer"
msgstr ""
#: library/select.rst:548
2016-10-30 09:46:26 +00:00
msgid "Filter action."
msgstr ""
#: library/select.rst:553
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_ADD`"
msgstr ":const:`KQ_EV_ADD`"
#: library/select.rst:553
2016-10-30 09:46:26 +00:00
msgid "Adds or modifies an event"
msgstr ""
#: library/select.rst:555
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_DELETE`"
msgstr ":const:`KQ_EV_DELETE`"
#: library/select.rst:555
2016-10-30 09:46:26 +00:00
msgid "Removes an event from the queue"
msgstr ""
#: library/select.rst:557
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_ENABLE`"
msgstr ":const:`KQ_EV_ENABLE`"
#: library/select.rst:557
2016-10-30 09:46:26 +00:00
msgid "Permitscontrol() to returns the event"
msgstr ""
#: library/select.rst:559
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_DISABLE`"
msgstr ":const:`KQ_EV_DISABLE`"
#: library/select.rst:559
2016-10-30 09:46:26 +00:00
msgid "Disablesevent"
msgstr ""
#: library/select.rst:561
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_ONESHOT`"
msgstr ":const:`KQ_EV_ONESHOT`"
#: library/select.rst:561
2016-10-30 09:46:26 +00:00
msgid "Removes event after first occurrence"
msgstr ""
#: library/select.rst:563
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_CLEAR`"
msgstr ":const:`KQ_EV_CLEAR`"
#: library/select.rst:563
2016-10-30 09:46:26 +00:00
msgid "Reset the state after an event is retrieved"
msgstr ""
#: library/select.rst:565
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_SYSFLAGS`"
msgstr ":const:`KQ_EV_SYSFLAGS`"
#: library/select.rst:567
2016-10-30 09:46:26 +00:00
msgid "internal event"
msgstr ""
#: library/select.rst:567
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_FLAG1`"
msgstr ":const:`KQ_EV_FLAG1`"
#: library/select.rst:569
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_EOF`"
msgstr ":const:`KQ_EV_EOF`"
#: library/select.rst:569
2016-10-30 09:46:26 +00:00
msgid "Filter specific EOF condition"
msgstr ""
#: library/select.rst:571
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_EV_ERROR`"
msgstr ":const:`KQ_EV_ERROR`"
#: library/select.rst:571
2016-10-30 09:46:26 +00:00
msgid "See return values"
msgstr ""
#: library/select.rst:577
2016-10-30 09:46:26 +00:00
msgid "Filter specific flags."
msgstr ""
#: library/select.rst:579
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:"
msgstr ""
#: library/select.rst:584
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_LOWAT`"
msgstr ":const:`KQ_NOTE_LOWAT`"
#: library/select.rst:584
2016-10-30 09:46:26 +00:00
msgid "low water mark of a socket buffer"
msgstr ""
#: library/select.rst:587
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_VNODE` filter flags:"
msgstr ""
#: library/select.rst:592
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_DELETE`"
msgstr ":const:`KQ_NOTE_DELETE`"
#: library/select.rst:592
2016-10-30 09:46:26 +00:00
msgid "*unlink()* was called"
msgstr ""
#: library/select.rst:594
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_WRITE`"
msgstr ":const:`KQ_NOTE_WRITE`"
#: library/select.rst:594
2016-10-30 09:46:26 +00:00
msgid "a write occurred"
msgstr ""
#: library/select.rst:596
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_EXTEND`"
msgstr ":const:`KQ_NOTE_EXTEND`"
#: library/select.rst:596
2016-10-30 09:46:26 +00:00
msgid "the file was extended"
msgstr ""
#: library/select.rst:598
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_ATTRIB`"
msgstr ":const:`KQ_NOTE_ATTRIB`"
#: library/select.rst:598
2016-10-30 09:46:26 +00:00
msgid "an attribute was changed"
msgstr ""
#: library/select.rst:600
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_LINK`"
msgstr ":const:`KQ_NOTE_LINK`"
#: library/select.rst:600
2016-10-30 09:46:26 +00:00
msgid "the link count has changed"
msgstr ""
#: library/select.rst:602
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_RENAME`"
msgstr ":const:`KQ_NOTE_RENAME`"
#: library/select.rst:602
2016-10-30 09:46:26 +00:00
msgid "the file was renamed"
msgstr ""
#: library/select.rst:604
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_REVOKE`"
msgstr ":const:`KQ_NOTE_REVOKE`"
#: library/select.rst:604
2016-10-30 09:46:26 +00:00
msgid "access to the file was revoked"
msgstr ""
#: library/select.rst:607
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_FILTER_PROC` filter flags:"
msgstr ""
#: library/select.rst:612
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_EXIT`"
msgstr ":const:`KQ_NOTE_EXIT`"
#: library/select.rst:612
2016-10-30 09:46:26 +00:00
msgid "the process has exited"
msgstr ""
#: library/select.rst:614
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_FORK`"
msgstr ":const:`KQ_NOTE_FORK`"
#: library/select.rst:614
2016-10-30 09:46:26 +00:00
msgid "the process has called *fork()*"
msgstr ""
#: library/select.rst:616
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_EXEC`"
msgstr ":const:`KQ_NOTE_EXEC`"
#: library/select.rst:616
2016-10-30 09:46:26 +00:00
msgid "the process has executed a new process"
msgstr ""
#: library/select.rst:618
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_PCTRLMASK`"
msgstr ":const:`KQ_NOTE_PCTRLMASK`"
#: library/select.rst:620
2016-10-30 09:46:26 +00:00
msgid "internal filter flag"
msgstr ""
#: library/select.rst:620
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_PDATAMASK`"
msgstr ":const:`KQ_NOTE_PDATAMASK`"
#: library/select.rst:622
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_TRACK`"
msgstr ":const:`KQ_NOTE_TRACK`"
#: library/select.rst:622
2016-10-30 09:46:26 +00:00
msgid "follow a process across *fork()*"
msgstr ""
#: library/select.rst:624
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_CHILD`"
msgstr ":const:`KQ_NOTE_CHILD`"
#: library/select.rst:624
2016-10-30 09:46:26 +00:00
msgid "returned on the child process for *NOTE_TRACK*"
msgstr ""
#: library/select.rst:627
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_TRACKERR`"
msgstr ":const:`KQ_NOTE_TRACKERR`"
#: library/select.rst:627
2016-10-30 09:46:26 +00:00
msgid "unable to attach to a child"
msgstr ""
#: library/select.rst:630
msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/select.rst:635
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_LINKUP`"
msgstr ":const:`KQ_NOTE_LINKUP`"
#: library/select.rst:635
2016-10-30 09:46:26 +00:00
msgid "link is up"
msgstr ""
#: library/select.rst:637
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_LINKDOWN`"
msgstr ":const:`KQ_NOTE_LINKDOWN`"
#: library/select.rst:637
2016-10-30 09:46:26 +00:00
msgid "link is down"
msgstr ""
#: library/select.rst:639
2016-10-30 09:46:26 +00:00
msgid ":const:`KQ_NOTE_LINKINV`"
msgstr ":const:`KQ_NOTE_LINKINV`"
#: library/select.rst:639
2016-10-30 09:46:26 +00:00
msgid "link state is invalid"
msgstr ""
#: library/select.rst:645
2016-10-30 09:46:26 +00:00
msgid "Filter specific data."
msgstr ""
#: library/select.rst:650
2016-10-30 09:46:26 +00:00
msgid "User defined value."
msgstr ""