ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Coro/README
(Generate patch)

Comparing Coro/README (file contents):
Revision 1.38 by root, Wed Jun 22 20:24:38 2016 UTC vs.
Revision 1.39 by root, Fri Jul 14 13:14:32 2017 UTC

534 # at this place, the timezone is Antarctica/South_Pole, 534 # at this place, the timezone is Antarctica/South_Pole,
535 # without disturbing the TZ of any other coro. 535 # without disturbing the TZ of any other coro.
536 }; 536 };
537 537
538 This can be used to localise about any resource (locale, uid, 538 This can be used to localise about any resource (locale, uid,
539 current working directory etc.) to a block, despite the existance of 539 current working directory etc.) to a block, despite the existence of
540 other coros. 540 other coros.
541 541
542 Another interesting example implements time-sliced multitasking 542 Another interesting example implements time-sliced multitasking
543 using interval timers (this could obviously be optimised, but does 543 using interval timers (this could obviously be optimised, but does
544 the job): 544 the job):
626 $state->is_new 626 $state->is_new
627 Returns true iff this Coro object is "new", i.e. has never been run 627 Returns true iff this Coro object is "new", i.e. has never been run
628 yet. Those states basically consist of only the code reference to 628 yet. Those states basically consist of only the code reference to
629 call and the arguments, but consumes very little other resources. 629 call and the arguments, but consumes very little other resources.
630 New states will automatically get assigned a perl interpreter when 630 New states will automatically get assigned a perl interpreter when
631 they are transfered to. 631 they are transferred to.
632 632
633 $state->is_zombie 633 $state->is_zombie
634 Returns true iff the Coro object has been cancelled, i.e. it's 634 Returns true iff the Coro object has been cancelled, i.e. it's
635 resources freed because they were "cancel"'ed, "terminate"'d, 635 resources freed because they were "cancel"'ed, "terminate"'d,
636 "safe_cancel"'ed or simply went out of scope. 636 "safe_cancel"'ed or simply went out of scope.
907 It is very common for a coro to wait for some callback to be called. 907 It is very common for a coro to wait for some callback to be called.
908 This occurs naturally when you use coro in an otherwise event-based 908 This occurs naturally when you use coro in an otherwise event-based
909 program, or when you use event-based libraries. 909 program, or when you use event-based libraries.
910 910
911 These typically register a callback for some event, and call that 911 These typically register a callback for some event, and call that
912 callback when the event occured. In a coro, however, you typically want 912 callback when the event occurred. In a coro, however, you typically want
913 to just wait for the event, simplyifying things. 913 to just wait for the event, simplyifying things.
914 914
915 For example "AnyEvent->child" registers a callback to be called when a 915 For example "AnyEvent->child" registers a callback to be called when a
916 specific child has exited: 916 specific child has exited:
917 917
1036 processes. What makes it so bad is that on non-windows platforms, you 1036 processes. What makes it so bad is that on non-windows platforms, you
1037 can actually take advantage of custom hardware for this purpose (as 1037 can actually take advantage of custom hardware for this purpose (as
1038 evidenced by the forks module, which gives you the (i-) threads API, 1038 evidenced by the forks module, which gives you the (i-) threads API,
1039 just much faster). 1039 just much faster).
1040 1040
1041 Sharing data is in the i-threads model is done by transfering data 1041 Sharing data is in the i-threads model is done by transferring data
1042 structures between threads using copying semantics, which is very slow - 1042 structures between threads using copying semantics, which is very slow -
1043 shared data simply does not exist. Benchmarks using i-threads which are 1043 shared data simply does not exist. Benchmarks using i-threads which are
1044 communication-intensive show extremely bad behaviour with i-threads (in 1044 communication-intensive show extremely bad behaviour with i-threads (in
1045 fact, so bad that Coro, which cannot take direct advantage of multiple 1045 fact, so bad that Coro, which cannot take direct advantage of multiple
1046 CPUs, is often orders of magnitude faster because it shares data using 1046 CPUs, is often orders of magnitude faster because it shares data using

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines