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

DESCRIPTION

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

AUTHORS
100       Richard Jones (rich@annexia.org).
101

103       Copyright (C) 2000 Biblio@Tech Ltd., Unit 2-3, 50 Carnwath Road,
104       London, SW6 3EG, UK
105

SEE ALSO
107       Net::FTPServer(3), perl(1)
108

POD ERRORS
110       Hey! The above document had some coding errors, which are explained
111       below:
112
113       Around line 37:
114           You can't have =items (as at line 59) unless the first thing after
115           the =over is an =item
116
117       Around line 356:
118           =back doesn't take any parameters, but you said =back 4
119
120
121
122perl v5.12.0                      2004-11-09Net::FTPServer::Full::DirHandle(3)



        

    


            
        

        

            Impressum