CONTENTS

• NAME
• SYNOPSIS
• DESCRIPTION
  • Methods always loaded
• COPYRIGHT
• SEE ALSO

#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.

#COPYRIGHT

Copyright (c) 2004 by the Perl 5 Porters. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

#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 "/h71000.www7.hp.com/doc/731FINAL/4506/4506pro_014.html#apps_locating_naming_files"" in "http:.

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.