Result:
found more than 668 distributions - search limited to the first 2001 files matching your query
( run in 3.100 )
Alien-libssh
view release on metacpan or search on metacpan
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
karr list # the open cards
karr list --status todo,in-progress # filter by status
karr list --priority high,critical # filter by priority
karr list --tag backend # filter by tag
karr list --class expedite # filter by class of service
karr list --blocked # only the blocked cards
karr list --not-blocked # only the unblocked ones
karr list --archived # the archive, and nothing else
karr list -s "search term" # search title/body/tags
karr list --sort priority --reverse # sort and reverse
karr list --sort priority -n 5 --json # the five most urgent open cards
karr list --claimed-by agent-1 # filter by claim owner
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
answers by *taking* the card, so this is how to see the free work without
touching it, and it uses the very test `pick` uses. It is not the opposite of
`--claimed-by NAME`: that one is an exact match on the field and matches an
expired claim too, so the two overlap on "cards NAME no longer holds" and
passing both is a usage error. Since it asks about the claim and nothing else,
a blocked card nobody holds is still listed -- `--blocked --unclaimed` is a
real triage query.
### Show task
```bash
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
karr edit ID --remove-needs other-repo#7 # absent references are a no-op
karr edit ID --body "New description"
karr edit ID -a "Appended note" # append to body
karr edit ID --claim agent-1 # claim
karr edit ID --release # release claim
karr edit ID --block "Waiting on API" # mark blocked
karr edit ID --unblock # clear blocked
```
An unknown or non-numeric id given to `--depends-on`/`--add-depends-on` rejects
the whole invocation before anything is written (usage error, exit 2); a
self-reference (`karr edit 5 --add-depends-on 5`) fails only that id, the rest
of the batch proceeds, and the command exits 1. Taking up a card whose
dependencies are unfinished warns on move/pick but is never blocked.
### Delete task
```bash
karr delete ID # asks first
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
karr pick --claim agent-1 --status todo --move in-progress
karr pick --claim agent-1 --tags backend
karr pick --claim agent-1 --compact # stop after the assignment line
```
Atomically finds and claims the next available task. Respects claim timeouts, blocked state, and class-of-service priority ordering (expedite > fixed-date > standard > intangible); where two `fixed-date` cards meet, the due date is asked before prior...
### Unlock a stuck task
```bash
karr unlock # list the pick locks currently held
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
`--board NAME=PATH` or from the fleet config
(`~/.config/karr-foundation/config.yml`, `--fleet-config` to point elsewhere),
matching the repository's directory basename.
`--resolve` settles a link whose far card has reached one of the **far** board's
own terminal statuses, and lifts the `blocked` flag when a card's last link
settles, printing the reason it lifted. A far card that does not exist settles
nothing. A board this machine cannot place is reported, not fatal.
Like `depends_on`, a cross-board link blocks nothing by itself: `pick` hands the
card over and says what it waits on. The `blocked` flag is what keeps the card
out of `pick` and out of karr-foundation's selection -- the link is the fact,
`blocked` is the decision.
### Config
```bash
karr config # show all config values
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
### Context (board summary for embedding)
```bash
karr context # print markdown summary
karr context --write-to AGENTS.md # create/update file with sentinels
karr context --sections blocked,overdue # filter sections
karr context --days 14 # lookback for recently-completed
karr context --activity-limit 10 # other agents' log entries in Recent Activity
karr context --json # JSON output
karr context --compact # board_name and the four counts, key=value
```
Generates a markdown summary with sections: In Progress, Blocked, Overdue, Recently Completed, Recent Activity (other agents' log entries, newest first, bounded by `--activity-limit`, default 5). `--sections` takes the slugs `in-progress,blocked,over...
### Skill management
```bash
karr skill install # install skill for detected agents
.claude/skills/kanban-issues-karr-cli/SKILL.md view on Meta::CPAN
2. **New work item?** → `karr create "Title" --priority high`
3. **What's on the board?** → `karr board` or `karr list`
4. **Starting work?** → `karr pick --claim NAME --move in-progress`
5. **Done with task, hand to review?** → `karr handoff ID --claim NAME --note "reason"`
6. **Done with task, close it?** → `karr edit ID --release && karr move ID done`
7. **Blocked?** → `karr edit ID --block "reason"`
8. **Need details?** → `karr show ID`
9. **Soft-delete?** → `karr archive ID`
10. **Board snapshot for agent context?** → `karr context --write-to AGENTS.md`
11. **Check/change config?** → `karr config` / `karr config set KEY VALUE`
12. **Install agent skills?** → `karr skill install`
Alien-parasail
view release on metacpan or search on metacpan
lib/Alien/parasail.pm view on Meta::CPAN
=item L<parasail|https://github.com/jeffdaily/parasail>
The parasail library home page.
parasail is a SIMD C (C99) library containing implementations of the Smith-Waterman (local), Needleman-Wunsch (global), and various semi-global pairwise sequence alignment algorithms. Here, semi-global means insertions before the start or after the e...
parasail implements the above algorithms currently in three variants, 1) returning the alignment score and ending locations, 2) additionally returning alignment statistics (number of exact matches, number of similarities, and alignment length), and 3...
=item L<Alien>
Alien-uv
view release on metacpan or search on metacpan
libuv/docs/src/design.rst view on Meta::CPAN
#. The loop blocks for I/O. At this point the loop will block for I/O for the duration calculated
in the previous step. All I/O related handles that were monitoring a given file descriptor
for a read or write operation get their callbacks called at this point.
#. Check handle callbacks are called. Check handles get their callbacks called right after the
loop has blocked for I/O. Check handles are essentially the counterpart of prepare handles.
#. Close callbacks are called. If a handle was closed by calling :c:func:`uv_close` it will
get the close callback called.
#. Special case in case the loop was run with ``UV_RUN_ONCE``, as it implies forward progress.
AlignDB-Stopwatch
view release on metacpan or search on metacpan
lib/AlignDB/Stopwatch.pm view on Meta::CPAN
$stopwatch->record_conf( $opt );
=head2 block_message
Print a blocked message
$stopwatch->block_message( $message, $with_duration );
=head2 start_message
Alt-Crypt-OpenSSL-PKCS12-Broadbean
view release on metacpan or search on metacpan
get_av|5.006000|5.003007|p
getc|5.003007||Viu
get_c_backtrace|5.021001||Vi
get_c_backtrace_dump|5.021001||V
get_context|5.006000|5.006000|nu
getc_unlocked|5.003007||Viu
get_cv|5.006000|5.003007|p
get_cvn_flags|5.009005|5.003007|p
get_cvs|5.011000|5.003007|p
getcwd_sv|5.007002|5.007002|
get_db_sub|||iu
PERL_MALLOC_WRAP|5.009002|5.009002|Vn
PerlMem_calloc|5.006000||Viu
PerlMem_free|5.005000||Viu
PerlMem_free_lock|5.006000||Viu
PerlMem_get_lock|5.006000||Viu
PerlMem_is_locked|5.006000||Viu
PerlMem_malloc|5.005000||Viu
PERL_MEMORY_DEBUG_HEADER_SIZE|5.019009||Viu
PerlMemParse_calloc|5.006000||Viu
PerlMemParse_free|5.006000||Viu
PerlMemParse_free_lock|5.006000||Viu
PerlMemParse_get_lock|5.006000||Viu
PerlMemParse_is_locked|5.006000||Viu
PerlMemParse_malloc|5.006000||Viu
PerlMemParse_realloc|5.006000||Viu
PerlMem_realloc|5.005000||Viu
PerlMemShared_calloc|5.006000||Viu
PerlMemShared_free|5.006000||Viu
PerlMemShared_free_lock|5.006000||Viu
PerlMemShared_get_lock|5.006000||Viu
PerlMemShared_is_locked|5.006000||Viu
PerlMemShared_malloc|5.006000||Viu
PerlMemShared_realloc|5.006000||Viu
PERL_MG_UFUNC|5.007001||Viu
Perl_modf|5.006000|5.006000|n
PERL_MULTICONCAT_HEADER_SIZE|5.027006||Viu
putc|5.003007||Viu
put_charclass_bitmap_innards|5.021004||Viu
put_charclass_bitmap_innards_common|5.023008||Viu
put_charclass_bitmap_innards_invlist|5.023008||Viu
put_code_point|5.021004||Viu
putc_unlocked|5.003007||Viu
putenv|5.005000||Viu
put_range|5.019009||Viu
putw|5.003007||Viu
pv_display|5.006000|5.003007|p
pv_escape|5.009004|5.003007|p
Alvis-Pipeline
view release on metacpan or search on metacpan
lib/Alvis/Pipeline/Read.pm view on Meta::CPAN
$this->_write_and_unlock($dir, $fh, $lastread, $lastwrite);
}
# A sequence file called "seq" is maintained in the spool directory,
# and is always locked when read and rewritten. The invariant it
# preserves between lock-read-write operations is that it contains two
# numbers, space-serarate, followed by a newline. The first number is
# that of the last document read from the spool directory. The second
# number is that of the last document written to the spool directory,
# or zero if no document has yet been written. If the two numbers are
# equal, there are no documents available to be read.
#
# _lock_and_read() and _write_and_unlock() together implement safe
# maintenance of the sequence file. The former returns a filehandle,
# locked; it is the caller's responsibility to unlock the returned
# filehandle using _write_and_unlock(), like this:
# ($fh, $lastread, $lastwrite) = $this->_lock_and_read($dir);
# # Do some stuff
# $this->_write_and_unlock($dir, $fh, $lastread, $lastwrite);
#
Amazon-DynamoDB-Simple
view release on metacpan or search on metacpan
cpanfile.snapshot view on Meta::CPAN
Kavorka::Sub::Method 0.036
Kavorka::Sub::ObjectMethod 0.036
Kavorka::Sub::Override 0.036
Kavorka::TraitFor::Parameter::alias 0.036
Kavorka::TraitFor::Parameter::assumed 0.036
Kavorka::TraitFor::Parameter::locked 0.036
Kavorka::TraitFor::Parameter::optional 0.036
Kavorka::TraitFor::Parameter::ref_alias 0.036
Kavorka::TraitFor::Parameter::ro 0.036
Kavorka::TraitFor::ReturnType::assumed 0.036
Kavorka::TraitFor::Sub::begin 0.036
Amazon-S3-Lite
view release on metacpan or search on metacpan
lib/Amazon/S3/Lite.pm view on Meta::CPAN
restrict_public_buckets => 0,
);
Sets the Block Public Access configuration on a bucket. Each of the
four settings is a boolean; any setting not supplied B<defaults to
true> (fully locked down), so an argument-less call blocks all public
access. Returns a true value on success.
=over 4
=item block_public_acls
Amazon-SQS-Client
view release on metacpan or search on metacpan
lib/Amazon/SQS/Client.pm view on Meta::CPAN
=head2 deleteMessage
deleteMessage( request )
The C<DeleteMessage> action unconditionally removes the specified message
from the specified queue. Even if the message is locked by another
reader due to the visibility timeout setting, it is still deleted from
the queue.
Returns an C<Amazon::SQS::Model::DeleteMessageResponse> object.
AmberDB
view release on metacpan or search on metacpan
lib/AmberDB/Base/Transact.pm view on Meta::CPAN
$self->_txn_apply_rollback(\@lines);
unlink $orphan;
}
else {
# File is actively locked by a living process — skip safely (race-condition free)
close $ofh;
next;
}
}
Amethyst
view release on metacpan or search on metacpan
Amethyst/Brain/Infobot/Module/Zippy.pm view on Meta::CPAN
RHAPSODY in Glue!
SANTA CLAUS comes down a FIRE ESCAPE wearing bright blue LEG WARMERS ... He scrubs the POPE with a mild soap or detergent for 15 minutes, starring JANE FONDA!!
Send your questions to ``ASK ZIPPY'', Box 40474, San Francisco, CA 94140, USA
SHHHH!! I hear SIX TATTOOED TRUCK-DRIVERS tossing ENGINE BLOCKS into empty OIL DRUMS ...
Should I do my BOBBIE VINTON medley?
Should I get locked in the PRINCICAL'S OFFICE today -- or have a VASECTOMY??
Should I start with the time I SWITCHED personalities with a BEATNIK hair stylist or my failure to refer five TEENAGERS to a good OCULIST? Sign my PETITION.
So this is what it feels like to be potato salad
So, if we convert SUPPLY-SIDE SOYABEAN FUTURES into HIGH-YIELD T-BILL INDICATORS, the PRE-INFLATIONARY risks will DWINDLE to a rate of 2 SHOPPING SPREES per EGGPLANT!!
Someone in DAYTON, Ohio is selling USED CARPETS to a SERBO-CROATIAN
Sometime in 1993 NANCY SINATRA will lead a BLOODLESS COUP on GUAM!!
Ancient
view release on metacpan or search on metacpan
lib/object.pm view on Meta::CPAN
Set the prototype object. Fails if object is frozen.
=head2 $obj->lock
Prevent adding new properties. Can be unlocked.
=head2 $obj->unlock
Allow adding new properties again. Fails if frozen.
lib/object.pm view on Meta::CPAN
=head2 $obj->is_frozen
Returns true if object is frozen.
=head2 $obj->is_locked
Returns true if object is locked (but may not be frozen).
=head2 object::clone($obj)
Create a shallow copy of an object. All property values are copied, but
references share the same underlying referent. The clone is a fresh object
that is NOT frozen or locked, even if the original was.
my $original = new Cat name => 'Whiskers', age => 3;
object::freeze($original);
my $clone = object::clone($original);
Android-ElectricSheep-Automator
view release on metacpan or search on metacpan
lib/Android/ElectricSheep/Automator.pm view on Meta::CPAN
enquiry and subsequent control can commence.
If this is not called and neither C<device-is-connected =E<gt> 1>
is specified as a parameter to the constructor, then
the functionality will be limited and access
to functions like L</swipe($params)>, L</open_app($params)>, etc.
will be blocked until the caller signals that
a device is now connected to the desktop.
Using L</connect_device($params)> to specify which device
to target in the case of multiple devices
connected to the desktop will also call this
Anki-Import
view release on metacpan or search on metacpan
lib/Anki/Import.pm view on Meta::CPAN
=head3 Getting the most from C<Anki::Import>
By itself, C<Anki::Import> will make it easier for you to format and
input your notes especially if you do a lot of basic HTML formatting. However,
the huge productivity gains of C<Anki::Import> can only be unlocked by getting
proficient wih your text editor of choice.
For example, you can generate templates for each of the note types you use to
make data entry exceptionally painless. And with a text editor like vim, you
can automate the generation of the formatting codes used by C<Anki::Import>
AnyEvent-Campfire-Client
view release on metacpan or search on metacpan
examples/test.pl view on Meta::CPAN
if ( $hdr->{Status} !~ m/2/ ) {
$client->emit( 'error', "$hdr->{Status}: $hdr->{Reason}" );
$client->exit;
}
else {
print "$hdr->{Status}: locked room\n";
$client->unlock(
'535881',
sub {
my ( $body, $hdr ) = @_;
if ( $hdr->{Status} !~ m/2/ ) {
$client->emit( 'error',
"$hdr->{Status}: $hdr->{Reason}" );
$client->exit;
}
else {
print "$hdr->{Status}: unlocked room\n";
$client->exit;
}
}
);
}
AnyEvent-ConnPool
view release on metacpan or search on metacpan
lib/AnyEvent/ConnPool.pm view on Meta::CPAN
$self->{index} = 0;
}
my $retval = $self->{_payload}->[$self->{index}];
if ($retval->locked()) {
$self->{locked}->{$self->{index}} = 1;
$retval = $self->get_free_connection($self->{index});
}
else {
delete $self->{locked}->{$self->{index}};
}
if (wantarray) {
$self->{index}++;
return ($index, $retval);
lib/AnyEvent/ConnPool.pm view on Meta::CPAN
my $retval = undef;
my @balanced_array = $self->balance_array($desired_index);
for my $i (@balanced_array) {
my $conn = $self->{_payload}->[$i];
unless ($conn->locked) {
$retval = $conn;
$self->{index} = $i;
last;
}
}
lib/AnyEvent/ConnPool.pm view on Meta::CPAN
my ($index, $constructor) = ($opts{index}, $opts{constructor});
my $unit = {
_conn => $object,
_locked => 0,
_index => $index,
_constructor => $constructor,
};
bless $unit, $class;
lib/AnyEvent/ConnPool.pm view on Meta::CPAN
=cut
sub lock {
my ($self) = @_;
$self->{_locked} = 1;
return 1;
}
=item B<unlock>
lib/AnyEvent/ConnPool.pm view on Meta::CPAN
=cut
sub unlock {
my ($self) = @_;
delete $self->{_locked};
return 1;
}
=item B<locked>
Returns true if connection is locked.
if ($connection->locked()) {
...
}
=cut
sub locked {
my ($self) = @_;
return $self->{_locked};
}
sub index {
my ($self) = @_;
AnyEvent-CouchDB
view release on metacpan or search on metacpan
lib/AnyEvent/CouchDB.pm view on Meta::CPAN
Main programs are "allowed to call C<recv> blockingly", according to the
author of L<AnyEvent>.
=item or you're in a Coro + AnyEvent environment.
When you call C<recv> inside a coroutine, only that coroutine is blocked
while other coroutines remain active. Thus, the program as a whole is
still responsive.
=back
AnyEvent-Digest
view release on metacpan or search on metacpan
lib/AnyEvent/Digest.pm view on Meta::CPAN
This method uses blocking wait + C<addfile_async()>.
=head2 C<addfile_base()>
Forwarded to C<addfile()> in the base module. If you need to avoid blocking wait somewhere, this might be helpful.
However, during the call, other L<AnyEvent> watchers are blocked.
=head1 SEE ALSO
=over 4
AnyEvent-FileLock
view release on metacpan or search on metacpan
lib/AnyEvent/FileLock.pm view on Meta::CPAN
=item len => $len
When C<fcntl> is selected as the lock type, this three additional
arguments can be used to define the section of the file that has to be
locked. See L<fcntl(2)> for the details.
=back
=head1 SEE ALSO
AnyEvent-Filesys-Watcher
view release on metacpan or search on metacpan
lib/AnyEvent/Filesys/Watcher/ReadDirectoryChanges/Queue.pod view on Meta::CPAN
handle is nonsense (currently an arbitrary number of "1" characters).
It is also dangerous, at least for single-threaded applications, because the
call will block if there is no data available in the queue. For a
single-threaded application that would lead to a deadlock, because while
being blocked, no data can be enqueued.
=item B<enqueue(ITEMS)>
See L<Thread;:Queue/enqueue>.
AnyEvent-HTTP
view release on metacpan or search on metacpan
(this can be suppressed by using C<undef> for these headers in which case
they won't be sent at all).
You really should provide your own C<User-Agent:> header value that is
appropriate for your program - I wouldn't be surprised if the default
AnyEvent string gets blocked by webservers sooner or later.
Also, make sure that your headers names and values do not contain any
embedded newlines.
=item timeout => $seconds
AnyEvent-JSONRPC-Lite
view release on metacpan or search on metacpan
lib/AnyEvent/JSONRPC/Lite/Client.pm view on Meta::CPAN
Main programs are "allowed to call C<recv> blockingly", according to the
author of L<AnyEvent>.
=item or you're in a Coro + AnyEvent environment.
When you call C<recv> inside a coroutine, only that coroutine is blocked
while other coroutines remain active. Thus, the program as a whole is
still responsive.
=back
AnyEvent-JSONRPC
view release on metacpan or search on metacpan
lib/AnyEvent/JSONRPC/HTTP/Client.pm view on Meta::CPAN
Main programs are "allowed to call C<recv> blockingly", according to the
author of L<AnyEvent>.
=item or you're in a Coro + AnyEvent environment.
When you call C<recv> inside a coroutine, only that coroutine is blocked
while other coroutines remain active. Thus, the program as a whole is
still responsive.
=back
AnyEvent-MP
view release on metacpan or search on metacpan
MP/Intro.pod view on Meta::CPAN
=head1 Message Passing for the Non-Blocked Mind
=head1 Introduction and Terminology
This is a tutorial about how to get the swing of the L<AnyEvent::MP>
module family, which allows processes to transparently pass messages to
AnyEvent-MPRPC
view release on metacpan or search on metacpan
lib/AnyEvent/MPRPC/Client.pm view on Meta::CPAN
Main programs are "allowed to call C<recv> blockingly", according to the
author of L<AnyEvent>.
=item or you're in a Coro + AnyEvent environment.
When you call C<recv> inside a coroutine, only that coroutine is blocked
while other coroutines remain active. Thus, the program as a whole is
still responsive.
=back
AnyEvent-RabbitMQ
view release on metacpan or search on metacpan
share/fixed_amqp0-8.xml view on Meta::CPAN
no due to security settings.
</constant>
<constant name="not found" value="404" class="soft error">
The client attempted to work with a server entity that does not exist.
</constant>
<constant name="resource locked" value="405" class="soft error">
The client attempted to work with a server entity to which it has
no access because another client is working with it.
</constant>
<constant name="frame error" value="501" class="hard error">
The client sent a malformed frame that the server could not decode.
share/fixed_amqp0-8.xml view on Meta::CPAN
access the queue.
</doc>
<doc name = "rule" test = "amq_file_00">
If the server cannot grant exclusive access to the queue when asked,
- because there are other consumers active - it MUST raise a channel
exception with return code 405 (resource locked).
</doc>
</field>
<field name = "nowait" type = "bit">
do not send a reply method
share/fixed_amqp0-8.xml view on Meta::CPAN
access the queue.
</doc>
<doc name = "rule" test = "amq_file_00">
If the server cannot grant exclusive access to the queue when asked,
- because there are other consumers active - it MUST raise a channel
exception with return code 405 (resource locked).
</doc>
</field>
<field name = "nowait" type = "bit">
do not send a reply method
AnyEvent-Radius
view release on metacpan or search on metacpan
lib/AnyEvent/Radius/Client.pm view on Meta::CPAN
$client1->on_ready($cv);
$client2->on_ready($cv);
$client3->on_ready($cv);
$cv->recv;
Will be blocked until all clients finish their queue.
=item destroy()
Destroy the internal socket handle. Must be called when object is no longer required.
When called from callback, it is recommended to wrap this call into AnyEvent::postpone { ... } block.
AnyEvent-Tools
view release on metacpan or search on metacpan
lib/AnyEvent/Tools.pm view on Meta::CPAN
=head1 FUNCTIONS
=head2 mutex
returns unlocked mutex.
This object provides the following methods:
=head3 lock(CODEREF)
You declare that You want to lock mutex. When it is possible the mutex will
be locked and Your callback will be called.
If the method is called in non-void context it returns guard object which can
be destroyed. So if You want You can cancel Your lockrequest.
Example:
lib/AnyEvent/Tools.pm view on Meta::CPAN
undef $guard; # unlock mutex
});
The callback receives a guard (see L<AnyEvent::Util#guard>) which unlocks the
mutex. Hold the guard while You need locked resourse.
=head3 is_locked
Returns B<TRUE> if mutex is locked now. Usually You shoudn't
use the function.
=head2 rw_mutex
returns unlocked read-write mutex.
This object provides the following methods:
=head3 rlock(CODEREF)
You declare that You want to lock mutex for reading. When it is
possible the mutex will be locked and Your callback will be called.
There may be a lot of read processes running simultaneously
that catch the lock.
=head3 wlock(CODEREF).
You declare that You want to lock mutex for writing. When it is
possible the mutex will be locked and Your callback will be called.
There may be only one write process that catches the lock.
Both callbacks receive a guard to hold the mutex locked.
=head3 rlock_limit(NUMBER)
Get/Set count limit for rlock. If an rlock request is come and this limit
is reached the request will be queued.
=head3 is_locked
Returns B<TRUE> if the mutex has 'read' or 'write' lock status.
=head3 is_rlocked
Returns B<TRUE> if the mutex has 'read' lock status.
B<Important>: this method returns B<FALSE> if the mutex is
wlocked (L<is_wlocked>), so if You want to know if any lock
is set, use the function L<is_locked>.
=head3 is_wlocked
Returns B<TRUE> if the mutex has 'write' lock status.
Usually You shoudn't use is_[rw]?locked functions.
=head2 async_repeat(COUNT, CALLBACK [, DONE_CALLBACK ])
Repeats calling Your callback(s).
AnyEvent
view release on metacpan or search on metacpan
lib/AnyEvent/IO.pm view on Meta::CPAN
automatically - that is, something I<pushes> data towards your file
handle, without you having to do anything. Non-blocking means that if
your operating system currently has no data (or EOF, or some error)
available for you, it will not wait ("block") as it would normally do,
but immediately return with an error (e.g. C<EWOULDBLOCK> - "I would have
blocked, but you forbid it").
Your program can then wait for data to arrive by other means, for example,
an I/O watcher which tells you when to re-attempt the read, after which it
can try to read again, and so on.
( run in 3.100 seconds using v1.01-cache-2.11-cpan-800906f7e73 )