perlport2
Current Perl documentation can be found at
perldoc.perl.org.
Here is our local, out-dated (pre-5.6) version:
- -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)
- 33, 06 August 1998
Integrate more minor changes.
- 32, 05 August 1998
Integrate more minor changes.
- 30, 03 August 1998
Major update for
RISC
OS, other minor changes.
- 23, 10 July 1998
First public release with perl5.005.
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 1.34, last modified 07 August 1998.
Return to the Library
|
|