Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery
 
PerlMonks  

perlman:perlport2

by gods (Initiate)
on Aug 25, 1999 at 06:56 UTC ( [id://412]=perlman: print w/replies, xml ) Need Help??

perlport2

Current Perl documentation can be found at perldoc.perl.org.

Here is our local, out-dated (pre-5.6) version:


Alphabetical Listing of Perl Functions

-X FILEHANDLE
-X EXPR
-X

-r, -w, and -x have only a very limited meaning; directories and applications are executable, and there are no uid/gid considerations. -o is not supported. (Mac OS)

-r, -w, -x, and -o tell whether or not file is accessible, which may not reflect UIC-based file protections. (VMS)

perlman:perlop returns the size of the data fork, not the total size of data fork plus resource fork. (Mac OS).

perlman:perlop by name on an open file will return the space reserved on disk, rather than the current extent. perlman:perlop on an open filehandle returns the current size. (RISC OS)

-R, -W, -X, -O are indistinguishable from -r, -w, -x, -o. (Mac OS, Win32, VMS, RISC OS)

-b, -c, -k, -g, -p, -u, -A are not implemented. (Mac OS)

-g, -k, -l, -p, -u, -A are not particularly meaningful. (Win32, VMS, RISC OS)

-d is true if passed a device spec without an explicit directory. (VMS)

-T and -B are implemented, but might misclassify Mac text files with foreign characters; this is the case will all platforms, but may affect Mac OS often. (Mac OS)

-x (or -X) determine if a file ends in one of the executable suffixes. -S is meaningless. (Win32)

-x (or -X) determine if a file has an executable file type. (RISC OS)

binmode FILEHANDLE

Meaningless. (Mac OS, RISC OS)

Reopens file and restores pointer; if function fails, underlying filehandle may be closed, or pointer may be in a different position. (VMS)

The value returned by tell may be affected after the call, and the filehandle may be flushed. (Win32)

chmod LIST

Only limited meaning. Disabling/enabling write permission is mapped to locking/unlocking the file. (Mac OS)

Only good for changing ``owner'' read-write access, ``group'', and ``other'' bits are meaningless. (Win32)

Only good for changing ``owner'' and ``other'' read-write access. (RISC OS)

chown LIST

Not implemented. (Mac OS, Win32, Plan9, RISC OS)

Does nothing, but won't fail. (Win32)

chroot FILENAME
chroot

Not implemented. (Mac OS, Win32, VMS, Plan9, RISC OS)

crypt PLAINTEXT,SALT

May not be available if library or source was not provided when building perl. (Win32)

dbmclose HASH

Not implemented. (VMS, Plan9)

dbmopen HASH,DBNAME,MODE

Not implemented. (VMS, Plan9)

dump LABEL

Not useful. (Mac OS, RISC OS)

Not implemented. (Win32)

Invokes VMS debugger. (VMS)

exec LIST

Not implemented. (Mac OS)

fcntl FILEHANDLE,FUNCTION,SCALAR

Not implemented. (Win32, VMS)

flock FILEHANDLE,OPERATION

Not implemented (Mac OS, VMS, RISC OS).

Available only on Windows NT (not on Windows 95). (Win32)

fork

Not implemented. (Mac OS, Win32, AmigaOS, RISC OS)

getlogin

Not implemented. (Mac OS, RISC OS)

getpgrp PID

Not implemented. (Mac OS, Win32, VMS, RISC OS)

getppid

Not implemented. (Mac OS, Win32, VMS, RISC OS)

getpriority WHICH,WHO

Not implemented. (Mac OS, Win32, VMS, RISC OS)

getpwnam NAME

Not implemented. (Mac OS, Win32)

Not useful. (RISC OS)

getgrnam NAME

Not implemented. (Mac OS, Win32, VMS, RISC OS)

getnetbyname NAME

Not implemented. (Mac OS, Win32, Plan9)

getpwuid UID

Not implemented. (Mac OS, Win32)

Not useful. (RISC OS)

getgrgid GID

Not implemented. (Mac OS, Win32, VMS, RISC OS)

getnetbyaddr ADDR,ADDRTYPE

Not implemented. (Mac OS, Win32, Plan9)

getprotobynumber NUMBER

Not implemented. (Mac OS)

getservbyport PORT,PROTO

Not implemented. (Mac OS)

getpwent

Not implemented. (Mac OS, Win32)

getgrent

Not implemented. (Mac OS, Win32, VMS)

gethostent

Not implemented. (Mac OS, Win32)

getnetent

Not implemented. (Mac OS, Win32, Plan9)

getprotoent

Not implemented. (Mac OS, Win32, Plan9)

getservent

Not implemented. (Win32, Plan9)

setpwent

Not implemented. (Mac OS, Win32, RISC OS)

setgrent

Not implemented. (Mac OS, Win32, VMS, RISC OS)

sethostent STAYOPEN

Not implemented. (Mac OS, Win32, Plan9, RISC OS)

setnetent STAYOPEN

Not implemented. (Mac OS, Win32, Plan9, RISC OS)

setprotoent STAYOPEN

Not implemented. (Mac OS, Win32, Plan9, RISC OS)

setservent STAYOPEN

Not implemented. (Plan9, Win32, RISC OS)

endpwent

Not implemented. (Mac OS, Win32)

endgrent

Not implemented. (Mac OS, Win32, VMS, RISC OS)

endhostent

Not implemented. (Mac OS, Win32)

endnetent

Not implemented. (Mac OS, Win32, Plan9)

endprotoent

Not implemented. (Mac OS, Win32, Plan9)

endservent

Not implemented. (Plan9, Win32)

getsockopt SOCKET,LEVEL,OPTNAME

Not implemented. (Mac OS, Plan9)

glob EXPR
glob

Globbing built-in, but only * and ? metacharacters are supported. (Mac OS)

Features depend on external perlglob.exe or perlglob.bat. May be overridden with something like File::DosGlob, which is recommended. (Win32)

Globbing built-in, but only * and ? metacharacters are supported. Globbing relies on operating system calls, which may return filenames in any order. As most filesystems are case-insensitive, even ``sorted'' filenames will not be in case-sensitive order. (RISC OS)

ioctl FILEHANDLE,FUNCTION,SCALAR

Not implemented. (VMS)

Available only for socket handles, and it does what the ioctlsocket() call in the Winsock API does. (Win32)

Available only for socket handles. (RISC OS)

kill LIST

Not implemented, hence not useful for taint checking. (Mac OS, RISC OS)

Available only for process handles returned by the system(1, ...) method of spawning a process. (Win32)

link OLDFILE,NEWFILE

Not implemented. (Mac OS, Win32, VMS, RISC OS)

lstat FILEHANDLE
lstat EXPR
lstat

Not implemented. (VMS, RISC OS)

Return values may be bogus. (Win32)

msgctl ID,CMD,ARG
msgget KEY,FLAGS
msgsnd ID,MSG,FLAGS
msgrcv ID,VAR,SIZE,TYPE,FLAGS

Not implemented. (Mac OS, Win32, VMS, Plan9, RISC OS)

open FILEHANDLE,EXPR
open FILEHANDLE

The | variants are only supported if ToolServer is installed. (Mac OS)

open to |- and -| are unsupported. (Mac OS, Win32, RISC OS)

pipe READHANDLE,WRITEHANDLE

Not implemented. (Mac OS)

readlink EXPR
readlink

Not implemented. (Win32, VMS, RISC OS)

select RBITS,WBITS,EBITS,TIMEOUT

Only implemented on sockets. (Win32)

Only reliable on sockets. (RISC OS)

semctl ID,SEMNUM,CMD,ARG
semget KEY,NSEMS,FLAGS
semop KEY,OPSTRING

Not implemented. (Mac OS, Win32, VMS, RISC OS)

setpgrp PID,PGRP

Not implemented. (Mac OS, Win32, VMS, RISC OS)

setpriority WHICH,WHO,PRIORITY

Not implemented. (Mac OS, Win32, VMS, RISC OS)

setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL

Not implemented. (Mac OS, Plan9)

shmctl ID,CMD,ARG
shmget KEY,SIZE,FLAGS
shmread ID,VAR,POS,SIZE
shmwrite ID,STRING,POS,SIZE

Not implemented. (Mac OS, Win32, VMS, RISC OS)

socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL

Not implemented. (Mac OS, Win32, VMS, RISC OS)

stat FILEHANDLE
stat EXPR
stat

mtime and atime are the same thing, and ctime is creation time instead of inode change time. (Mac OS)

device and inode are not meaningful. (Win32)

device and inode are not necessarily reliable. (VMS)

mtime, atime and ctime all return the last modification time. Device and inode are not necessarily reliable. (RISC OS)

symlink OLDFILE,NEWFILE

Not implemented. (Win32, VMS, RISC OS)

syscall LIST

Not implemented. (Mac OS, Win32, VMS, RISC OS)

sysopen FILEHANDLE,FILENAME,MODE,PERMS

The traditional ``0'', ``1'', and ``2'' MODEs are implemented with different numeric values on some systems. The flags exported by Fcntl (O_RDONLY, O_WRONLY, O_RDWR) should work everywhere though. ( Mac OS, OS/390)

system LIST

Only implemented if ToolServer is installed. (Mac OS)

As an optimization, may not call the command shell specified in $ENV{PERL5SHELL}. system(1, @args) spawns an external process and immediately returns its process designator, without waiting for it to terminate. Return value may be used subsequently in wait or waitpid. (Win32)

There is no shell to process metacharacters, and the native standard is to pass a command line terminated by ``\n'' ``\r'' or ``\0'' to the spawned program. Redirection such as > foo is performed (if at all) by the run time library of the spawned program. system list will call the Unix emulation library's exec emulation, which attempts to provide emulation of the stdin, stdout, stderr in force in the parent, providing the child program uses a compatible version of the emulation library. scalar will call the native command line direct and no such emulation of a child Unix program will exists. Mileage will vary. (RISC OS)

times

Only the first entry returned is nonzero. (Mac OS)

``cumulative'' times will be bogus. On anything other than Windows NT, ``system'' time will be bogus, and ``user'' time is actually the time returned by the clock() function in the C runtime library. (Win32)

Not useful. (RISC OS)

truncate FILEHANDLE,LENGTH
truncate EXPR,LENGTH

Not implemented. (VMS)

umask EXPR
umask

Returns undef where unavailable, as of version 5.005.

utime LIST

Only the modification time is updated. (Mac OS, VMS, RISC OS)

May not behave as expected. Behavior depends on the C runtime library's implementation of utime(), and the filesystem being used. The FAT filesystem typically does not support an ``access time'' field, and it may limit timestamps to a granularity of two seconds. (Win32)

wait
waitpid PID,FLAGS

Not implemented. (Mac OS)

Can only be applied to process handles returned for processes spawned using system(1, ...). (Win32)

Not useful. (RISC OS)


CHANGES

  1. 33, 06 August 1998

    Integrate more minor changes.

  2. 32, 05 August 1998 Integrate more minor changes.

  3. 30, 03 August 1998 Major update for RISC OS, other minor changes.

  4. 23, 10 July 1998 First public release with perl5.005.


AUTHORS / CONTRIBUTORS

Abigail <abigail@fnx.com>, Charles Bailey <bailey@genetics.upenn.edu>, Graham Barr <gbarr@pobox.com>, Tom Christiansen <tchrist@perl.com>, Nicholas Clark <Nicholas.Clark@liverpool.ac.uk>, Andy Dougherty <doughera@lafcol.lafayette.edu>, Dominic Dunlop <domo@vo.lu>, M.J.T. Guy <mjtg@cus.cam.ac.uk>, Luther Huffman <lutherh@stratcom.com>, Nick Ing-Simmons <nick@ni-s.u-net.com>, Andreas J. König <koenig@kulturbox.de>, Andrew M. Langmead <aml@world.std.com>, Paul Moore <Paul.Moore@uk.origin-it.com>, Chris Nandor <pudge@pobox.com>, Matthias Neeracher <neeri@iis.ee.ethz.ch>, Gary Ng <71564.1743@CompuServe.COM>, Tom Phoenix <rootbeer@teleport.com>, Peter Prymmer <pvhp@forte.com>, Hugo van der Sanden <hv@crypt0.demon.co.uk>, Gurusamy Sarathy <gsar@umich.edu>, Paul J. Schinder <schinder@pobox.com>, Dan Sugalski <sugalskd@ous.edu>, Nathan Torkington <gnat@frii.com>.

This document is maintained by Chris Nandor.


VERSION

Version 1.34, last modified 07 August 1998.



Return to the Library
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others perusing the Monastery: (6)
As of 2024-03-28 23:34 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found