1Net::FTPServer::Full::DUisreHranCdolnet(r3i)buted Perl DNoectu:m:eFnTtPaSteirovner::Full::DirHandle(3)
2
3
4
6 Net::FTPServer::Full::DirHandle - The full FTP server personality
7
9 use Net::FTPServer::Full::DirHandle;
10
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
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
96 Net::FTPServer(3), perl(1)
97
98
99
100perl v5.30.0 2019-07-26Net::FTPServer::Full::DirHandle(3)