1Net::FTPServer::DirHandUlsee(r3)Contributed Perl DocumenNteatt:i:oFnTPServer::DirHandle(3)
2
3
4
6 Net::FTPServer::DirHandle - A Net::FTPServer directory handle.
7
9 use Net::FTPServer::DirHandle;
10
13 $dirh = new Net::FTPServer::DirHandle ($ftps);
14
15 Create a new directory handle. The directory handle corresponds to
16 "/".
17
18 $dirh = $dirh->parent;
19
20 Return the parent directory of the directory $dirh. If the
21 directory is already "/", this returns the same directory handle.
22
23 $rv = $dirh->is_root;
24
25 Return true if the current directory is the root directory.
26
27 $handle = $dirh->get ($filename);
28
29 Return the file or directory $handle corresponding to the file
30 $filename in directory $dirh. If there is no file or subdirectory
31 of that name, then this returns undef.
32
33 $ref = $dirh->list ([$wildcard]);
34
35 Return a list of the contents of directory $dirh. The list returned
36 is a reference to an array of pairs:
37
38 [ $filename, $handle ]
39
40 The list returned does not include "." or "..".
41
42 The list is sorted into alphabetical order automatically.
43
44 $ref = $dirh->_list_status ([$wildcard]);
45
46 Just a dumb wrapper function. Returns the same thing as
47 list_status(), but also includes the special directories "." and
48 ".." if no wildcard is specified.
49
50 $ref = $dirh->list_status ([$wildcard]);
51
52 Return a list of the contents of directory $dirh and status
53 information. The list returned is a reference to an array of
54 triplets:
55
56 [ $filename, $handle, $statusref ]
57
58 where $statusref is the tuple returned from the "status" method
59 (see Net::FTPServer::Handle).
60
61 The list returned does not include "." or "..".
62
63 The list is sorted into alphabetical order automatically.
64
65 $rv = $dirh->delete;
66
67 Delete the current directory. If the delete command was successful,
68 then return 0, else if there was an error return -1.
69
70 It is normally only possible to delete a directory if it is empty.
71
72 $rv = $dirh->mkdir ($name);
73
74 Create a subdirectory called $name within the current directory
75 $dirh.
76
77 $file = $dirh->open ($filename, "r"|"w"|"a");
78
79 Open or create a file called $filename in the current directory,
80 opening it for either read, write or append. This function returns
81 a "IO::File" handle object.
82
84 Richard Jones (rich@annexia.org).
85
87 Copyright (C) 2000 Biblio@Tech Ltd., Unit 2-3, 50 Carnwath Road,
88 London, SW6 3EG, UK
89
91 Net::FTPServer(3), perl(1)
92
94 Hey! The above document had some coding errors, which are explained
95 below:
96
97 Around line 37:
98 You can't have =items (as at line 58) unless the first thing after
99 the =over is an =item
100
101 Around line 247:
102 =back doesn't take any parameters, but you said =back 4
103
104
105
106perl v5.12.0 2003-09-28 Net::FTPServer::DirHandle(3)