The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

WRATH / Filesys-POSIX-0.9.4_2011121201 / lib / Filesys / POSIX / Mem.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
—
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
—
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

              
# Filesys::POSIX           Copyright (c) 2011 cPanel, Inc.  All rights reserved.
# copyright@cpanel.net                                        http://cpanel.net/
# 
# Written by Erin Schönhals <erin@cpanel.net>.  Released under the terms of the
# Perl Artistic License.
package Filesys::POSIX::Mem;
use strict;
use warnings;
use Filesys::POSIX::Bits;
use Filesys::POSIX::Mem::Inode ();
=head1 NAME
Filesys::POSIX::Mem - Filesystem whose logical structure resides solely in
program memory
=head1 DESCRIPTION
C<Filesys::POSIX::Mem> provides a filesystem whose structure and, to a large
extent, contents of regular files, exist solely in program memory as Perl data
structures and string buffers.  Regular file data up to a certain size can exist
entirely in memory; files exceeding that size are dumped to temporary files
backed by L<File::Temp>.
=head1 MOUNT OPTIONS
=over
=item C<bucket_dir>
Allows one to specify the directory in which temporary bucket files which back
regular file data are to be created and kept.
=item C<bucket_max>
Specifies the maximum size, in bytes, of a regular file as it is kept in memory
before being flushed to a bucket file in disk.  The default value is, as per
L<Filesys::POSIX::Mem::Inode>, C<16384> bytes.
=back
=cut
sub new {
    my ($class) = @_;
    my $fs = bless {}, $class;
    $fs->{'root'} = Filesys::POSIX::Mem::Inode->new(
        'mode' => $S_IFDIR | 0755,
        'dev'  => $fs
    );
    return $fs;
}
sub init {
    my ( $self, %flags ) = @_;
    $self->{'flags'} = \%flags;
    return $self;
}
=head1 SEE ALSO
=over
=item L<Filesys::POSIX::Mem::Inode>
C<Filesys::POSIX::Mem> implementation of the inode construct.
=item L<Filesys::POSIX::Mem::Bucket>
C<Filesys::POSIX::Mem> implementation of file handles associated with regular
file data.
=item L<Filesys::POSIX::Mem::Directory>
C<Filesys::POSIX::Mem> implementation of directory iterable directory structures
as defined by the L<Filesys::POSIX::Directory> interface.
=back
=cut
1;