1Crypt::PWSafe3::Record(U3s)er Contributed Perl DocumentatCiroynpt::PWSafe3::Record(3)
2
3
4

NAME

6       Crypt::PWSafe3::Record - Represents a Passwordsafe v3 data record
7

SYNOPSIS

9        use Crypt::PWSafe3;
10        my $record = $vault->getrecord($uuid);
11        $record->title('t2');
12        $record->passwd('foobar');
13        print $record->notes;
14

DESCRIPTION

16       Crypt::PWSafe3::Record represents a Passwordsafe v3 data record.  Each
17       record consists of a number of fields of type Crypt::PWSafe3::Field.
18       The class provides get/set methods to access the values of those
19       fields.
20
21       It is also possible to access the raw unencoded values of the fields by
22       accessing them directly, refer to Crypt::PWSafe3::Field for more
23       details on this.
24
25       If the record object has been created by Crypt::PWSafe3 (and fetched
26       with Crypt::PWSafe3::getrecord), then it's still associated with the
27       Crypt::PWSafe3 parent object. Changes to the record will therefore
28       automatically populated back into the parent object (the vault). This
29       is not the case if you created the record object yourself.
30

METHODS

32   uuid([string])
33       Returns the UUID without argument. Sets the UUID if an argument is
34       given. Must be a hex representation of an Data::UUID object.
35
36       This will be generated automatically for new records, so you normally
37       don't have to cope with.
38
39   user([string])
40       Returns the username without argument. Sets the username if an argument
41       is given.
42
43   title([string])
44       Returns the title without argument. Sets the title if an argument is
45       given.
46
47   passwd([string])
48       Returns the password without argument. Sets the password if an argument
49       is given.
50
51   notes([string])
52       Returns the notes without argument. Sets the notes if an argument is
53       given.
54
55   group([string])
56       Returns the group without argument. Sets the group if an argument is
57       given.
58
59       Group hierarchy can be done by separating subgroups by dot, eg:
60
61        $record->group('accounts.banking');
62
63   ctime([time_t])
64       Returns the creation time without argument. Sets the creation time if
65       an argument is given. Argument must be an integer timestamp as returned
66       by time().
67
68       This will be generated automatically for new records, so you normally
69       don't have to cope with.
70
71   atime([time_t])
72       Returns the access time without argument. Sets the access time if an
73       argument is given. Argument must be an integer timestamp as returned by
74       time().
75
76       Crypt::PWSafe3 doesn't update the atime field currently. So if you
77       mind, do it yourself.
78
79   mtime([time_t])
80       Returns the modification time of the passwd field without argument.
81       Sets the modification time if an argument is given. Argument must be an
82       integer timestamp as returned by time().
83
84       This will be generated automatically for modified records if the passwd
85       field changed, so you normally don't have to cope with.
86
87   lastmod([string])
88       Returns the modification time without argument. Sets the modification
89       time if an argument is given. Argument must be an integer timestamp as
90       returned by time().
91
92       This will be generated automatically for modified records, so you
93       normally don't have to cope with.
94
95   url([string])
96       Returns the url without argument. Sets the url if an argument is given.
97       The url must be in the well known notation as:
98
99        proto://host/path
100
101   pwhist([string])
102       Returns the password history without argument. Sets the password
103       history if an argument is given.
104
105       Crypt::PWSafe3 doesn't update the pwhist field currently. So if you
106       mind, do it yourself. Refer to Crypt::PWSafe3::Databaseformat for more
107       details.
108
109   pwpol([string])
110       Returns the password policy without argument. Sets the password policy
111       if an argument is given.
112
113       This is the raw encoded policy string. If you want to access it, use
114       the policy() method, see below.
115
116   policy([Crypt::PWSafe3::PasswordPolicy object])
117       If called without arguments, returns a Crypt::PWSafe3::PasswordPolicy
118       object. See Crypt::PWSafe3::PasswordPolicy for details, how to access
119       it.
120
121       To modify the password policy, create new
122       Crypt::PWSafe3::PasswordPolicy object or modify the existing one and
123       pass it as argument to the policy method.
124
125   pwexp([string])
126       Returns the password expire time without argument. Sets the password
127       expire time if an argument is given.
128
129       Crypt::PWSafe3 doesn't update the pwexp field currently. So if you
130       mind, do it yourself. Refer to Crypt::PWSafe3::Databaseformat for more
131       details.
132

MANDATORY FIELDS

134       Crypt::PWSafe3::Record creates the following fields automatically on
135       creation, because those fields are mandatory:
136
137       uuid will be generated using Data::UUID.
138
139       user, password, title will be set to the empty string.
140
141       ctime, atime, mtime, lastmod will be set to current time of creation
142       time.
143

SEE ALSO

145       Crypt::PWSafe3
146

AUTHOR

148       T.v.Dein <tlinden@cpan.org>
149

COPYRIGHT

151       Copyright (c) 2011-2015 by T.v.Dein <tlinden@cpan.org>.  All rights
152       reserved.
153

LICENSE

155       This program is free software; you can redistribute it and/or modify it
156       under the same terms of the Artistic License 2.0, see:
157       <http://www.perlfoundation.org/artistic_license_2_0>
158
159
160
161perl v5.36.0                      2023-01-20         Crypt::PWSafe3::Record(3)