Source Code 1994 March/Source_Code_CD-ROM_Walnut_Creek_March_1994.iso/compsrcs/misc/volume37/perlref/part03

Text File | 1993-05-18 | 55.6 KB | 1,189 lines

Newsgroups: comp.sources.misc
From: [e-mail] (Johan Vromans)
Subject: v37i084:  perlref - Perl Reference Guide 4.036.1, Part03/03
Message-ID: <[e-mail]>
X-Md4-Signature: aca1905fa1d2de1cae8ef44fb5422df8
Date: Wed, 19 May 1993 21:21:59 GMT
Approved: [e-mail]

Submitted-by: [e-mail] (Johan Vromans)
Posting-number: Volume 37, Issue 84
Archive-name: perlref/part03
Environment: Perl v4.036
Supersedes: perlref: Volume 32, Issue 1-4

#! /bin/sh
# This is a shell archive.  Remove anything before this line, then feed it
# into a shell via "sh file" or similar.  To overwrite existing files,
# type "sh file -c".
# Contents:  ChangeLog Makefile parr refbase.ps.B
# Wrapped by kent@sparky on Wed May 19 14:08:37 1993
PATH=/bin:/usr/bin:/usr/ucb:/usr/local/bin:/usr/lbin ; export PATH
echo If this archive is complete, you will see the following message:
echo '          "shar: End of archive 3 (of 3)."'
if test -f 'ChangeLog' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'ChangeLog'\"
else
  echo shar: Extracting \"'ChangeLog'\" \(4685 characters\)
  sed "s/^X//" >'ChangeLog' <<'END_OF_FILE'
XTue May 18 10:05:18 1993  Johan Vromans  (jv@largo)
X
X    ==== Released 4.036.1 ====
X
X    * README 2.6:
X      Update to 4.036. Add info about the japanese version.
X
X    * Makefile 2.9:
X      Update to 4.036.
X
X    * MANIFEST: new file.
X
X    * refbase.sty 2.6:
X      Update revision to 4.036.
X
X    * ch02.tex 2.5:
X      Add exception for \' and \\ in ''-strings.
X
X    * ch06.tex 2.3:
X      Add unary ! and ~ .
X
X    * ch07.tex 2.4:
X      Correct -M to file modification.
X
X    * ch99.tex 2.4:
X      Update.
X
XThu Sep  3 16:18:25 1992  Johan Vromans  (jv at largo)
X
X    * Makefile 2.8:
X      Combine PostScript and LaTeX in one posting.
X
XWed Sep  2 15:18:08 1992  Johan Vromans  (jv at largo)
X
X    ==== Released 4.035.1 ====
X
X    * Makefile 2.7:
X      Updated to 4.035.
X      Add symbols for LATEX and DVIPS.
X      Add entry for guide-test.ps.
X      Add chapter 27.
X      Do not run psneat since it produces incorrect code.
X
X    * ch22.tex 2.5:
X      Refer to manual for scalar return values.
X      Change 'Info is' to 'Returns'.
X
X    * ch00.tex 2.4:
X      Decrease space before the table of contents.
X      Add chapter 27.
X
X    * ch99.tex 2.3:
X      Eliminate \newpage (moved to refmaster.tex).
X
X    * ch27.tex 1.2:
X      New chapter 'Environment variables'.
X
X    * ch24.tex 2.3:
X      $^L: New in 4.035.
X
X    * ch16.tex 2.3:
X      s: Note bracketing quotes. Not a 4.035 feature.
X
X    * ch13.tex 2.3:
X      stat: Indicate return of null list if the call fails.
X
X    * ch11.tex 2.3:
X      eval: Fix typo run-time.
X      rindex: Shorten description so substr fits on the same page.
X
X    * ch07.tex 2.3:
X      Add gid to -rR/wW/xX. Separate -oO.
X      -s: Make separate entry. Indicate that it returns the
X      size. Not a 4.035 feature.
X
X    * ch04.tex 2.3:
X      Make semicolon at end of BLOCK optional.
X
X    * ch02.tex 2.4:
X      numeric: Add '1_2345' format (blech).
X
X    * ch01.tex 2.4:
X      -0: Change 'See also -L'to 'See also '-l' (typo).
X
X    * refbase.sty 2.5:
X      Updated to 4.035. Add \makeupspace.
X
X    * refmaster.tex 2.3:
X      Add chapter 27. Change makeups.
X
X    * README 2.5:
X      Updated to 4.035.
X
XFri May 22 09:14:22 1992  Johan Vromans  (jv at largo)
X
X    * refbase.sty 2.4:
X      Michael Jaegermann, who donated the NFSS code, used his wife's
X      account for mailing me, so his wife got the credits instead.
X
XThu Apr  9 16:25:29 1992  Johan Vromans  (jv at largo)
X
X    * ch22:
X      "...does include not OK."  You may want to change it to read
X      "...does not include OK."
X      Thanks to Ron Pool, [e-mail]
X
XTue Mar  3 12:46:00 1992  Johan Vromans  (jv at largo)
X
X    * ch01: Correct '-L' to '-l'.
X      Thanks to Chris Eich <[e-mail]>.
X
X    * ch10: Add v/V to TEMPLATE.
X      Thanks to DaviD W. Sanderson ([e-mail])
X
XWed Feb 19 15:02:26 1992  Johan Vromans  (jv at largo)
X
X     * Released to USEnet. Official version is 4.019.1.
X
X    * refbase.sty: add support for new font selection scheme.
X      Get rid of overfull hboxes.
X
X    * refbase.sty, refmaster.tex, ch*.tex: update for 4.019.
X      Add description for "sort { EXPR;...} @array" .
X      Describe "eval { ... }" .
X      Add "scalar(@array)" and "scalar(%array)" .
X      Small corrections.
X
X    * Makefile: new kit assembly.
X
XTue Aug 27 18:41:42 1991  Johan Vromans  (jv at largo)
X
X    * ch22: add 'gethostbyaddr'
X
XFri Aug  2 09:44:47 1991  Johan Vromans  (jv at largo)
X
X    * parr: add code for duplex printing.
X
X    * README: describe duplex printing, version number.
X
XSat Jul 27 15:23:01 1991  Johan Vromans  (jv at pronto)
X
X    * parr: Adjusted '%%Pages:' to reflect actual number of sheets.
X
XFri Jul 26 23:10:00 1991  Johan Vromans  (jv at pronto)
X
X    * Add Layout document that describes in more detail how the
X      Reference Guide should look like.
X
X    * Makefile/README: Incorporate Layout.
X
XFri Jul 26 09:15:58 1991  Johan Vromans  (jv at largo)
X
X    * Released to USEnet (patch). Official version is 4.010.2.1.
X
X    * ch04: typo: | -> || (two locations)
X
X    * parr: slightly increase $topmargin for US paper.
X
X    * ch06: typo: log or/and | & -> || &&
X
XThu Jul 25 11:11:24 1991  Johan Vromans  (jv at largo)
X
X    * Makefile/README: Clarify the use of guide-{odd,even?}.ps.
X
X    * parr: Suppress extraneous %%Page comments to obtain more
X      conformant PostScript. Some PS viewers and printers (or
X      print-spoolers) seem to choke in these extraneous comments.
X
X      Set $leftmargin to 0 for US-Letter format. According to most
X      respondents this seems to be the correct value.
X
XTue Jul 23 18:32:54 1991  Johan Vromans  (jv at largo)
X
X    * Makefile: allow MASTER=test for testing.
X
X    * ch03: typo: $var -> $#var is last element of array.
X
X    * ch00: move front page info a bit down/right.
X
XMon Jul 22 22:05:57 1991  Johan Vromans  (jv at pronto)
X
X    * ch00: typo: deigned -> designed.
X
XSat Jul 20 00:31:47 1991  Johan Vromans  (jv at pronto)
X
X    * Released to USEnet. Official version is 4.010.1.8.
X
X    * This is a brand new version.
X
END_OF_FILE
  if test 4685 -ne `wc -c <'ChangeLog'`; then
    echo shar: \"'ChangeLog'\" unpacked with wrong size!
  fi
  # end of 'ChangeLog'
fi
if test -f 'Makefile' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'Makefile'\"
else
  echo shar: Extracting \"'Makefile'\" \(2931 characters\)
  sed "s/^X//" >'Makefile' <<'END_OF_FILE'
X# @(#)@ Makefile 4.2.9 - Makefile for Perl Reference Guide
X
X# This Makefile requires perl to be in your PATH.
X
XSHELL    = /bin/sh
XLATEX    = latex
XDVIPS    = dvips
X
X# Delete the next line if you use US Letter paper format
XPAPER    = -a4
X
Xall:    refguide.ps
X
X2pass:    guide-odd.ps guide-even1.ps guide-even2.ps
X
X# 2 pages per page, suitable for centrefold printing.
Xrefguide.ps:    refbase.ps parr
X    perl ./parr $(PAPER) \
X        -o 21,2,3,20,19,4,5,18,17,6,7,16,15,8,9,14,13,10,11,12 \
X        refbase.ps > refguide.ps
X
X# Odd and even passes for centerfold printing.
X# First print guide-odd.ps, then find out which of the others to use.
X# guide-even1.ps is for printers with correct output stacking like
X# Apple LaserWriter II.
X# guide-even2.ps for printers with reverse output stacking, like old
X# Apple LaserWriters.
X
Xguide-odd.ps:    refbase.ps parr
X    perl ./parr $(PAPER) \
X        -o 21,2,19,4,17,6,15,8,13,10 refbase.ps > guide-odd.ps
X
Xguide-even1.ps:    refbase.ps parr
X    perl ./parr $(PAPER) \
X        -o 11,12,9,14,7,16,5,18,3,20 refbase.ps > guide-even1.ps
X
Xguide-even2.ps:    refbase.ps parr
X    perl ./parr $(PAPER) \
X        -o 3,20,5,18,7,16,9,14,11,12 refbase.ps > guide-even2.ps
X
Xguide-test.ps:    refbase.ps parr
X    perl ./parr $(PAPER) \
X        -o 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21 refbase.ps > guide-test.ps
X
Xclean:
X    rm -f refguide.ps guide-odd.ps guide-even1.ps guide-even2.ps \
X        refbase.dvi core *~
X
X# For maintenance use only ...
X
XVER    = 4.036
X
XCH    = ch00.tex ch01.tex ch02.tex ch03.tex ch04.tex ch05.tex \
X      ch06.tex ch07.tex ch08.tex ch09.tex ch10.tex ch11.tex \
X      ch12.tex ch13.tex ch14.tex ch15.tex ch16.tex ch17.tex \
X      ch18.tex ch19.tex ch20.tex ch21.tex ch22.tex ch23.tex \
X      ch24.tex ch25.tex ch26.tex ch27.tex \
X      ch99.tex
XSRC    = refbase.tex refbase.sty
XAUX    = README ChangeLog Makefile parr Layout
X
X# Our TeX places its output here, never mind if yours doesn't.
XTEXTMP = /usr/tmp/$(USER)TeX.
X
X# NOTE: DO NOT REMOVE OR CHANGE '-ta4' EVEN IF USING NON-A4 PAPER
Xrefbase-ps:    refbase.dvi
X    $(DVIPS) -r0 -ta4 refbase.dvi
X
X#    -if [ -f psneat.pl ]; then \
X#        mv refbase.ps refbase.ps~; \
X#        perl ./psneat.pl refbase.ps~ > refbase.ps; \
X#    else true; \
X#    fi
X
Xrefbase.dvi:    $(SRC)
X    $(LATEX) refbase.tex < /dev/null
X    -if [ -f $(TEXTMP)dvi ]; then \
X        mv $(TEXTMP)dvi refbase.dvi; \
X    else true; \
X    fi
X
XMASTER  = ref
Xrefbase-tex:  $(MASTER)master.tex $(CH) makebase.pl
X    perl ./makebase.pl $(REV) $(MASTER)master.tex > refbase.tex
X
Xkit:
X    REV=`cat Revision.SEQ`; \
X    expr $$REV + 1 >Revision.SEQ; \
X    (echo ""; echo Revision: $(VER).$$REV; what $(SRC) $(CH)) >> Revision; \
X    $(MAKE) -$(MAKEFLAGS) REV=$$REV refbase-tex refbase-ps kitinternal
X
Xkitinternal:
X    rm -f perlref-*.shr.* perlref-$(VER).$(REV).tar.Z
X    shar -c -n perlref-$(VER).$(REV) -a -s '[e-mail]' \
X        -o perlref-$(VER).$(REV).shr -L50 -f $(AUX) $(SRC) refbase.ps
X    pdtar -zcvf perlref-$(VER).$(REV).tar.Z $(AUX) $(SRC) refbase.ps
X    ls -l perlref-*.shr.* perlref-*.tar.Z
X
Xident:
X    what $(AUX) $(SRC)
END_OF_FILE
  if test 2931 -ne `wc -c <'Makefile'`; then
    echo shar: \"'Makefile'\" unpacked with wrong size!
  fi
  # end of 'Makefile'
fi
if test -f 'parr' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'parr'\"
else
  echo shar: Extracting \"'parr'\" \(4291 characters\)
  sed "s/^X//" >'parr' <<'END_OF_FILE'
X#!/usr/bin/perl
X
X# @(#)@ parr 4.2.3
X
X# rearrange conforming PS code to print the pages in an arbitrary
X# order.  The -o option takes a list of ranges, like this:
X#    1-5    1-10,11-20    11-,1-10
X# usage: parr [-a4] [-o list] [file]
X#
X# [e-mail], 89/10/23
X# modified by [e-mail], 91/078/15
X
X$order='';
X$signFlag='';
X$signCount=0;
X$DEBUG=0;
X$TMPDIR='/usr/tmp';
X
Xwhile ($_ = $ARGV[0],/^-/) {
X    shift;
X    last if /^-\-$/;
X    /^-o(rder)?$/ && ($order = shift,next);
X    /^-a4$/ && ($a4flag++,next);
X    die "usage: parr [-a4] [-order list] [file]\n";
X}
X
X$file = "$TMPDIR/p$$.header";
X@files = ($file);
X$sheet=0;
Xopen(FILE,">$file") || die "$file: $!\n";
Xwhile (<>) {
X    #
X    # hack to use NeXT Preview: strip old '%%Pages:' lines
X    #
X    next if /^%%Pages:/;
X    if (/^%%Page:/) {
X        $sheet++;
X        $pagemap{$sheet} = $1 if /%%Page:\s+(\S+)\s+\S+/;
X        close(FILE);
X        $file = "$TMPDIR/p$$.$sheet";
X        push(@files,$file);
X        open(FILE,">$file") || die "$file: $!\n";
X    }
X    if (/^%%Trailer/) {
X        close(FILE);
X        $file = "$TMPDIR/p$$.trailer";
X        push(@files,$file);
X        open(FILE,">$file") || die "$file: $!\n";
X    }
X    if (/^TeXDict begin @(a4|letter)/) {
X        # Insert twoup before switching to TeXDict
X        &twoup;
X        $twoup++;
X        &double_sided;
X        print FILE "TeXDict begin @landscape\n";
X        next;
X    }
X    print FILE $_;
X}
Xclose(FILE);
Xdie "twoup insertion error\n" unless $twoup == 1;
X
X@order = ();
Xif ($order) {
X    foreach $range (split(/,/,$order)) {
X        ($start,$sep,$end) = split(/(-)/,$range);
X        $start = 1 unless $start;
X        $end = $sheet unless $end;
X        if ($sep) {
X            push(@order,$start..$end);
X        }else{
X            push(@order,$start);
X        }
X    }
X}elsif ($signFlag) {
X    if (! $signCount) {
X        $signCount = $sheet;
X        $signCount += (4 - $sheet % 4) if ($sheet % 4);
X    }else{
X        $signCount *=4;
X    }
X    for($base=0;$base<$sheet;$base+=$signCount) {
X        @tmp = ($signCount/2+$base);
X        push(@tmp,$tmp[0]+1,$tmp[0]+2,$tmp[0]-1);
X        while ($tmp[3] > $base) {
X            push(@order,@tmp);
X            @tmp = ($tmp[0]-2,$tmp[1]+2,$tmp[2]+2,$tmp[3]-2);
X        }
X    }
X}else{
X    @order = (1..$sheet);
X}
X
X@tmp=@order;
X@order=();
Xforeach $page (@tmp) {
X    push(@order,$page > $sheet ? "B" : $page);
X}
X
Xopen(FILE,"$TMPDIR/p$$.header");
X$_ = <FILE>;
Xprint $_,"%%Pages: (atend)\n";
Xprint while <FILE>;
Xclose(FILE);
X
X$count = 0;
Xforeach $page (@order) {
X    $count++;
X    $num = "?";
X    $num = $pagemap{$page} if defined $pagemap{$page};
X    $num .= "/" . $pagemap{$order[$count]}
X        if defined $pagemap{$order[$count]};
X    print "%%Page: $num ", ($count+1)/2, "\n" if $count & 1;
X    print "%%OldPage: $page\n";
X    if ($page eq "B") {
X        print "showpage\n";
X    }else{
X        open(FILE,"$TMPDIR/p$$.$page");
X        while (<FILE>) {
X            print unless /^%%Page:/;
X        }
X        close(FILE);
X    }
X}
Xopen(FILE,"$TMPDIR/p$$.trailer");
Xprint while <FILE>;
Xclose(FILE);
Xprint "%%Pages: ", int(($count+1)/2), " 0\n";
X
Xunlink @files unless $DEBUG;
Xexit(0);
X
Xsub twoup {
X$factor = 0.707106781187;
X
X# Measurements are in 1/100 inch approx.
Xif ( $a4flag) {
X    $topmargin = -57;
X    $leftmargin = 28;
X    $othermargin = 445;    # do not change -- relative to $leftmargin
X}
Xelse {
X    $topmargin = -30;
X    $leftmargin = 0;
X    $othermargin = 445;    # do not change -- relative to $leftmargin
X}
X$vsize = -1 - $factor;
Xprint FILE <<EOD;
X/isoddpage true def
X/orig-showpage /showpage load def
X/showpage {
X        isoddpage not { orig-showpage } if
X        /isoddpage isoddpage not store
X    } def
X
X/bop-hook {
X    /vsize $vsize def
X        isoddpage
X    { $factor $factor scale $topmargin $leftmargin translate }
X        { 0 $othermargin translate}
X    ifelse
X    } def
X
X/end-hook{ isoddpage not { orig-showpage } if } def
XEOD
X}
X
Xsub double_sided {
X
X    # From: Tim Huckvale <[e-mail]>
X    #
X    # You may be interested in the following problem, and fix, that we
X    # found when attempting to print the reference card on our Hewlett
X    # Packard Laser-Jet IIISi printer.
X    #
X    # On this printer, refguide.ps prints double-sided with the
X    # reverse side of each sheet upside down.  We fixed it with the
X    # following patch, applied before printing.
X
X    # From: Johan Vromans <[e-mail]>
X    #
X    # Okay -- consider this an unsupported feature.
X
X    print FILE <<EOD;
Xstatusdict /setduplexmode known { statusdict begin true setduplexmode end } if
Xstatusdict /settumble known { statusdict begin true settumble end } if
XEOD
X}
X
X# Local Variables:
X# mode:(perl)
X# End:
END_OF_FILE
  if test 4291 -ne `wc -c <'parr'`; then
    echo shar: \"'parr'\" unpacked with wrong size!
  fi
  # end of 'parr'
fi
if test -f 'refbase.ps.B' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'refbase.ps.B'\"
else
  echo shar: Extracting \"'refbase.ps.B'\" \(40782 characters\)
  sed "s/^X//" >'refbase.ps.B' <<'END_OF_FILE'
X241 y Fd(opendir\()p Ff(DIRHANDLE)p Fd(,)p Ff(DIRNAME)p Fd(\))472
X297 y Fj(Opens)h(a)f(directory)g(on)h(the)f(handle)g(speci\256ed.)354
X362 y Fd(readdir\()p Ff(DIRHANDLE)p Fd(\))p Fj(*)472 418 y(Returns)h(the)f
X(next)g(entry)g(\(or)h(an)g(array)g(of)f(entries\))h(in)f(the)g(directory)m
X(.)354 483 y Fd(rewinddir\()p Ff(DIRHANDLE)p Fd(\))p Fj(*)472
X540 y(Positions)f(the)i(directory)f(to)g(the)g(beginning.)354
X604 y Fd(seekdir\()p Ff(DIRHANDLE)p Fd(,)p Ff(POS)p Fd(\))472
X661 y Fj(Sets)h(position)e(for)h(readdir)h(on)f(the)g(directory)m(.)354
X725 y Fd(telldir\()p Ff(DIRHANDLE)p Fd(\))p Fj(*)472 782 y(Returns)h(the)f
X(postion)f(in)h(the)g(directory)m(.)355 905 y Fl(15.)19 b(Input)i(/)e(Output)
Xp 355 926 V 354 1027 a Fj(In)12 b(input/output)c(operations,)k
XFf(FILEHANDLE)e Fj(may)h(be)h(a)f(\256lehandle)h(as)f(opened)h(by)f(the)354
X1083 y Fd(open)i Fj(operator)n(,)f(or)g(a)f(scalar)h(variable)g(which)f
X(evaluates)g(to)g(the)g(name)g(of)h(a)g(\256lehandle)f(to)354
X1140 y(be)h(used.)354 1204 y Fd(binmode\()p Ff(FILEHANDLE)p
XFd(\))p Fj(*)472 1261 y(Arranges)g(for)g(the)f(\256le)h(opened)f(on)g
XFf(FILEHANDLE)g Fj(to)g(be)g(read)h(in)f(\252binary\272)h(mode)472
X1317 y(as)g(opposed)f(to)f(\252text\272)i(mode)f(\(MS-DOS)h(only\).)354
X1382 y Fd(close\()p Ff(FILEHANDLE)p Fd(\))p Fj(*)472 1438 y(Closes)g(the)f
X(\256le)h(or)f(pipe)g(associated)g(with)g(the)g(\256le)h(handle.)354
X1503 y Fd(dbmclose\()p Fi(\045)q Ff(ARRA)m(Y)p Fd(\))p Fj(*)472
X1560 y(Breaks)h(the)e(binding)f(between)h(the)h(array)g(and)f(the)g(dbm)g
X(\256le.)354 1624 y Fd(dbmopen\()p Fi(\045)r Ff(ARRA)m(Y)p
XFd(,)p Ff(DBMNAME)p Fd(,)d Ff(MODE)p Fd(\))472 1681 y Fj(Binds)j(a)h(dbm)f
X(or)g(ndbm)g(\256le)g(to)g(the)h(associative)e(array)m(.)j(If)f(the)f
X(database)h(does)f(not)472 1737 y(exist,)h(it)e(is)h(created)h(with)f(the)g
X(indicated)g(mode.)354 1802 y Fd(eof\()p Ff(FILEHANDLE)p Fd(\))472
X1859 y Fj(Returns)h(1)f(if)g(the)h(next)f(read)h(will)e(return)i(end)f(of)g
X(\256le,)i(or)e(if)g(the)h(\256le)f(is)g(not)g(open.)354 1923
Xy Fd(eof)56 b Fj(Returns)12 b(the)f(eof)h(status)e(for)i(the)f(last)g(\256le)
Xh(read.)354 1988 y Fd(eof\()g(\))472 2045 y Fj(Indicates)g(eof)f(on)h(the)f
X(pseudo)f(\256le)i(formed)g(of)f(the)g(\256les)h(listed)e(on)h(the)g(command)
X472 2101 y(line.)354 2166 y Fd(fcntl\()p Ff(FILEHANDLE)p Fd(,)p
XFf(FUNCTION)p Fd(,)p Fi($)o Ff(V)m(AR)p Fd(\))472 2222 y Fj(Implements)f(the)
Xi Fc(fcntl)p Fj(\(2\))f(function.)g(This)f(function)h(has)g(non-standard)g
X(return)472 2279 y(values.)h(See)g(the)g(manual)e(for)i(details.)354
X2343 y Fd(\256leno\()p Ff(FILEHANDLE)p Fd(\))p Fj(*)472 2400
Xy(Returns)g(the)f(\256le)h(descriptor)f(for)h(a)f(given)g(\(open\))h(\256le.)
X354 2465 y Fd(\257ock\()p Ff(FILEHANDLE)p Fd(,)p Ff(OPERA)m(TION)p
XFd(\))472 2521 y Fj(Calls)f Fc(\257ock)q Fj(\(2\))g(on)g(the)g(\256le.)g
XFf(OPERA)m(TION)g Fj(adds)f(from)h(1)g(\(shared\),)g(2)g(\(exclusive\),)g(4)
X472 2578 y(\(non-blocking\))g(or)g(8)g(\(unlock\).)354 2642
Xy Fd(getc)p Fj([)p Fd(\()p Ff(FILEHANDLE)p Fd(\))p Fj(*])472
X2699 y(Y)m(ields)h(the)f(next)g(character)i(from)e(the)g(\256le,)h(or)g
XFi("")g Fj(on)f(EOF)l(.)h(If)g Ff(FILEHANDLE)f Fj(is)472 2755
Xy(omitted,)g(reads)h(from)f Fi(STDIN)p Fj(.)354 2820 y Fd(ioctl\()p
XFf(FILEHANDLE)p Fd(,)p Ff(FUNCTION)p Fd(,)p Fi($)n Ff(V)m(AR)p
XFd(\))472 2876 y Fj(performs)h Fc(ioctl)p Fj(\(2\))f(on)g(the)g(\256le.)h
X(This)f(function)f(has)i(non-standard)e(return)i(values.)472
X2933 y(See)h(the)e(manual)g(for)h(details.)p 354 3018 1512
X3 v 354 3065 a Fg(9)p eop
X%%Page: 10 12
Xbop 1362 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 354 -12 a Fd(open\()p Ff(FILEHANDLE)p Fj([)p Fd(,)p Ff(FILENAME)p
XFj(])p Fd(\))472 45 y Fj(Opens)f(a)f(\256le)h(and)f(associates)g(it)g(with)g
XFf(FILEHANDLE)p Fj(.)g(If)g Ff(FILENAME)f Fj(is)h(omitted,)472
X101 y(the)h(scalar)g(variable)f(of)h(the)f(same)g(name)g(as)h(the)f
XFf(FILEHANDLE)f Fj(must)h(contain)f(the)472 158 y(\256lename.)472
X222 y(The)i(following)e(\256lename)i(conventions)e(apply)h(when)g(opening)f
X(a)i(\256le.)472 287 y Fi(")p Ff(FILE)p Fi(")95 b Fj(open)11
Xb Ff(FILE)g Fj(for)h(input.)e(Also)h Fi("<)p Ff(FILE)p Fi(")p
XFj(.)472 352 y Fi(">)p Ff(FILE)p Fi(")68 b Fj(open)11 b Ff(FILE)g
XFj(for)h(output,)e(creating)i(it)e(if)i(necessary)m(.)472 417
Xy Fi(">>)p Ff(FILE)p Fi(")41 b Fj(open)11 b Ff(FILE)g Fj(in)g(append)g(mode.)
X472 482 y Fi("+>)p Ff(FILE)p Fi(")41 b Fj(open)11 b Ff(FILE)g
XFj(with)g(read/write)g(access.)472 546 y Fi("|)q Ff(CMD)p Fi(")60
Xb Fj(opens)11 b(a)g(pipe)g(to)g(command)g Ff(CMD)p Fj(.)472
X611 y Fi(")p Ff(CMD)p Fi(|)q(")60 b Fj(opens)11 b(a)g(pipe)g(from)h(command)e
XFf(CMD)p Fj(.)472 676 y Ff(FILE)i Fj(may)f(be)g Fi(&)p Ff(FILEHND)g
XFj(in)g(which)g(case)h(the)g(new)f(\256le)h(handle)f(is)g(connected)g(to)472
X732 y(the)h(\(previously)e(opened\))i(\256lehandle)f Ff(FILEHND)p
XFj(.)472 797 y Fd(open)i Fj(returns)e(1)g(upon)g(success,)h
XFd(undef)g Fj(otherwise,)g(except)f(for)h(pipes.)f(The)472
X853 y(parentheses)h(may)f(be)g(omitted,)g(if)g(only)g(a)g Ff(FILEHANDLE)g
XFj(is)g(speci\256ed.)354 918 y Fd(pipe\()p Ff(READHANDLE)p
XFd(,)p Ff(WRITEHANDLE)p Fd(\))472 975 y Fj(Returns)h(a)g(pair)f(of)g
X(connected)h(pipes.)354 1039 y Fd(print)p Fj([)p Fd(\()p Fj([)p
XFf(FILEHANDLE)p Fj(])p Ff(LIST)p Fe(y)o Fd(\))p Fj(*])472 1096
Xy(Prints)f(a)h(string)f(or)g(a)h(comma-separated)f(list)f(of)i(strings.)e(If)
Xi Ff(FILEHANDLE)f Fj(is)472 1152 y(omitted,)g(prints)f(by)h(default)h(to)e
X(standard)i(output)e(\(or)h(to)g(the)h(last)e(selected)i(output)472
X1209 y(channel)g(-)f(see)h Fd(select)p Fj(\).)354 1274 y Fd(printf)p
XFj([)p Fd(\()p Fj([)p Ff(FILEHANDLE)p Fj(])f Ff(LIST)p Fd(\))p
XFj(*])472 1330 y(Equivalent)g(to)g Fd(print)g Ff(FILEHANDLE)g
XFd(sprintf\()p Ff(LIST)p Fd(\))p Fj(.)354 1395 y Fd(read\()p
XFf(FILEHANDLE)p Fd(,)p Fi($)p Ff(V)m(AR)p Fd(,)p Ff(LENGTH)p
XFj([)p Fd(,)p Ff(OFFSET)p Fj(])p Fd(\))472 1451 y Fj(Read)i
XFf(LENGTH)e Fj(binary)h(bytes)e(from)i(the)f(\256le)h(into)e(the)h(variable)h
X(at)f Ff(OFFSET)p Fj(.)472 1508 y(Returns)h(number)f(of)g(bytes)g(actually)g
X(read.)354 1572 y Fd(seek\()p Ff(FILEHANDLE)p Fd(,)p Ff(POSITION)p
XFd(,)p Ff(WHENCE)p Fd(\))472 1629 y Fj(Arbitrarily)g(positions)f(the)h
X(\256le.)h(Returns)f(1)h(upon)e(success,)i(0)f(otherwise.)354
X1694 y Fd(select)p Fj([)p Fd(\()p Ff(FILEHANDLE)p Fd(\))p Fj(])472
X1750 y(Returns)h(the)f(currently)g(selected)h(\256lehandle.)g(Sets)f(the)h
X(current)f(default)g(\256lehandle)472 1807 y(for)h(output)e(operations)h(if)g
XFf(FILEHANDLE)g Fj(is)g(supplied.)354 1871 y Fd(select\()p
XFf(RBITS)p Fd(,)p Ff(WBITS)p Fd(,)p Ff(NBITS)p Fd(,)o Ff(TIMEOUT)p
XFd(\))472 1928 y Fj(Performs)h(a)g Fc(select)p Fj(\(2\))g(system)e(call)i
X(with)e(the)h(same)h(parameters.)354 1993 y Fd(sprintf\()p
XFf(FORMA)m(T)p Fd(,)p Ff(LIST)p Fd(\))472 2049 y Fj(Returns)g(a)g(string)e
X(formatted)h(by)g(\(almost)f(all)i(of\))f(the)g(usual)g(printf)g
X(conventions.)354 2114 y Fd(sysread\()p Ff(FILEHANDLE)p Fd(,)p
XFi($)p Ff(V)m(AR)p Fd(,)p Ff(LENGTH)p Fj([)p Fd(,)p Ff(OFFSET)p
XFj(])p Fd(\))472 2170 y Fj(Reads)h Ff(LENGTH)g Fj(bytes)f(into)g
XFi($)p Ff(V)m(AR)g Fj(at)g Ff(OFFSET)p Fj(.)354 2235 y Fd(syswrite\()p
XFf(FILEHANDLE)p Fd(,)p Ff(SCALAR)p Fd(,)p Ff(LENGTH)p Fj([)p
XFd(,)p Ff(OFFSET)p Fj(])p Fd(\))472 2291 y Fj(W)n(rites)h Ff(LENGTH)g
XFj(bytes)e(from)i Ff(SCALAR)e Fj(at)h Ff(OFFSET)p Fj(.)354
X2356 y Fd(tell)p Fj([)p Fd(\()p Ff(FILEHANDLE)p Fd(\))p Fj(]*)472
X2413 y(Returns)h(the)f(current)h(\256le)g(position)d(for)j(the)f(\256le.)h
X(If)g Ff(FILEHANDLE)f Fj(is)f(omitted,)472 2469 y(assumes)h(the)g(\256le)h
X(last)f(read.)354 2534 y Fd(write)p Fj([)p Fd(\()p Ff(FILEHANDLE)p
XFd(\))p Fj(]*)472 2590 y(W)n(rites)h(a)f(formatted)g(record)h(to)f(the)h
X(speci\256ed)f(\256le,)i(using)d(the)h(format)g(associated)472
X2647 y(with)g(that)g(\256le.)h(See)g(\252Formats\272.)p 354
X3018 V 1811 3065 a Fg(10)p eop
X%%Page: 11 13
Xbop 354 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(16.)19 b(Search)i(and)g(replace)f(functions)p
X355 19 1512 2 v 354 119 a Fj([)p Ff(EXPR)11 b Fi(=\304)p Fj(])h([)p
XFd(m)p Fj(])p Fi(/)p Ff(P)m(A)m(TTERN)p Fi(/)p Fj([)p Fd(g)p
XFj(][)p Fd(i)p Fj(][)p Fd(o)p Fj(])472 176 y(Searches)h Ff(EXPR)e
XFj(\(default:)g Fi($_)p Fj(\))h(for)g(a)f(pattern.)h(If)g(you)f(prepend)g(an)
Xh Fd(m)f Fj(you)g(can)h(use)472 232 y(almost)f(any)g(pair)g(of)h(characters)g
X(as)g(delimiters.)e(If)i(used)f(in)g(array)h(context,)g(an)f(array)472
X289 y(is)g(returned)h(consisting)d(of)j(the)f(subexpressions)f(matched)h(by)g
X(the)g(parentheses)h(in)472 345 y(pattern,)g(i.e.)g Fi(\($1,$2,$3)q(,.)q
X(..\))q Fj(.)472 402 y(Optional)f(modi\256ers:)f Fd(g)i Fj(matches)f(as)h
X(many)e(times)h(as)g(possible;)f Fd(i)h Fj(searches)h(in)f(a)472
X458 y(case-insensitive)g(manner;)g Fd(o)h Fj(interpolates)e(variables)i(only)
Xe(once.)472 515 y(If)i Ff(P)m(A)m(TTERN)f Fj(is)g(empty)m(,)g(the)g(most)g
X(recent)h(pattern)f(from)g(a)h(previous)e(match)h(or)472 571
Xy(replacement)h(is)f(used.)472 628 y(W)n(ith)g Fd(g)h Fj(the)f(match)g(can)h
X(be)g(used)f(as)g(an)h(iterator)f(in)g(scalar)h(context.)354
X692 y Fi(?)p Ff(P)m(A)m(TTERN)p Fi(?)472 749 y Fj(This)f(is)g(just)f(like)h
X(the)g Fi(/)p Ff(P)m(A)m(TTERN)p Fi(/)h Fj(search,)h(except)e(that)g(it)g
X(matches)g(only)g(once)472 805 y(between)h(calls)f(to)g(the)g(reset)h
X(operator)m(.)g(If)g Ff(P)m(A)m(TTERN)f Fj(is)g(empty)m(,)g(the)g(most)g
X(recent)472 862 y(pattern)h(from)f(a)h(previous)e(match)h(or)h(replacement)f
X(is)g(used.)354 926 y([)p Fi($)q Ff(V)m(AR)g Fi(=\304)p Fj(])h
XFd(s)p Fi(/)p Ff(P)m(A)m(TTERN)p Fi(/)p Ff(REPLACEMENT)p Fi(/)p
XFj([)p Fd(g)p Fj(][)p Fd(i)p Fj(][)p Fd(e)p Fj(][)p Fd(o)p
XFj(])472 983 y(Searches)h(a)f(string)e(for)i(a)g(pattern,)f(and)h(if)f
X(found,)g(replaces)h(that)f(pattern)g(with)g(the)472 1039 y(replacement)h
X(text)f(and)g(returns)g(the)h(number)f(of)g(substitutions)d(made.)k
X(Otherwise)f(it)472 1096 y(returns)h(false.)472 1152 y(Optional)f
X(modi\256ers:)f Fd(g)i Fj(replaces)g(all)f(occurrences)h(of)g(the)f(pattern;)
Xg Fd(e)g Fj(interprets)g(the)472 1209 y(replacement)h(string)e(as)i(an)f
X(expression;)g Fd(i)g Fj(and)g Fd(o)h Fj(as)f(with)g Fi(/)p
XFf(P)m(A)m(TTERN)p Fi(/)h Fj(matching.)472 1265 y(Almost)e(any)i(delimiter)e
X(may)h(replace)h(the)f(slashes;)g(if)g(single)g(quotes)f(are)j(used,)e(no)472
X1322 y(interpretation)g(is)g(done)g(on)g(the)g(replacement)h(string.)472
X1378 y(If)g(bracketing)f(quotes)g(are)h(used,)g Ff(P)m(A)m(TTERN)f
XFj(and)g Ff(REPLACEMENT)f Fj(may)h(have)472 1434 y(their)h(own)f(delimiters,)
Xf(e.g.)i Fi(s\(foo\)[b)q(ar])q Fj(.)472 1491 y(If)g Ff(P)m(A)m(TTERN)f
XFj(is)g(empty)m(,)g(the)g(most)g(recent)h(pattern)f(from)g(a)h(previous)e
X(match)h(or)472 1547 y(replacement)h(is)f(used.)354 1612 y
XFd(study)p Fj([)p Fd(\()p Fi($)q Ff(V)m(AR)p Fe(y)o Fd(\))p
XFj(*])472 1669 y(Study)g(the)h(contents)e(of)i Fi($)p Ff(V)m(AR)f
XFj(in)g(anticipation)f(of)h(doing)g(many)g(pattern)g(matches)472
X1725 y(on)h(the)f(contents)f(before)i(it)f(is)g(next)g(modi\256ed.)354
X1790 y([)p Fi($)q Ff(V)m(AR)g Fi(=\304)p Fj(])h Fd(tr)p Fi(/)p
XFf(SEARCHLIST)p Fi(/)p Ff(REPLACEMENTLIST)p Fi(/)p Fj([)p Fd(c)p
XFj(][)p Fd(d)p Fj(][)p Fd(s)p Fj(])472 1846 y(T)n(ranslates)g(all)f
X(occurrences)h(of)g(the)f(characters)i(found)e(in)f(the)i(search)g(list)e
X(with)h(the)472 1903 y(corresponding)g(character)i(in)e(the)g(replacement)h
X(list.)e(It)i(returns)f(the)g(number)g(of)472 1959 y(characters)i(replaced.)f
XFd(y)g Fj(may)f(be)g(used)h(instead)e(of)i Fd(tr)p Fj(.)472
X2016 y(Optional)f(modi\256ers:)f Fd(c)i Fj(complements)e(the)h
XFf(SEARCHLIST)p Fj(;)f Fd(d)h Fj(deletes)h(all)472 2072 y(characters)h(not)e
X(found)g(in)g Ff(SEARCHLIST)p Fj(;)e Fd(s)j Fj(squeezes)g(all)f(sequences)g
X(of)472 2129 y(characters)i(that)e(are)h(translated)f(into)f(the)i(same)f
X(tar)o(get)g(character)i(into)e(one)472 2185 y(occurrence)i(of)f(this)e
X(character)m(.)355 2417 y Fl(17.)19 b(System)i(interaction)p
X355 2438 V 354 2539 a Fd(alarm\()p Ff(EXPR)p Fd(\))p Fj(*)472
X2595 y(Schedules)12 b(a)g Fi(SIGALRM)i Fj(to)d(be)g(delivered)h(after)g
XFf(EXPR)e Fj(seconds.)354 2660 y Fd(chdir)i Fj([)p Fd(\()p
XFf(EXPR)p Fd(\))p Fj(*])472 2716 y(Changes)g(the)f(working)g(directory)m(,)h
XFi($ENV{"HOME)q("})j Fj(if)c Ff(EXPR)g Fj(is)f(omitted.)354
X2781 y Fd(chroot\()p Ff(FILENAME)p Fe(y)o Fd(\))p Fj(*)472
X2837 y(Changes)i(the)f(root)g(directory)h(for)f(the)g(process)h(and)f(its)g
X(children.)p 354 3018 1512 3 v 354 3065 a Fg(11)p eop
X%%Page: 12 14
Xbop 1362 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 354 -12 a Fd(die)p Fj([)p Fd(\()p Ff(LIST)p Fd(\))p Fj(*])472
X45 y(Prints)e(the)h(value)f(of)g Ff(LIST)h Fj(to)e Fi(STDERR)k
XFj(and)e(exits)e(with)h(the)g(current)h(value)f(of)h Fi($!)472
X101 y Fj(\(errno\).)h(If)f Fi($!)g Fj(is)f(0,)h(exits)e(with)h(the)g(value)g
X(of)h Fi(\($?)28 b(>>)h(8\))p Fj(.)12 b(If)g Fi(\($?)29 b(>>)f(8\))12
Xb Fj(is)472 158 y(0,)g(exits)f(with)f(255.)i Ff(LIST)f Fj(defaults)g(to)g
XFi("Died.")p Fj(.)354 222 y Fd(exec\()p Ff(LIST)p Fd(\))p Fj(*)472
X279 y(Executes)h(the)f(system)f(command)h(in)g Ff(LIST)p Fj(;)f(does)i(not)e
X(return.)354 344 y Fd(exit\()p Ff(EXPR)p Fd(\))p Fj(*)472 400
Xy(Exits)h(immediately)e(with)i(the)g(value)h(of)f Fi(EXPR)p
XFj(.)354 465 y Fd(fork)40 b Fj(Does)12 b(a)f Fc(fork)q Fj(\(2\))g(system)g
X(call.)g(Returns)h(the)f(child)g(pid)g(to)f(the)i(parent)f(process)h(and)472
X521 y(zero)g(to)f(the)h(child)e(process.)354 586 y Fd(getlogin)472
X643 y Fj(Returns)i(the)f(current)h(login)e(name)h(as)h(known)f(by)g(the)g
X(system.)354 707 y Fd(getpgrp)p Fj([)p Fd(\()p Ff(PID)p Fd(\))p
XFj(*])472 764 y(Returns)h(the)f(process)g(group)g(for)h(process)f
XFf(PID)g Fj(\(0,)h(or)f(omitted,)g(means)g(the)g(current)472
X820 y(process\).)354 885 y Fd(getppid)472 941 y Fj(Returns)h(the)f(process)g
X(id)g(of)h(the)f(parent)h(process.)354 1006 y Fd(getpriority\()p
XFf(WHICH)p Fd(,)p Ff(WHO)p Fd(\))472 1063 y Fj(Returns)g(the)f(current)h
X(priority)e(for)i(a)g(process,)f(process)h(group,)f(or)h(user)m(.)354
X1127 y Fd(kill\()p Ff(LIST)p Fd(\))p Fj(*)472 1184 y(Sends)g(a)g(signal)e(to)
Xh(a)h(list)e(of)h(processes.)h(The)g(\256rst)f(element)g(of)h(the)f(list)f
X(must)g(be)i(the)472 1240 y(signal)f(to)g(send)g(\(numeric,)h(or)f(its)g
X(name)g(as)g(a)h(string\).)354 1305 y Fd(setpgrp\()p Ff(PID)p
XFd(,)p Ff(PGRP)p Fd(\))472 1362 y Fj(Sets)g(the)f(process)h(group)e(for)i
X(the)f Ff(PID)g Fj(\(0)g(=)h(current)f(process\).)354 1426
Xy Fd(setpriority\()p Ff(WHICH)p Fd(,)p Ff(WHO)p Fd(,)p Ff(PRIO)p
XFd(\))472 1483 y Fj(Sets)h(the)f(current)h(priority)e(for)i(a)g(process,)f
X(process)h(group,)f(or)h(a)f(user)m(.)354 1548 y Fd(sleep)p
XFj([)p Fd(\()p Ff(EXPR)p Fd(\))p Fj(*])472 1604 y(Causes)h(the)f(script)g(to)
Xf(sleep)h(for)h Ff(EXPR)e Fj(seconds,)h(or)g(forever)h(if)g(no)e
XFf(EXPR)p Fj(.)h(Returns)472 1660 y(the)h(number)f(of)g(seconds)g(actually)g
X(slept.)354 1725 y Fd(syscall\()p Ff(LIST)p Fd(\))p Fj(*)472
X1782 y(Calls)h(the)f(system)f(call)i(speci\256ed)f(in)g(the)g(\256rst)h
X(element)f(of)g(the)h(list,)e(passing)h(the)g(rest)472 1838
Xy(of)h(the)f(list)f(as)i(ar)o(guments)f(to)g(the)g(call.)354
X1903 y Fd(system\()p Ff(LIST)p Fd(\))p Fj(*)472 1959 y(Does)h(exactly)f(the)g
X(same)g(thing)g(as)g Fd(exec)h Ff(LIST)f Fj(except)h(that)f(a)g(fork)h(is)f
X(done)g(\256rst,)472 2016 y(and)h(the)f(parent)h(process)f(waits)g(for)g(the)
Xh(child)e(process)i(to)f(complete.)354 2081 y Fd(times)472
X2137 y Fj(Returns)h(a)g(4-element)f(array)h(\()p Fi($)p Fj(user)n(,)h
XFi($)p Fj(system,)e Fi($)p Fj(cuser)n(,)h Fi($)q Fj(csystem\))e(giving)h(the)
X472 2193 y(user)h(and)f(system)g(times,)f(in)h(seconds,)h(for)f(this)g
X(process)g(and)g(the)h(children)f(of)g(this)472 2250 y(process.)354
X2315 y Fd(umask)p Fj([)p Fd(\()p Ff(EXPR)p Fd(\))p Fj(*])472
X2371 y(Sets)h(the)f(umask)g(for)g(the)h(process)f(and)g(returns)h(the)f(old)g
X(one.)g(If)h Ff(EXPR)f Fj(is)g(omitted,)472 2428 y(returns)h(current)f(umask)
Xg(value.)354 2492 y Fd(wait)37 b Fj(W)l(aits)12 b(for)f(a)h(child)f(process)g
X(to)g(terminate)g(and)g(returns)h(the)f(pid)g(of)g(the)g(deceased)472
X2549 y(process)h(\(-1)f(if)h(none\).)g(The)f(status)f(is)h(returned)h(in)f
XFi($?)p Fj(.)354 2614 y Fd(waitpid\()p Ff(PID)p Fd(,)p Ff(FLAGS)p
XFd(\))472 2670 y Fj(Performs)h(the)f(same)h(function)e(as)i(the)f
X(corresponding)g(system)f(call.)354 2735 y Fd(warn\()p Ff(LIST)p
XFd(\))p Fj(*)472 2791 y(Prints)h(the)h(message)f(on)g Fi(STDERR)j
XFj(like)d Fd(die)p Fj(,)g(but)g(doesn')o(t)g(exit.)p 354 3018
XV 1811 3065 a Fg(12)p eop
X%%Page: 13 15
Xbop 354 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(18.)19 b(Networking)p 355 19 1512 2 v 354 119
Xa Fd(accept\()p Ff(NEWSOCKET)p Fd(,)p Ff(GENERICSOCKET)p Fd(\))472
X176 y Fj(Accepts)12 b(a)g(new)f(socket.)354 241 y Fd(bind\()p
XFf(SOCKET)p Fd(,)p Ff(NAME)p Fd(\))472 297 y Fj(Binds)g(the)h
XFf(NAME)e Fj(to)h(the)g Ff(SOCKET)p Fj(.)354 362 y Fd(connect\()p
XFf(SOCKET)p Fd(,)p Ff(NAME)p Fd(\))472 418 y Fj(Connects)h(the)f
XFf(NAME)f Fj(to)h(the)h Ff(SOCKET)p Fj(.)354 483 y Fd(getpeername\()p
XFf(SOCKET)p Fd(\))472 540 y Fj(Returns)g(the)f(socket)g(address)h(of)f(the)g
X(other)g(end)h(of)f(the)h Ff(SOCKET)p Fj(.)354 604 y Fd(getsockname\()p
XFf(SOCKET)p Fd(\))472 661 y Fj(Returns)g(the)f(name)g(of)h(the)f(socket.)354
X725 y Fd(getsockopt\()p Ff(SOCKET)p Fd(,)p Ff(LEVEL)p Fd(,)p
XFf(OPTNAME)p Fd(\))472 782 y Fj(Returns)h(the)f(socket)g(options.)354
X847 y Fd(listen\()p Ff(SOCKET)p Fd(,)p Ff(QUEUESIZE)p Fd(\))472
X903 y Fj(Starts)h(listening)e(on)h(the)g(speci\256ed)h Ff(SOCKET)p
XFj(.)354 968 y Fd(recv\()p Ff(SOCKET)p Fd(,)p Ff(SCALAR)p Fd(,)p
XFf(LENGTH)p Fd(,)p Ff(FLAGS)p Fd(\))472 1024 y Fj(Receives)h(a)e(message)h
X(on)f Ff(SOCKET)p Fj(.)354 1089 y Fd(send\()p Ff(SOCKET)p Fd(,)p
XFf(MSG)p Fd(,)p Ff(FLAGS[)p Fd(,)p Ff(T)o(O)p Fj(])p Fd(\))472
X1146 y Fj(Sends)h(a)g(message)f(on)g(the)g Ff(SOCKET)p Fj(.)354
X1210 y Fd(setsockopt\()p Ff(SOCKET)p Fd(,)p Ff(LEVEL)p Fd(,)p
XFf(OPTNAME)p Fd(,)p Ff(OPTV)m(AL)p Fd(\))472 1267 y Fj(Sets)h(the)f
X(requested)h(socket)f(option.)354 1332 y Fd(shutdown\()p Ff(SOCKET)p
XFd(,)p Ff(HOW)p Fd(\))472 1388 y Fj(Shuts)g(down)g(a)h Ff(SOCKET)p
XFj(.)354 1453 y Fd(socket\()p Ff(SOCKET)p Fd(,)p Ff(DOMAIN)p
XFd(,)p Ff(TYPE)p Fd(,)p Ff(PROT)o(OCOL)p Fd(\))472 1509 y Fj(Creates)h(a)e
XFf(SOCKET)h Fj(in)f Ff(DOMAIN)f Fj(with)h Ff(TYPE)f Fj(and)i
XFf(PROT)o(OCOL)p Fj(.)354 1574 y Fd(socketpair\()p Ff(SOCKET1)p
XFd(,)p Ff(SOCKET2)p Fd(,)p Ff(DOMAIN)p Fd(,)p Ff(TYPE)p Fd(,)p
XFf(PROT)o(OCOL)p Fd(\))472 1630 y Fj(As)g(socket,)f(but)g(creates)h(a)g(pair)
Xf(of)h(bi-directional)e(sockets.)355 1874 y Fl(19.)19 b(SystemV)i(IPC)p
X355 1895 V 354 1995 a Fj(The)12 b(following)e(functions)g(all)h(perform)h
X(the)f(same)g(action)g(as)h(the)f(corresponding)f(system)354
X2052 y(calls.)354 2117 y Fd(msgctl\()p Ff(ID)p Fd(,)p Ff(CMD)p
XFd(,)p Ff(ARGS)p Fd(\))354 2173 y(msgget\()p Ff(KEY)p Fd(,)p
XFf(FLAGS)p Fd(\))354 2230 y(msgsnd\()p Ff(ID)p Fd(,)p Ff(MSG)p
XFd(,)p Ff(FLAGS)p Fd(\))354 2286 y(msgrcv\()p Ff(ID)p Fd(,)p
XFi($)p Ff(V)m(AR)p Fd(,)p Ff(SIZE)p Fd(,)p Ff(TYPE)p Fd(,)p
XFf(FLAGS)p Fd(\))354 2342 y(semctl\()p Ff(ID)p Fd(,)p Ff(SEMNUM)p
XFd(,)p Ff(CM)o(D)p Fd(,)p Ff(A)o(RG)p Fd(\))354 2399 y(semget\()p
XFf(KEY)p Fd(,)p Ff(NSEMS)p Fd(,)p Ff(SI)o(ZE)p Fd(,)p Ff(FLAGS)p
XFd(\))354 2455 y(semop\()p Ff(KEY)p Fd(,)p Fj(...)p Fd(\))354
X2512 y(shmctl\()p Ff(ID)p Fd(,)p Ff(CMD)p Fd(,)p Ff(ARG)p Fd(\))354
X2568 y(shmget\()p Ff(KEY)p Fd(,)p Ff(SIZE)p Fd(,)p Ff(FLAGS)p
XFd(\))354 2625 y(shmread\()p Ff(ID)p Fd(,)p Fi($)q Ff(V)m(AR)p
XFd(,)p Ff(POS)p Fd(,)p Ff(SIZE)p Fd(\))354 2681 y(shmwrite\()p
XFf(ID)p Fd(,)p Ff(STRING)p Fd(,)p Ff(POS)p Fd(,)p Ff(SIZE)p
XFd(\))p 354 3018 1512 3 v 354 3065 a Fg(13)p eop
X%%Page: 14 16
Xbop 1362 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(20.)19 b(Miscellaneous)p 355 19 1512 2 v 354
X119 a Fd(caller)p Fj([)p Fd(\()p Ff(EXPR)p Fd(\))p Fj(])472
X176 y(Returns)12 b(an)f(array)i(\()p Fi($)p Fj(package,)p Fi($)r
XFj(\256le,)p Fi($)q Fj(line,...\))g(for)e(a)h(speci\256c)g(subroutine)e
X(call.)472 232 y(\252)p Fi(caller)p Fj(\272)15 b(returns)c(this)f(info)h(for)
Xh(the)f(current)h(subroutine,)f(\252)p Fi(caller\(1\))p Fj(\272)k(for)472
X289 y(the)d(caller)f(of)h(this)e(subroutine)h(etc..)354 354
Xy Fd(de\256ned\()p Ff(EXPR)p Fd(\))p Fj(*)472 410 y(T)m(ests)g(whether)h(the)
Xf(lvalue)g Ff(EXPR)f Fj(has)i(a)f(real)h(value.)354 475 y Fd(dump)h
XFj([)p Ff(LABEL)p Fj(])472 531 y(Immediate)e(core)h(dump.)f(When)g
X(reincarnated,)i(starts)e(at)g Ff(LABEL)p Fj(.)354 596 y Fd(local\()p
XFf(LIST)p Fd(\))472 652 y Fj(Creates)i(a)e(scope)h(for)g(the)f(listed)f
X(variables)h(local)h(to)e(the)i(enclosing)e(block,)472 709
Xy(subroutine)h(or)g(eval.)354 774 y Fd(package)i Ff(NAME)472
X830 y Fj(Designates)e(the)g(remainder)h(of)f(the)h(current)f(block)g(as)h(a)f
X(package.)354 895 y Fd(require\()p Ff(EXPR)p Fe(y)o Fd(\))p
XFj(*)472 951 y(Includes)h(the)f(speci\256ed)h(\256le)f(from)g(the)h(perl)f
X(library)m(.)h(Does)f(not)g(include)g(more)g(than)472 1008
Xy(once,)h(and)g(yields)e(a)i(fatal)g(error)g(if)f(the)g(\256le)h(does)f(not)g
X(include)g(OK.)354 1073 y Fd(reset)h Fj([)p Fd(\()p Ff(EXPR)p
XFd(\))p Fj(*])472 1129 y(Resets)g Fi(??)g Fj(searches)g(so)f(that)g(they)g
X(work)h(again.)f Ff(EXPR)g Fj(is)g(a)g(list)g(of)g(single)g(letters.)472
X1185 y(All)g(variables)g(and)h(arrays)g(beginning)e(with)g(one)i(of)f(those)g
X(letters)g(are)h(reset)g(to)f(their)472 1242 y(pristine)g(state.)g(Only)g(af)
Xo(fects)h(the)g(current)f(package.)354 1307 y Fd(scalar\()p
XFf(EXPR)p Fd(\))472 1363 y Fj(Forces)i(evaluation)d(of)i Ff(EXPR)e
XFj(in)h(scalar)h(context.)354 1428 y Fd(sub)h Ff(NAME)d Fi({)i
XFf(EXPR)e Fi(;)i Fj(...)h Fi(})472 1484 y Fj(Designates)e Ff(NAME)g
XFj(as)g(a)h(subroutine.)e(Parameters)j(are)f(passed)f(by)g(reference)i(as)472
X1541 y(array)g Fi(@_)p Fj(.)f(Returns)g(the)f(value)g(of)h(the)f(last)g
X(expression)f(evaluated.)354 1606 y Fd(undef)p Fj([)p Fd(\()p
XFf(L)m(V)m(ALUE)p Fd(\))p Fj(*])472 1662 y(Unde\256nes)i(the)f
XFf(L)m(V)m(ALUE)p Fj(.)g(Always)g(returns)g(the)g(unde\256ned)h(value.)354
X1727 y Fd(wantarray)472 1783 y Fj(Returns)g(true)f(if)h(the)f(current)h
X(context)e(expects)i(an)f(array)i(value.)355 1906 y Fl(21.)19
Xb(Formats)p 355 1927 V 354 2028 a Fd(format)12 b Fj([)p Ff(NAME)p
XFj(])f Fi(=)354 2084 y Ff(FORMLIST)354 2141 y Fi(.)354 2206
Xy Ff(FORMLIST)h Fj(pictures)f(the)g(lines,)g(and)g(contains)g(the)g(ar)o
X(guments)g(which)g(will)f(give)h(values)354 2262 y(to)g(the)g(\256elds)h(in)f
X(the)g(lines.)g(Picture)h(\256elds)f(are:)409 2327 y Fi(@<<<...)69
Xb Fj(left)11 b(adjusted)g(\256eld,)h(repeat)g(the)f Fi(<)h
XFj(to)f(denote)g(the)g(desired)h(width;)409 2383 y Fi(@>>>...)69
Xb Fj(right)11 b(adjusted)f(\256eld;)409 2440 y Fi(@|)q(||)q(...)67
Xb Fj(centered)12 b(\256eld;)409 2496 y Fi(@#.##...)42 b Fj(numeric)11
Xb(format)g(with)g(implied)f(decimal)h(point;)409 2553 y Fi(@*)204
Xb Fj(a)12 b(multi-line)d(\256eld.)354 2617 y(Use)j Fi(\303)g
XFj(instead)e(of)i Fi(@)g Fj(for)f(multi-line)f(block)h(\256lling.)354
X2682 y(Use)h Fi(\304)g Fj(at)f(the)g(beginning)f(of)i(a)f(line)g(to)g
X(suppress)g(unwanted)g(empty)f(lines.)354 2747 y(Use)i Fi(\304\304)g
XFj(at)f(the)h(beginning)e(of)h(a)h(line)f(to)g(have)g(this)g(format)g(line)g
X(repeated)h(until)e(all)h(\256elds)354 2803 y(are)h(exhausted.)354
X2868 y(Use)g Fi($-)g Fj(to)f(zero)h(to)f(force)h(a)g(page)f(break.)354
X2933 y(See)i(also)e Fi($\303)p Fj(,)h Fi($\304)p Fj(,)h Fi($-)f
XFj(and)f Fi($=)i Fj(in)e(section)f(\252Special)j(V)-5 b(ariables\272.)p
X354 3018 1512 3 v 1811 3065 a Fg(14)p eop
X%%Page: 15 17
Xbop 354 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(22.)19 b(Info)h(from)h(system)g(\256les)p 355
X19 1512 2 v 354 119 a Fj(See)13 b(the)e(manual)g(about)g(return)g(values)g
X(in)g(scalar)h(context.)354 184 y Fg(passwd)354 241 y Fj(Returns)g(\()p
XFi($)p Fj(name,)g Fi($)q Fj(passwd,)f Fi($)p Fj(uid,)g Fi($)q
XFj(gid,)g Fi($)p Fj(quota,)h Fi($)p Fj(comment,)f Fi($)p Fj(gcos,)h
XFi($)p Fj(dir)n(,)g Fi($)p Fj(shell\).)354 305 y Fd(endpwent)517
Xb Fj(Ends)11 b(lookup)f(processing.)354 370 y Fd(getpwent)528
Xb Fj(Gets)11 b(next)g(info.)354 435 y Fd(getpwnam\()p Ff(NAME)p
XFd(\))356 b Fj(Gets)11 b(info)g(by)g(name.)354 500 y Fd(getpwuid\()p
XFf(UID)p Fd(\))428 b Fj(Gets)11 b(info)g(by)g(uid.)354 564
Xy Fd(setpwent)530 b Fj(Resets)12 b(lookup)e(processing.)354
X654 y Fg(group)354 711 y Fj(Returns)i(\()p Fi($)p Fj(name,)g
XFi($)q Fj(passwd,)f Fi($)p Fj(gid,)g Fi($)q Fj(members\).)354
X775 y Fd(endgrent)533 b Fj(Ends)11 b(lookup)f(processing.)354
X840 y Fd(getgrgid\()p Ff(GID)p Fd(\))442 b Fj(Gets)11 b(info)g(by)g(group)g
X(id.)354 905 y Fd(getgrnam\()p Ff(NAME)p Fd(\))372 b Fj(Gets)11
Xb(info)g(by)g(name.)354 970 y Fd(getgrent)544 b Fj(Gets)11
Xb(next)g(info.)354 1034 y Fd(setgrent)546 b Fj(Resets)12 b(lookup)e
X(processing.)354 1124 y Fg(hosts)354 1180 y Fj(Returns)i(\()p
XFi($)p Fj(name,)g Fi($)q Fj(aliases,)f Fi($)p Fj(addrtype,)h
XFi($)p Fj(length,)f(@addrs\).)354 1245 y Fd(endhostent)487
Xb Fj(Ends)11 b(lookup)f(processing.)354 1310 y Fd(gethostbyaddr\()p
XFf(ADDR)p Fd(,)p Ff(ADDR)o(TYPE)p Fd(\))39 b Fj(Gets)11 b(info)g(by)g
X(address.)354 1375 y Fd(gethostbyname\()p Ff(NAME)p Fd(\))255
Xb Fj(Gets)11 b(info)g(by)g(name.)354 1439 y Fd(gethostent)498
Xb Fj(Gets)11 b(next)g(info.)354 1504 y Fd(sethostent\()p Ff(ST)m(A)m(YOPEN)p
XFd(\))251 b Fj(Resets)12 b(lookup)e(processing.)354 1594 y
XFg(networks)354 1650 y Fj(Returns)i(\()p Fi($)p Fj(name,)g
XFi($)q Fj(aliases,)f Fi($)p Fj(addrtype,)h Fi($)p Fj(net\).)354
X1715 y Fd(endnetent)512 b Fj(Ends)11 b(lookup)f(processing.)354
X1780 y Fd(getnetbyaddr\()p Ff(ADDR)p Fd(,)p Ff(TYPE)p Fd(\))181
Xb Fj(Gets)11 b(info)g(by)g(address)h(and)f(type.)354 1845 y
XFd(getnetbyname\()p Ff(NAME)p Fd(\))280 b Fj(Gets)11 b(info)g(by)g(name.)354
X1909 y Fd(getnetent)523 b Fj(Gets)11 b(next)g(info.)354 1974
Xy Fd(setnetent\()p Ff(ST)m(A)m(YOPEN)p Fd(\))276 b Fj(Resets)12
Xb(lookup)e(processing.)354 2064 y Fg(services)354 2120 y Fj(Returns)i(\()p
XFi($)p Fj(name,)g Fi($)q Fj(aliases,)f Fi($)p Fj(port,)h Fi($)p
XFj(proto\).)354 2185 y Fd(endservent)489 b Fj(Ends)11 b(lookup)f(processing.)
X354 2250 y Fd(getservbyname\()p Ff(NAME)p Fd(,)i Ff(PROT)o(O)p
XFd(\))87 b Fj(Gets)11 b(info)g(by)g(name.)354 2315 y Fd(getservbyport\()p
XFf(POR)o(T)p Fd(,)j Ff(PROT)o(O)p Fd(\))120 b Fj(Gets)11 b(info)g(by)g(port.)
X354 2379 y Fd(getservent)500 b Fj(Gets)11 b(next)g(info.)354
X2444 y Fd(setservent\()p Ff(ST)m(A)m(YOPEN)p Fd(\))253 b Fj(Resets)12
Xb(lookup)e(processing.)354 2534 y Fg(protocols)354 2590 y Fj(Returns)i(\()p
XFi($)p Fj(name,)g Fi($)q Fj(aliases,)f Fi($)p Fj(proto\).)354
X2655 y Fd(endprotoent)469 b Fj(Ends)11 b(lookup)f(processing.)354
X2720 y Fd(getprotobyname\()p Ff(NAME)p Fd(\))237 b Fj(Gets)11
Xb(info)g(by)g(name.)354 2784 y Fd(getprotobynumber\()p Ff(NUMBER)p
XFd(\))134 b Fj(Gets)11 b(info)g(by)g(number)m(.)354 2849 y
XFd(getprotoent)480 b Fj(Gets)11 b(next)g(info.)354 2914 y Fd(setprotoent\()p
XFf(ST)m(A)m(YOPEN)p Fd(\))233 b Fj(Resets)12 b(lookup)e(processing.)p
X354 3018 1512 3 v 354 3065 a Fg(15)p eop
X%%Page: 16 18
Xbop 1362 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(23.)19 b(Regular)i(expressions)p 355 19 1512
X2 v 354 119 a Fj(Each)12 b(character)h(matches)e(itself,)g(unless)g(it)f(is)h
X(one)h(of)f(the)g(special)g(characters)354 176 y Fi(+?.*\(\)[])q({}|)t(\\)p
XFj(.)354 241 y Fi(.)91 b Fj(matches)11 b(an)h(arbitrary)g(character)n(,)h
X(but)e(not)f(a)i(newline.)354 305 y Fi(\()p Fj(.)c(.)g(.)h
XFi(\))21 b Fj(groups)11 b(a)g(series)h(of)f(pattern)g(elements)g(to)g(a)h
X(single)e(element.)354 370 y Fi(+)91 b Fj(matches)11 b(the)h(preceding)f
X(pattern)g(element)g(one)h(or)f(more)g(times.)354 435 y Fi(?)91
Xb Fj(matches)11 b(zero)h(or)g(one)f(times.)354 500 y Fi(*)91
Xb Fj(matches)11 b(zero)h(or)g(more)f(times.)354 564 y Fi({)q
XFf(N)p Fi(,)p Ff(M)p Fi(})21 b Fj(denotes)11 b(the)g(minimum)e
XFf(N)i Fj(and)h(maximum)d Ff(M)i Fj(match)g(count.)h Fi({)p
XFf(N)p Fi(})g Fj(means)472 621 y(exactly)g Ff(N)f Fj(times;)f
XFi({)p Ff(N)p Fi(,})j Fj(means)e(at)g(least)g Ff(N)h Fj(times.)354
X686 y Fi([)p Fj(.)c(.)g(.)h Fi(])21 b Fj(denotes)11 b(a)g(class)h(of)f
X(characters)i(to)e(match.)g Fi([\303)q Fj(.)d(.)g(.)g Fi(])k
XFj(negates)f(the)g(class.)354 750 y Fi(\()p Fj(.)d(.)g(.)h
XFi(|)p Fj(.)f(.)g(.)g Fi(|)p Fj(.)g(.)g(.)g Fi(\))22 b Fj(matches)11
Xb(one)g(of)g(the)h(alternatives.)354 815 y(Non-alphanumerics)f(can)h(be)f
X(escaped)h(from)f(their)g(special)h(meaning)e(using)h(a)g Fi(\\)p
XFj(.)354 880 y Fi(\\w)64 b Fj(matches)11 b(alphanumeric,)h(including)e(\252)p
XFi(_)p Fj(\272,)j Fi(\\W)f Fj(matches)f(non-alphanumeric.)354
X945 y Fi(\\b)64 b Fj(matches)11 b(word)h(boundaries,)f Fi(\\B)h
XFj(matches)f(non-boundaries.)354 1009 y Fi(\\s)64 b Fj(matches)11
Xb(whitespace,)h Fi(\\S)g Fj(matches)f(non-whitespace.)354 1074
Xy Fi(\\d)64 b Fj(matches)11 b(numeric,)h Fi(\\D)g Fj(matches)f(non-numeric.)
X354 1139 y Fi(\\n)p Fj(,)i Fi(\\r)p Fj(,)g Fi(\\f)p Fj(,)f
XFi(\\t)g Fj(etc.)22 b(have)11 b(their)h(usual)e(meaning.)354
X1204 y Fi(\\w)p Fj(,)j Fi(\\s)f Fj(and)g Fi(\\d)21 b Fj(may)11
Xb(be)h(used)f(within)f(character)j(classes,)e Fi(\\b)h Fj(denotes)f
X(backspace)h(in)472 1260 y(this)f(context.)354 1325 y Fi(\\1)p
XFj(.)d(.)g(.)h Fi(\\9)22 b Fj(refer)12 b(to)f(matched)g(sub-expressions,)g
X(grouped)g(with)f Fi(\(\))p Fj(,)j(inside)e(the)g(match.)354
X1390 y Fi(\\10)37 b Fj(and)12 b(up)f(can)h(also)f(be)g(used)g(if)h(the)f
X(pattern)g(matches)g(that)g(many)g(sub-expressions.)354 1454
Xy(See)i(also)e Fi($1)p Fj(.)d(.)g(.)g Fi($9)p Fj(,)13 b Fi($+)p
XFj(,)g Fi($&)p Fj(,)f Fi($`)h Fj(and)e Fi($')h Fj(in)f(section)g(\252Special)
Xh(V)-5 b(ariables\272.)355 1578 y Fl(24.)19 b(Special)h(variables)p
X355 1599 V 354 1699 a Fj(The)12 b(following)e(variables)h(are)h(global)f(and)
Xg(should)f(be)i(localized)f(in)g(subroutines:)354 1764 y Fi($_)64
Xb Fj(The)12 b(default)f(input)f(and)i(pattern-searching)f(space.)354
X1829 y Fi($.)64 b Fj(The)12 b(current)g(input)e(line)h(number)g(of)g(the)g
X(last)g(\256lehandle)h(that)f(was)g(read.)354 1893 y Fi($/)64
Xb Fj(The)12 b(input)e(record)i(separator)n(,)h(newline)e(by)g(default.)g(May)
Xg(be)h(multi-character)m(.)354 1958 y Fi($,)64 b Fj(The)12
Xb(output)e(\256eld)i(separator)f(for)h(the)f(print)g(operator)m(.)354
X2023 y Fi($")64 b Fj(The)12 b(separator)g(which)f(joins)f(elements)h(of)g
X(arrays)h(interpolated)f(in)g(strings.)354 2088 y Fi($\\)64
Xb Fj(The)12 b(output)e(record)i(separator)g(for)f(the)h(print)e(operator)m(.)
X354 2152 y Fi($#)64 b Fj(The)12 b(output)e(format)h(for)h(printed)f(numbers.)
Xg(Initial)f(value)h(is)g(\252)p Fi(\045.20g)p Fj(\272.)354
X2217 y Fi($*)64 b Fj(Set)12 b(to)f(1)g(to)g(do)g(multiline)f(matching)g
X(within)g(a)i(string,)f(0)g(to)g(assume)g(strings)f(contain)472
X2274 y(a)i(single)f(line.)g(Default)g(is)g(0.)354 2338 y Fi($?)64
Xb Fj(The)12 b(status)e(returned)i(by)f(the)g(last)g Fi(`)p
XFf(COMMAND)p Fi(`)p Fj(,)h(pipe)f(close)g(or)g Fd(system)472
X2395 y Fj(operator)m(.)354 2460 y Fi($])64 b Fj(The)12 b(perl)f(version)g
X(string)g(\(as)g(displayed)g(with)f Fi(perl)29 b(-v)p Fj(\),)13
Xb(or)f(version)e(number)m(.)354 2524 y Fi($[)64 b Fj(The)12
Xb(index)f(of)g(the)g(\256rst)h(element)f(in)g(an)g(array)m(,)i(and)e(of)h
X(the)f(\256rst)g(character)i(in)e(a)472 2581 y(substring.)g(Default)g(is)g
X(0.)354 2646 y Fi($;)64 b Fj(The)12 b(subscript)e(separator)i(for)g
X(multi-dimensional)c(array)k(emulation.)f(Default)g(is)472
X2702 y Fi("\\034")p Fj(.)354 2767 y Fi($!)64 b Fj(If)12 b(used)f(in)g(a)h
X(numeric)f(context,)g(yields)g(the)g(current)h(value)f(of)h(errno.)g(If)g
X(used)f(in)g(a)472 2823 y(string)g(context,)g(yields)g(the)g(corresponding)g
X(error)h(string.)354 2888 y Fi($@)64 b Fj(The)12 b(perl)f(error)h(message)g
X(from)f(the)g(last)g(eval)g(or)h Fd(do)g Ff(EXPR)e Fj(command.)p
X354 3018 1512 3 v 1811 3065 a Fg(16)p eop
X%%Page: 17 19
Xbop 354 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 354 -12 a Fi($:)64 b Fj(The)12 b(set)f(of)g(characters)i(after)f(which)f
X(a)h(string)e(may)h(be)h(broken)f(to)g(\256ll)g(continuation)472
X45 y(\256elds)h(\(starting)e(with)h(\252)p Fi(\303)p Fj(\272\))i(in)e(a)g
X(format.)354 110 y Fi($0)64 b Fj(The)12 b(name)f(of)h(the)f(\256le)h
X(containing)e(the)h(perl)g(script)g(being)g(executed.)h(May)f(be)472
X166 y(assigned)g(to.)354 231 y Fi($$)64 b Fj(The)12 b(process)f(number)g(of)h
X(the)f(perl)g(running)g(this)f(script.)h(Altered)h(\(in)f(the)g(child)472
X287 y(process\))h(by)f Fd(fork)p Fj(.)354 352 y Fi($<)64 b
XFj(The)12 b(real)g(uid)e(of)i(this)e(process.)354 417 y Fi($>)64
Xb Fj(The)12 b(ef)o(fective)g(uid)f(of)g(this)g(process.)354
X482 y Fi($\()64 b Fj(The)12 b(real)g(gid)e(of)i(this)e(process.)354
X546 y Fi($\))64 b Fj(The)12 b(ef)o(fective)g(gid)f(of)g(this)g(process.)354
X611 y Fi($\303D)37 b Fj(The)12 b(debug)f(\257ags)h(as)f(passed)g(to)g(perl)h
X(using)e Fi(-D)i Fj(.)354 676 y Fi($\303F)37 b Fj(The)12 b(highest)e(system)g
X(\256le)i(descriptor)n(,)g(ordinarily)e(2.)354 741 y Fi($\303I)37
Xb Fj(In-place)12 b(edit)f(extension)g(as)g(passed)g(to)g(perl)h(using)e
XFi(-i)i Fj(.)354 805 y Fi($\303L)37 b Fj(Formfeed)12 b(character)h(used)e(in)
Xg(formats.)354 870 y Fi($\303P)37 b Fj(Internal)12 b(debugging)e(\257ag.)354
X935 y Fi($\303T)37 b Fj(The)12 b(time)e(\(as)i(delivered)f(by)h
XFd(time)p Fj(\))e(when)i(the)f(program)g(started.)h(This)e(value)i(is)472
X991 y(used)g(by)f(the)g(\256le)h(test)e(operators)i(\252)p
XFi(-M)p Fj(\272,)h(\252)p Fi(-A)p Fj(\272)g(and)e(\252)p Fi(-C)p
XFj(\272.)354 1056 y Fi($\303W)37 b Fj(The)12 b(value)f(if)g(the)h
XFi(-w)g Fj(option)e(as)i(passed)f(to)g(perl.)354 1121 y Fi($\303X)37
Xb Fj(The)12 b(name)f(by)g(which)g(this)g(perl)g(was)h(invoked.)354
X1186 y(The)g(following)e(variables)h(are)h(context)f(dependent)g(and)g(need)h
X(not)f(be)g(localized:)354 1250 y Fi($\045)64 b Fj(The)12 b(current)g(page)f
X(number)g(of)h(the)f(currently)g(selected)h(output)e(channel.)354
X1315 y Fi($=)64 b Fj(The)12 b(page)f(length)g(of)h(the)f(current)g(output)g
X(channel.)g(Default)h(is)f(60)g(lines.)354 1380 y Fi($-)64
Xb Fj(The)12 b(number)f(of)g(lines)g(left)g(on)g(the)g(page.)354
X1445 y Fi($\304)64 b Fj(The)12 b(name)f(of)h(the)f(current)h(report)f
X(format.)354 1509 y Fi($\303)64 b Fj(The)12 b(name)f(of)h(the)f(current)h
X(top-of-page)f(format.)354 1574 y Fi($|)64 b Fj(If)12 b(set)f(to)g(nonzero,)h
X(forces)g(a)g(\257ush)f(after)h(every)g(write)f(or)h(print)e(on)h(the)h
X(currently)472 1631 y(selected)g(output)e(channel.)i(Default)f(is)g(0.)354
X1695 y Fi($ARGV)23 b Fj(The)11 b(name)h(of)f(the)g(current)h(\256le)g(when)f
X(reading)h(from)f Fi(<>)h Fj(.)354 1760 y(The)g(following)e(variables)h(are)h
X(always)f(local)h(to)f(the)g(current)g(block:)354 1825 y Fi($&)64
Xb Fj(The)12 b(string)e(matched)h(by)g(the)h(last)f(successful)g(pattern)g
X(match.)354 1890 y Fi($`)64 b Fj(The)12 b(string)e(preceding)i(what)f(was)g
X(matched)g(by)h(the)f(last)g(successful)g(match.)354 1954 y
XFi($')64 b Fj(The)12 b(string)e(following)g(what)h(was)h(matched)f(by)g(the)g
X(last)g(successful)g(match.)354 2019 y Fi($+)64 b Fj(The)12
Xb(last)f(bracket)h(matched)f(by)g(the)g(last)g(search)h(pattern.)354
X2084 y Fi($)q(1)p Fj(.)c(.)g(.)g Fi($9)p Fj(.)g(.)g(.)472 2140
Xy(Contains)j(the)g(subpattern)f(from)h(the)g(corresponding)g(set)g(of)g
X(parentheses)g(in)g(the)g(last)472 2197 y(pattern)h(successfully)e(matched.)i
XFi($10)p Fj(.)c(.)g(.)h(and)i(up)g(are)i(only)d(available)h(if)h(the)f(match)
X472 2253 y(contained)g(that)g(many)g(sub-expressions.)355 2376
Xy Fl(25.)19 b(Special)h(arrays)p 355 2397 1512 2 v 354 2498
Xa Fi(@ARGV)42 b Fj(Contains)11 b(the)h(command)e(line)h(ar)o(guments)g(for)g
X(the)h(script)e(\(not)h(including)f(the)531 2554 y(command)h(name\).)354
X2619 y Fi(@INC)69 b Fj(Contains)11 b(the)h(list)e(of)h(places)h(to)f(look)f
X(for)i(perl)f(scripts)g(to)g(be)g(evaluated)h(by)f(the)531
X2676 y Fd(do)i Ff(FILENAME)d Fj(and)h Fd(require)h Fj(commands.)354
X2740 y Fi(@_)123 b Fj(Parameter)11 b(array)g(for)f(subroutines.)f(Also)g
X(used)h(by)f Fd(split)g Fj(if)h(not)f(in)h(array)g(context.)354
X2805 y Fi(\045ENV)69 b Fj(Contains)11 b(the)h(current)f(environment.)354
X2870 y Fi(\045INC)69 b Fj(List)11 b(of)g(\256les)h(that)f(have)g(been)h
XFd(require)p Fj(d)g(or)g Fd(do)p Fj(ne.)354 2935 y Fi(\045SIG)69
Xb Fj(Used)12 b(to)f(set)g(signal)f(handlers)h(for)h(various)f(signals.)p
X354 3018 1512 3 v 354 3065 a Fg(17)p eop
X%%Page: 18 20
Xbop 1362 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(26.)19 b(The)i(perl)f(debugger)p 355 19 1512
X2 v 354 119 a Fj(The)12 b(perl)f(symbolic)f(debugger)h(is)g(invoked)g(with)f
XFi(perl)29 b(-d)p Fj(.)354 184 y Fi(h)269 b Fj(Prints)11 b(out)f(a)i(help)f
X(message.)354 249 y Fi(T)269 b Fj(Stack)11 b(trace.)354 314
Xy Fi(s)269 b Fj(Single)11 b(steps.)354 378 y Fi(n)269 b Fj(Single)11
Xb(steps)f(around)i(subroutine)e(call.)354 443 y Fi(r)269 b
XFj(Returns)11 b(from)g(the)g(current)h(subroutine.)354 508
Xy Fi(c)g Fj([)p Ff(LINE)p Fj(])134 b(Continues)10 b(\(until)h
XFf(LINE)p Fj(,)g(or)g(another)h(breakpoint)e(or)i(exit\).)p
X354 530 112 2 v 354 585 2 56 v 368 573 a Ff(RET)p 464 585 V
X354 587 112 2 v 199 w Fj(Repeats)g(last)e Fi(s)i Fj(or)g Fi(n)p
XFj(.)354 637 y Fi(l)g Fj([)p Ff(RANGE)p Fj(])79 b(Lists)10
Xb(a)i(range)f(of)h(lines.)f Ff(RANGE)g Fj(may)g(be)g(a)h(number)n(,)g
X(start-end,)650 694 y(start+amount,)e(or)h(a)h(subroutine)e(name.)i(If)g
X(omitted,)e(lists)g(next)h(window)m(.)354 759 y Fi(f)h Ff(FILE)169
Xb Fj(Switches)11 b(to)g Ff(FILE)g Fj(and)g(start)g(listing)f(it.)354
X823 y Fi(-)269 b Fj(Lists)10 b(previous)h(window)m(.)354 888
Xy Fi(w)269 b Fj(Lists)10 b(window)g(around)i(current)f(line.)354
X953 y Fi(l)h Ff(SUB)171 b Fj(Lists)10 b(the)h(named)g Ff(SUB)p
XFj(routine.)354 1018 y Fi(/)p Ff(P)m(A)m(TTERN)p Fi(/)54 b
XFj(Forward)12 b(search)g(for)f Ff(P)m(A)m(TTERN)p Fj(.)354
X1082 y Fi(?)p Ff(P)m(A)m(TTERN)p Fi(?)54 b Fj(Backward)12 b(search)g(for)g
XFf(P)m(A)m(TTERN)p Fj(.)354 1147 y Fi(L)269 b Fj(Lists)10 b(lines)h(that)f
X(have)i(breakpoints)f(or)g(actions.)354 1212 y Fi(S)269 b Fj(List)10
Xb(the)h(names)g(of)h(all)f(subroutines.)354 1277 y Fi(t)269
Xb Fj(T)m(oggles)10 b(trace)i(mode.)354 1342 y Fi(b)g Fj([)p
XFf(LINE)f Fj([)p Ff(CONDITION)p Fj(]])650 1398 y(Sets)g(breakpoint)g(at)g
XFf(LINE)p Fj(,)g(default:)g(current)h(line.)354 1463 y Fi(b)g
XFf(SUBNAME)e Fj([)p Ff(CONDITION)p Fj(])650 1519 y(Sets)h(breakpoint)g(at)g
X(the)g(subroutine.)354 1584 y Fi(S)269 b Fj(Lists)10 b(names)h(of)g(all)g
X(subroutines.)354 1649 y Fi(d)h Fj([)p Ff(LINE)p Fj(])134 b(Deletes)11
Xb(breakpoint)g(at)g(the)g(given)g(line.)354 1713 y Fi(D)269
Xb Fj(Deletes)11 b(all)g(breakpoints.)354 1778 y Fi(a)h Ff(LINE)f(COMMAND)650
X1835 y Fj(Sets)g(an)h(action)f(for)g(line.)354 1899 y Fi(A)269
Xb Fj(Deletes)11 b(all)g(line)g(actions.)354 1964 y Fi(<)h Ff(COMMAND)37
Xb Fj(Sets)11 b(an)h(action)f(to)g(be)g(executed)h(before)g(every)g(debugger)f
X(prompt.)354 2029 y Fi(>)h Ff(COMMAND)37 b Fj(Sets)11 b(an)h(action)f(to)g
X(be)g(executed)h(before)g(every)g Fi(s)p Fj(,)g Fi(c)g Fj(or)f
XFi(n)h Fj(command.)354 2094 y Fi(V)g Fj([)p Ff(P)m(ACKAGE)e
XFj([)p Ff(V)m(ARS)p Fj(])h(])650 2150 y(Lists)f(all)h(variables)g(in)g(a)h
X(package.)g(Default)g(package)g(is)e(main.)354 2215 y Fi(X)i
XFj([)p Ff(V)m(ARS)p Fj(])116 b(Like)11 b Fi(V)p Fj(,)h(but)f(assumes)f
X(current)i(package.)354 2280 y Fi(!)g Fj([)g([-])p Ff(NUMBER)p
XFj(])650 2336 y(Redo)f(a)h(debugging)e(command.)h(Default)h(is)e(previous)h
X(command.)354 2401 y Fi(H)h Fj([-)p Ff(NUMBER)p Fj(])31 b(Displays)10
Xb(the)h(last)g(-)p Ff(NUMBER)f Fj(commands)h(of)g(more)g(than)g(one)h(letter)
Xm(.)354 2466 y Fi(q)269 b Fj(Quits.)10 b(Y)-5 b(ou)12 b(may)f(also)g(use)g
X(your)p 1199 2423 114 2 v 1199 2479 2 57 v 25 w Ff(EOF)p 1311
X2479 V 1199 2481 114 2 v 26 w Fj(character)m(.)354 2530 y Ff(COMMAND)76
Xb Fj(Executes)11 b Ff(COMMAND)f Fj(as)i(a)f(perl)h(statement.)354
X2595 y Fi(p)g Ff(EXPR)p Fe(y)122 b Fj(Prints)11 b Ff(EXPR)p
XFj(.)354 2660 y Fi(=)h Fj([)p Ff(ALIAS)f(V)m(ALUE)p Fj(])650
X2716 y(Sets)g(alias,)h(or)f(lists)f(current)i(aliases.)p 354
X3018 1512 3 v 1811 3065 a Fg(18)p eop
X%%Page: 19 21
Xbop 354 -101 a Fg(Perl)14 b(Reference)f(Guide)p 354 -89 1512
X3 v 355 -2 a Fl(27.)19 b(Environment)i(variables)p 355 19 1512
X2 v 354 119 a Fj(Perl)12 b(uses)f(the)h(following)e(environment)g(variables.)
X354 184 y Fi(HOME)69 b Fj(Used)12 b(if)f Fd(chdir)h Fj(has)f(no)g(ar)o
X(gument.)354 249 y Fi(LOGDIR)531 305 y Fj(Used)h(if)f Fd(chdir)h
XFj(has)f(no)g(ar)o(gument)g(and)h Fi(HOME)h Fj(is)e(not)f(set.)354
X370 y Fi(PATH)69 b Fj(Used)12 b(in)f(executing)g(subprocesses,)g(and)g(in)g
X(\256nding)g(the)g(perl)h(script)e(if)i Fi(-S)g Fj(is)531 427
Xy(used.)354 491 y Fi(PERLLIB)531 548 y Fj(A)g(colon-separated)f(list)g(of)g
X(directories)g(to)g(look)g(for)g(perl)h(library)f(\256les)h(before)531
X604 y(looking)e(in)h(the)h(standard)f(library)g(and)g(the)g(current)h
X(directory)m(.)354 669 y Fi(PERLDB)531 725 y Fj(The)g(command)e(to)h(get)h
X(the)f(debugger)g(code.)h(Defaults)f(to)531 782 y Fi(require)31
Xb('perldb.pl)q(')s Fj(.)354 967 y Fl(Notes)p 354 988 V 354
X2938 a Fj(Perl)12 b(Reference)i(Guide)d(Revision)g(4.036.1)1345
X2937 y(c)1333 2938 y Fe(\015)p Fj(1989,1993)g(Johan)f(V)m(romans)p
X354 3018 1512 3 v 354 3065 a Fg(19)p eop
X%%Trailer
Xend
Xuserdict /end-hook known{end-hook}if
X%%EOF
END_OF_FILE
  if test 40782 -ne `wc -c <'refbase.ps.B'`; then
    echo shar: \"'refbase.ps.B'\" unpacked with wrong size!
  elif test -f 'refbase.ps.A'; then
    echo shar: Combining  \"'refbase.ps'\" \(86092 characters\)
    cat 'refbase.ps.A' 'refbase.ps.B' > 'refbase.ps'
    if test 86092 -ne `wc -c <'refbase.ps'`; then
      echo shar: \"'refbase.ps'\" combined with wrong size!
    else
      rm refbase.ps.A refbase.ps.B
    fi
  fi
  # end of 'refbase.ps.B'
fi
echo shar: End of archive 3 \(of 3\).
cp /dev/null ark3isdone
MISSING=""
for I in 1 2 3 ; do
    if test ! -f ark${I}isdone ; then
    MISSING="${MISSING} ${I}"
    fi
done
if test "${MISSING}" = "" ; then
    echo You have unpacked all 3 archives.
    rm -f ark[1-9]isdone
else
    echo You still must unpack the following archives:
    echo "        " ${MISSING}
fi
exit 0
exit 0 # Just in case...