Manpage of File::Spec::VMS

File::Spec::VMS

Section: Perl Programmers Reference Guide (3pm)
Updated: 2001-09-21
Index Return to Main Contents

NAME

File::Spec::VMS - methods for VMS file specs

SYNOPSIS

 require File::Spec::VMS; # Done internally by File::Spec if needed

DESCRIPTION

See File::Spec::Unix for a documentation of the methods provided there. This package overrides the implementation of these methods, not the semantics.

eliminate_macros: Expands MM[KS]/Make macros in a text string, using the contents of identically named elements of %$self, and returns the result as a file specification in Unix syntax.
fixpath: Catchall routine to clean up problem MM[SK]/Make macros. Expands macros in any directory specification, in order to avoid juxtaposing two VMS-syntax directories when MM[SK] is run. Also expands expressions which are all macro, so that we can tell how long the expansion is, and avoid overrunning DCL's command buffer when MM[KS] is running.
If optional second argument has a TRUE value, then the return string is a VMS-syntax directory specification, if it is FALSE, the return string is a VMS-syntax file specification, and if it is not specified, fixpath() checks to see whether it matches the name of a directory in the current default directory, and returns a directory or file specification accordingly.

Methods always loaded

canonpath (override)

Removes redundant portions of file specifications according to VMS syntax.

catdir

Concatenates a list of file specifications, and returns the result as a VMS-syntax directory specification. No check is made for ``impossible'' cases (e.g. elements other than the first being absolute filespecs).

catfile

Concatenates a list of file specifications, and returns the result as a VMS-syntax file specification.

curdir (override)

Returns a string representation of the current directory: '[]'

devnull (override)

Returns a string representation of the null device: '_NLA0:'

rootdir (override)

Returns a string representation of the root directory: 'SYS$DISK:[000000]'

tmpdir (override)

Returns a string representation of the first writable directory from the following list or '' if none are writable:

    sys$scratch:
    $ENV{TMPDIR}

Since perl 5.8.0, if running under taint mode, and if $ENV{TMPDIR} is tainted, it is not used.

updir (override)

Returns a string representation of the parent directory: '[-]'

case_tolerant (override)

VMS file specification syntax is case-tolerant.

path (override)

Translate logical name DCL$PATH as a searchlist, rather than trying to "split" string value of $ENV{'PATH'}.

file_name_is_absolute (override)

Checks for VMS directory spec as well as Unix separators.

splitpath (override)

Splits using VMS syntax.

splitdir (override)

Split dirspec using VMS syntax.

catpath (override)

Construct a complete filespec using VMS syntax

abs2rel (override)

Use VMS syntax when converting filespecs.

rel2abs (override)