home | O'Reilly's CD bookshelfs | FreeBSD | Linux | Cisco | Cisco Exam  


List


$

FTP



->List(
[

pattern

, 

listmode

]
)
$

FTP


->Ls
([

pattern

, 

listmode

])
$

FTP


->Dir
([

pattern

, 

listmode

])

Returns a list containing the files found in the current directory, matching the given pattern , if specified. The content of the returned list depends on the listmode parameter, which can have the following values:

1 (default)

The list contains the names of the files found.

2

The list contains seven values for each file:

  • The file name

  • The DOS short file name, a.k.a. 8.3

  • The size

  • The attributes

  • The creation time

  • The last access time

  • The last modified time

3

The list contains a reference to a hash for each found file. Each hash contains the following key/value pairs:

name => 
file name

altname => 
DOS short file name, a.k.a. 8.3

size => 
size

attr => 
attributes

ctime => 
creation time

atime => 
last access time

mtime => 
last modified time

All times are reported as strings of the following format: second, hour, minute, day, month, year. For example:

$file->{'mtime'} == "0,10,58,9,12,1996"
# stands for 09 Dec 1996 at 10:58:00