Skip to content

Commit 50a59b2

Browse files
lpyu001lpyu001
committed
updates
1 parent da3630b commit 50a59b2

1 file changed

Lines changed: 127 additions & 127 deletions

File tree

‎Doc/library/select.rst‎

Lines changed: 127 additions & 127 deletions
Original file line numberDiff line numberDiff line change
@@ -436,24 +436,24 @@ linearly scanned again. :c:func:`!select` is *O*\ (*highest file descriptor*), w
436436
The event masks that can be used with polling objects are combinations of the
437437
following constants:
438438

439-
+--------------------+-------------------------------------------+
440-
| Constant | Meaning |
441-
+====================+===========================================+
442-
| .. data:: POLLIN | There is data to read. |
443-
+--------------------+-------------------------------------------+
444-
| .. data:: POLLPRI | There is urgent data to read. |
445-
+--------------------+-------------------------------------------+
446-
| .. data:: POLLOUT | Ready for output: writing will not block. |
447-
+--------------------+-------------------------------------------+
448-
| .. data:: POLLERR | Error condition of some sort. |
449-
+--------------------+-------------------------------------------+
450-
| .. data:: POLLHUP | Hung up. |
451-
+--------------------+-------------------------------------------+
452-
| .. data:: POLLRDHUP| Stream socket peer closed connection, or |
453-
| | shut down writing half of connection. |
454-
+--------------------+-------------------------------------------+
455-
| .. data:: POLLNVAL | Invalid request: descriptor not open. |
456-
+--------------------+-------------------------------------------+
439+
+--------------------+-------------------------------------------+
440+
| Constant | Meaning |
441+
+====================+===========================================+
442+
| .. data:: POLLIN | There is data to read. |
443+
+--------------------+-------------------------------------------+
444+
| .. data:: POLLPRI | There is urgent data to read. |
445+
+--------------------+-------------------------------------------+
446+
| .. data:: POLLOUT | Ready for output: writing will not block. |
447+
+--------------------+-------------------------------------------+
448+
| .. data:: POLLERR | Error condition of some sort. |
449+
+--------------------+-------------------------------------------+
450+
| .. data:: POLLHUP | Hung up. |
451+
+--------------------+-------------------------------------------+
452+
| .. data:: POLLRDHUP| Stream socket peer closed connection, or |
453+
| | shut down writing half of connection. |
454+
+--------------------+-------------------------------------------+
455+
| .. data:: POLLNVAL | Invalid request: descriptor not open. |
456+
+--------------------+-------------------------------------------+
457457

458458

459459
.. method:: poll.modify(fd, eventmask)
@@ -564,60 +564,60 @@ https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2
564564

565565
The following constants can be used with :attr:`kevent.filter`:
566566

567-
+---------------------------+---------------------------------------------+
568-
| Constant | Meaning |
569-
+===========================+=============================================+
570-
| .. data:: KQ_FILTER_READ | Takes a descriptor and returns whenever |
571-
| | there is data available to read. |
572-
+---------------------------+---------------------------------------------+
573-
| .. data:: KQ_FILTER_WRITE | Takes a descriptor and returns whenever |
574-
| | there is data available to write. |
575-
+---------------------------+---------------------------------------------+
576-
| .. data:: KQ_FILTER_AIO | AIO requests. |
577-
+---------------------------+---------------------------------------------+
578-
| .. data:: KQ_FILTER_VNODE | Returns when one or more of the requested |
579-
| | events watched in *fflag* occurs. |
580-
+---------------------------+---------------------------------------------+
581-
| .. data:: KQ_FILTER_PROC | Watch for events on a process ID. |
582-
+---------------------------+---------------------------------------------+
583-
| .. data:: KQ_FILTER_NETDEV| Watch for events on a network device |
584-
| | (not available on macOS). |
585-
+---------------------------+---------------------------------------------+
586-
| .. data:: KQ_FILTER_SIGNAL| Returns whenever the watched signal is |
587-
| | delivered to the process. |
588-
+---------------------------+---------------------------------------------+
589-
| .. data:: KQ_FILTER_TIMER | Establishes an arbitrary timer. |
590-
+---------------------------+---------------------------------------------+
567+
+---------------------------+---------------------------------------------+
568+
| Constant | Meaning |
569+
+===========================+=============================================+
570+
| .. data:: KQ_FILTER_READ | Takes a descriptor and returns whenever |
571+
| | there is data available to read. |
572+
+---------------------------+---------------------------------------------+
573+
| .. data:: KQ_FILTER_WRITE | Takes a descriptor and returns whenever |
574+
| | there is data available to write. |
575+
+---------------------------+---------------------------------------------+
576+
| .. data:: KQ_FILTER_AIO | AIO requests. |
577+
+---------------------------+---------------------------------------------+
578+
| .. data:: KQ_FILTER_VNODE | Returns when one or more of the requested |
579+
| | events watched in *fflag* occurs. |
580+
+---------------------------+---------------------------------------------+
581+
| .. data:: KQ_FILTER_PROC | Watch for events on a process ID. |
582+
+---------------------------+---------------------------------------------+
583+
| .. data:: KQ_FILTER_NETDEV| Watch for events on a network device |
584+
| | (not available on macOS). |
585+
+---------------------------+---------------------------------------------+
586+
| .. data:: KQ_FILTER_SIGNAL| Returns whenever the watched signal is |
587+
| | delivered to the process. |
588+
+---------------------------+---------------------------------------------+
589+
| .. data:: KQ_FILTER_TIMER | Establishes an arbitrary timer. |
590+
+---------------------------+---------------------------------------------+
591591

592592
.. attribute:: kevent.flags
593593

594594
Filter action.
595595

596596
The following constants can be used with :attr:`kevent.flags`:
597597

598-
+---------------------------+----------------------------------------------+
599-
| Constant | Meaning |
600-
+===========================+==============================================+
601-
| .. data:: KQ_EV_ADD | Adds or modifies an event. |
602-
+---------------------------+----------------------------------------------+
603-
| .. data:: KQ_EV_DELETE | Removes an event from the queue. |
604-
+---------------------------+----------------------------------------------+
605-
| .. data:: KQ_EV_ENABLE | Permits control() to return the event. |
606-
+---------------------------+----------------------------------------------+
607-
| .. data:: KQ_EV_DISABLE | Disables event. |
608-
+---------------------------+----------------------------------------------+
609-
| .. data:: KQ_EV_ONESHOT | Removes event after first occurrence. |
610-
+---------------------------+----------------------------------------------+
611-
| .. data:: KQ_EV_CLEAR | Reset the state after an event is retrieved. |
612-
+---------------------------+----------------------------------------------+
613-
| .. data:: KQ_EV_SYSFLAGS | Internal event. |
614-
+---------------------------+----------------------------------------------+
615-
| .. data:: KQ_EV_FLAG1 | Internal event. |
616-
+---------------------------+----------------------------------------------+
617-
| .. data:: KQ_EV_EOF | Filter-specific EOF condition. |
618-
+---------------------------+----------------------------------------------+
619-
| .. data:: KQ_EV_ERROR | See return values. |
620-
+---------------------------+----------------------------------------------+
598+
+---------------------------+----------------------------------------------+
599+
| Constant | Meaning |
600+
+===========================+==============================================+
601+
| .. data:: KQ_EV_ADD | Adds or modifies an event. |
602+
+---------------------------+----------------------------------------------+
603+
| .. data:: KQ_EV_DELETE | Removes an event from the queue. |
604+
+---------------------------+----------------------------------------------+
605+
| .. data:: KQ_EV_ENABLE | Permits control() to return the event. |
606+
+---------------------------+----------------------------------------------+
607+
| .. data:: KQ_EV_DISABLE | Disables event. |
608+
+---------------------------+----------------------------------------------+
609+
| .. data:: KQ_EV_ONESHOT | Removes event after first occurrence. |
610+
+---------------------------+----------------------------------------------+
611+
| .. data:: KQ_EV_CLEAR | Reset the state after an event is retrieved. |
612+
+---------------------------+----------------------------------------------+
613+
| .. data:: KQ_EV_SYSFLAGS | Internal event. |
614+
+---------------------------+----------------------------------------------+
615+
| .. data:: KQ_EV_FLAG1 | Internal event. |
616+
+---------------------------+----------------------------------------------+
617+
| .. data:: KQ_EV_EOF | Filter-specific EOF condition. |
618+
+---------------------------+----------------------------------------------+
619+
| .. data:: KQ_EV_ERROR | See return values. |
620+
+---------------------------+----------------------------------------------+
621621

622622

623623
.. attribute:: kevent.fflags
@@ -627,68 +627,68 @@ The following constants can be used with :attr:`kevent.flags`:
627627
The following flags can be used with :attr:`kevent.fflags`, depending on the
628628
filter type.
629629

630-
:const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:
631-
632-
+----------------------------+--------------------------------------------+
633-
| Constant | Meaning |
634-
+============================+============================================+
635-
| .. data:: KQ_NOTE_LOWAT | Low water mark of a socket buffer. |
636-
+----------------------------+--------------------------------------------+
637-
638-
:const:`KQ_FILTER_VNODE` filter flags:
639-
640-
+----------------------------+--------------------------------------------+
641-
| Constant | Meaning |
642-
+============================+============================================+
643-
| .. data:: KQ_NOTE_DELETE | *unlink()* was called. |
644-
+----------------------------+--------------------------------------------+
645-
| .. data:: KQ_NOTE_WRITE | A write occurred. |
646-
+----------------------------+--------------------------------------------+
647-
| .. data:: KQ_NOTE_EXTEND | The file was extended. |
648-
+----------------------------+--------------------------------------------+
649-
| .. data:: KQ_NOTE_ATTRIB | An attribute was changed. |
650-
+----------------------------+--------------------------------------------+
651-
| .. data:: KQ_NOTE_LINK | The link count has changed. |
652-
+----------------------------+--------------------------------------------+
653-
| .. data:: KQ_NOTE_RENAME | The file was renamed. |
654-
+----------------------------+--------------------------------------------+
655-
| .. data:: KQ_NOTE_REVOKE | Access to the file was revoked. |
656-
+----------------------------+--------------------------------------------+
657-
658-
:const:`KQ_FILTER_PROC` filter flags:
659-
660-
+----------------------------+--------------------------------------------+
661-
| Constant | Meaning |
662-
+============================+============================================+
663-
| .. data:: KQ_NOTE_EXIT | The process has exited. |
664-
+----------------------------+--------------------------------------------+
665-
| .. data:: KQ_NOTE_FORK | The process has called *fork()*. |
666-
+----------------------------+--------------------------------------------+
667-
| .. data:: KQ_NOTE_EXEC | The process has executed a new process. |
668-
+----------------------------+--------------------------------------------+
669-
| .. data:: KQ_NOTE_PCTRLMASK| Internal filter flag. |
670-
+----------------------------+--------------------------------------------+
671-
| .. data:: KQ_NOTE_PDATAMASK| Internal filter flag. |
672-
+----------------------------+--------------------------------------------+
673-
| .. data:: KQ_NOTE_TRACK | Follow a process across *fork()*. |
674-
+----------------------------+--------------------------------------------+
675-
| .. data:: KQ_NOTE_CHILD | Returned on the child process for |
676-
| | *NOTE_TRACK*. |
677-
+----------------------------+--------------------------------------------+
678-
| .. data:: KQ_NOTE_TRACKERR | Unable to attach to a child. |
679-
+----------------------------+--------------------------------------------+
680-
681-
:const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):
682-
683-
+----------------------------+--------------------------------------------+
684-
| Constant | Meaning |
685-
+============================+============================================+
686-
| .. data:: KQ_NOTE_LINKUP | Link is up. |
687-
+----------------------------+--------------------------------------------+
688-
| .. data:: KQ_NOTE_LINKDOWN | Link is down. |
689-
+----------------------------+--------------------------------------------+
690-
| .. data:: KQ_NOTE_LINKINV | Link state is invalid. |
691-
+----------------------------+--------------------------------------------+
630+
:const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:
631+
632+
+----------------------------+--------------------------------------------+
633+
| Constant | Meaning |
634+
+============================+============================================+
635+
| .. data:: KQ_NOTE_LOWAT | Low water mark of a socket buffer. |
636+
+----------------------------+--------------------------------------------+
637+
638+
:const:`KQ_FILTER_VNODE` filter flags:
639+
640+
+----------------------------+--------------------------------------------+
641+
| Constant | Meaning |
642+
+============================+============================================+
643+
| .. data:: KQ_NOTE_DELETE | *unlink()* was called. |
644+
+----------------------------+--------------------------------------------+
645+
| .. data:: KQ_NOTE_WRITE | A write occurred. |
646+
+----------------------------+--------------------------------------------+
647+
| .. data:: KQ_NOTE_EXTEND | The file was extended. |
648+
+----------------------------+--------------------------------------------+
649+
| .. data:: KQ_NOTE_ATTRIB | An attribute was changed. |
650+
+----------------------------+--------------------------------------------+
651+
| .. data:: KQ_NOTE_LINK | The link count has changed. |
652+
+----------------------------+--------------------------------------------+
653+
| .. data:: KQ_NOTE_RENAME | The file was renamed. |
654+
+----------------------------+--------------------------------------------+
655+
| .. data:: KQ_NOTE_REVOKE | Access to the file was revoked. |
656+
+----------------------------+--------------------------------------------+
657+
658+
:const:`KQ_FILTER_PROC` filter flags:
659+
660+
+----------------------------+--------------------------------------------+
661+
| Constant | Meaning |
662+
+============================+============================================+
663+
| .. data:: KQ_NOTE_EXIT | The process has exited. |
664+
+----------------------------+--------------------------------------------+
665+
| .. data:: KQ_NOTE_FORK | The process has called *fork()*. |
666+
+----------------------------+--------------------------------------------+
667+
| .. data:: KQ_NOTE_EXEC | The process has executed a new process. |
668+
+----------------------------+--------------------------------------------+
669+
| .. data:: KQ_NOTE_PCTRLMASK| Internal filter flag. |
670+
+----------------------------+--------------------------------------------+
671+
| .. data:: KQ_NOTE_PDATAMASK| Internal filter flag. |
672+
+----------------------------+--------------------------------------------+
673+
| .. data:: KQ_NOTE_TRACK | Follow a process across *fork()*. |
674+
+----------------------------+--------------------------------------------+
675+
| .. data:: KQ_NOTE_CHILD | Returned on the child process for |
676+
| | *NOTE_TRACK*. |
677+
+----------------------------+--------------------------------------------+
678+
| .. data:: KQ_NOTE_TRACKERR | Unable to attach to a child. |
679+
+----------------------------+--------------------------------------------+
680+
681+
:const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):
682+
683+
+----------------------------+--------------------------------------------+
684+
| Constant | Meaning |
685+
+============================+============================================+
686+
| .. data:: KQ_NOTE_LINKUP | Link is up. |
687+
+----------------------------+--------------------------------------------+
688+
| .. data:: KQ_NOTE_LINKDOWN | Link is down. |
689+
+----------------------------+--------------------------------------------+
690+
| .. data:: KQ_NOTE_LINKINV | Link state is invalid. |
691+
+----------------------------+--------------------------------------------+
692692

693693

694694
.. attribute:: kevent.data

0 commit comments

Comments
 (0)