-- Perl 5.8.6 documentation --
File::Spec::VMS
View as PDF

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)

    • Use VMS syntax when converting filespecs.

SEE ALSO

See File::Spec and File::Spec::Unix. This package overrides the implementation of these methods, not the semantics.

An explanation of VMS file specs can be found at "http://h71000.www7.hp.com/doc/731FINAL/4506/4506pro_014.html#apps_locating_naming_files".