1Net::FTPServer::Full::DUisreHranCdolnet(r3i)buted Perl DNoectu:m:eFnTtPaSteirovner::Full::DirHandle(3)
2
3
4

NAME

6       Net::FTPServer::Full::DirHandle - The full FTP server personality
7

SYNOPSIS

9         use Net::FTPServer::Full::DirHandle;
10

METHODS

12       $handle = $dirh->get ($filename);
13           Return the file or directory $handle corresponding to the file
14           $filename in directory $dirh. If there is no file or subdirectory
15           of that name, then this returns undef.
16
17       $dirh = $dirh->parent;
18           Return the parent directory of the directory $dirh. If the
19           directory is already "/", this returns the same directory handle.
20
21       $ref = $dirh->list ([$wildcard]);
22           Return a list of the contents of directory $dirh. The list returned
23           is a reference to an array of pairs:
24
25             [ $filename, $handle ]
26
27           The list returned does not include "." or "..".
28
29           The list is sorted into alphabetical order automatically.
30
31       $ref = $dirh->list_status ([$wildcard]);
32           Return a list of the contents of directory $dirh and status
33           information. The list returned is a reference to an array of
34           triplets:
35
36             [ $filename, $handle, $statusref ]
37
38           where $statusref is the tuple returned from the "status" method
39           (see Net::FTPServer::Handle).
40
41           The list returned does not include "." or "..".
42
43           The list is sorted into alphabetical order automatically.
44
45       ($mode, $perms, $nlink, $user, $group, $size, $time) = $handle->status;
46           Return the file or directory status. The fields returned are:
47
48             $mode     Mode        'd' = directory,
49                                   'f' = file,
50                                   and others as with
51                                   the find(1) -type option.
52             $perms    Permissions Permissions in normal octal numeric format.
53             $nlink    Link count
54             $user     Username    In printable format.
55             $group    Group name  In printable format.
56             $size     Size        File size in bytes.
57             $time     Time        Time (usually mtime) in Unix time_t format.
58
59           In derived classes, some of this status information may well be
60           synthesized, since virtual filesystems will often not contain
61           information in a Unix-like format.
62
63       $rv = $handle->move ($dirh, $filename);
64           Move the current file (or directory) into directory $dirh and call
65           it $filename. If the operation is successful, return 0, else return
66           -1.
67
68           Underlying filesystems may impose limitations on moves: for
69           example, it may not be possible to move a directory; it may not be
70           possible to move a file to another directory; it may not be
71           possible to move a file across filesystems.
72
73       $rv = $dirh->delete;
74           Delete the current directory. If the delete command was successful,
75           then return 0, else if there was an error return -1.
76
77           It is normally only possible to delete a directory if it is empty.
78
79       $rv = $dirh->mkdir ($name);
80           Create a subdirectory called $name within the current directory
81           $dirh.
82
83       $file = $dirh->open ($filename, "r"|"w"|"a");
84           Open or create a file called $filename in the current directory,
85           opening it for either read, write or append. This function returns
86           a "IO::File" handle object.
87

AUTHORS

89       Richard Jones (rich@annexia.org).
90

92       Copyright (C) 2000 Biblio@Tech Ltd., Unit 2-3, 50 Carnwath Road,
93       London, SW6 3EG, UK
94

SEE ALSO

96       Net::FTPServer(3), perl(1)
97
98
99
100perl v5.34.0                      2021-07-22Net::FTPServer::Full::DirHandle(3)
Impressum