develooper Front page | perl.perl5.porters | Postings from October 2003

[perl #24353] kill() --- POD needs a hand

Thread Next
From:
perlbug-followup
Date:
October 29, 2003 20:17
Subject:
[perl #24353] kill() --- POD needs a hand
Message ID:
rt-24353-66695.14.2584680117178@rt.perl.org
# New Ticket Created by  Michael.Jacob@SCHERING.DE 
# Please include the string:  [perl #24353]
# in the subject line of all future correspondence about this issue. 
# <URL: http://rt.perl.org/rt2/Ticket/Display.html?id=24353 >


To: perlbug@perl.org
Subject: "kill SIGNAL, undef"?
Reply-To: micaja@de.ibm.com
Message-Id: <5.8.0_2904_1067423076@SCHNARCHNASE>

This is a bug report for perl from micaja@de.ibm.com,
generated with the help of perlbug 1.34 running under perl v5.8.0.


-----------------------------------------------------------------
[Please enter your report here]

$ perl -e 'print kill 0, undef, undef'
2

Ok, this is fairly clear to me, but it may puzzle many
people. (And has, here :-))

I'd think the semantics of a PID=0 should be documented in
perlfunc. It may even be wise to let kill() ignore undef
parameters...


Also I found the following in the PODs:

perlfunc/kill:
Unlike in the shell, if SIGNAL is negative, it kills process
groups instead of processes. (On System V, a negative *PROCESS*
number will also kill process groups, but that's not portable.)

perlipc:
Sending a signal to a negative process ID means that you send the signal
to the entire Unix process-group.

This should be cleared up, I'd say...

[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
    category=docs
    severity=wishlist
---
Site configuration information for perl v5.8.0:

Configured by Gerrit at Fri Aug 29 11:53:54 CEST 2003.

Summary of my perl5 (revision 5.0 version 8 subversion 0) configuration:
  Platform:
    osname=cygwin, osvers=1.3.22(0.7832), archname=cygwin-multi-64int
    uname='cygwin_nt-5.0 ismene 1.3.22(0.7832) 2003-03-18 09:20 i586
unknown unknown cygwin '
    config_args='-de -Dmksymlinks -Dusemultiplicity -Duse64bitint
-Doptimize=-O3 -Dman3ext=3pm'
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=undef use5005threads=undef useithreads=undef
usemultiplicity=define
    useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
    use64bitint=define use64bitall=undef uselongdouble=undef
    usemymalloc=y, bincompat5005=undef
  Compiler:
    cc='gcc', ccflags ='-DPERL_USE_SAFE_PUTENV -fno-strict-aliasing',
    optimize='-O3',
    cppflags='-DPERL_USE_SAFE_PUTENV -fno-strict-aliasing'
    ccversion='', gccversion='3.2 20020927 (prerelease)', gccosandvers=''
    intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=12345678
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12
    ivtype='long long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t',
lseeksize=4
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='ld2', ldflags =' -s -L/usr/local/lib'
    libpth=/usr/local/lib /usr/lib /lib
    libs=-lgdbm -ldb -lcrypt -lutil -lgdbm_compat
    perllibs=-lcrypt -lutil -lgdbm_compat
    libc=/usr/lib/libc.a, so=dll, useshrplib=true, libperl=libperl.a
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=dll, d_dlsymun=undef, ccdlflags=' -s'
    cccdlflags=' ', lddlflags=' -s -L/usr/local/lib'

Locally applied patches:


---
@INC for perl v5.8.0:
    /usr/lib/perl5/5.8.0/cygwin-multi-64int
    /usr/lib/perl5/5.8.0
    /usr/lib/perl5/site_perl/5.8.0/cygwin-multi-64int
    /usr/lib/perl5/site_perl/5.8.0
    /usr/lib/perl5/site_perl
    .

---
Environment for perl v5.8.0:
    HOME=/home/MichaelJacob
    LANG (unset)
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)

PATH=/usr/local/bin:/usr/bin:/bin:/cygdrive/c/WINNT/system32:/cygdrive/c/WINNT:/cygdrive/c/WINNT/system32/WBEM:/cygdrive/c/perl580/bin:/usr/bin:/cygdrive/c/Program

Files/UltraEdit:/cygdrive/c/PROGRA~1/IBM/SQLLIB/BIN:/cygdrive/c/PROGRA~1/IBM/SQLLIB/FUNCTION:/cygdrive/c/PROGRA~1/IBM/SQLLIB/SAMPLES/REPL:/cygdrive/c/WINNT/system32:/cygdrive/c/WINNT:/cygdrive/c/WINNT/system32/WBEM:/cygdrive/c/perl580/bin:/usr/bin:/usr/X11R6/bin
    PERL_BADLANG (unset)
    SHELL (unset)




Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About