GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CRYPT::PWSAFE3::RECORD (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS



 use Crypt::PWSafe3;
 my $record = $vault->getrecord($uuid);
 $record->title(t2);
 $record->passwd(foobar);
 print $record->notes;



DESCRIPTION

<B>Crypt::PWSafe3::RecordB> represents a Passwordsafe v3 data record. Each record consists of a number of fields of type <B>Crypt::PWSafe3::FieldB>. The class provides get/set methods to access the values of those fields.

It is also possible to access the raw unencoded values of the fields by accessing them directly, refer to Crypt::PWSafe3::Field for more details on this.

METHODS

uuid([string])

Returns the UUID without argument. Sets the UUID if an argument is given. Must be a hex representation of an Data::UUID object.

This will be generated automatically for new records, so you normally don’t have to cope with.

user([string])

Returns the username without argument. Sets the username if an argument is given.

title([string])

Returns the title without argument. Sets the title if an argument is given.

passwd([string])

Returns the password without argument. Sets the password if an argument is given.

notes([string])

Returns the notes without argument. Sets the notes if an argument is given.

group([string])

Returns the group without argument. Sets the group if an argument is given.

Group hierarchy can be done by separating subgroups by dot, eg:



 $record->group(accounts.banking);



ctime([time_t])

Returns the creation time without argument. Sets the creation time if an argument is given. Argument must be an integer timestamp as returned by time().

This will be generated automatically for new records, so you normally don’t have to cope with.

atime([time_t])

Returns the access time without argument. Sets the access time if an argument is given. Argument must be an integer timestamp as returned by time().

<B>Crypt::PWSafe3B> doesn’t update the atime field currently. So if you mind, do it yourself.

mtime([time_t])

Returns the modification time of the passwd field without argument. Sets the modification time if an argument is given. Argument must be an integer timestamp as returned by time().

This will be generated automatically for modified records if the passwd field changed, so you normally don’t have to cope with.

lastmod([string])

Returns the modification time without argument. Sets the modification time if an argument is given. Argument must be an integer timestamp as returned by time().

This will be generated automatically for modified records, so you normally don’t have to cope with.

url([string])

Returns the url without argument. Sets the url if an argument is given. The url must be in the well known notation as:



 proto://host/path



pwhist([string])

Returns the password history without argument. Sets the password history if an argument is given.

<B>Crypt::PWSafe3B> doesn’t update the pwhist field currently. So if you mind, do it yourself. Refer to Crypt::PWSafe3::Databaseformat for more details.

pwpol([string])

Returns the password policy without argument. Sets the password policy if an argument is given.

This is the raw encoded policy string. If you want to access it, use the <B>B>policy()<B>B> method, see below.

policy([Crypt::PWSafe3::PasswordPolicy object])

If called without arguments, returns a Crypt::PWSafe3::PasswordPolicy object. See Crypt::PWSafe3::PasswordPolicy for details, how to access it.

To modify the password policy, create new Crypt::PWSafe3::PasswordPolicy object or modify the existing one and pass it as argument to the <B>policyB> method.

pwexp([string])

Returns the password expire time without argument. Sets the password expire time if an argument is given.

<B>Crypt::PWSafe3B> doesn’t update the pwexp field currently. So if you mind, do it yourself. Refer to Crypt::PWSafe3::Databaseformat for more details.

MANDATORY FIELDS

<B>Crypt::PWSafe3::RecordB> creates the following fields automatically on creation, because those fields are mandatory:

<B>uuidB> will be generated using Data::UUID.

<B>user, password, titleB> will be set to the empty string.

<B>ctime, atime, mtime, lastmodB> will be set to current time of creation time.

SEE ALSO

Crypt::PWSafe3

AUTHOR

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

COPYRIGHT

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

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms of the Artistic License 2.0, see: <http://www.perlfoundation.org/artistic_license_2_0>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CRYPT::PWSAFE3::RECORD (3) 2015-02-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.