net::sftp::foreign::compat(3pm) [debian man page]

Net::SFTP::Foreign::Compat(3pm) 			User Contributed Perl Documentation			   Net::SFTP::Foreign::Compat(3pm)

NAME

       Net::SFTP::Foreign::Compat - Adaptor for Net::SFTP compatibility

SYNOPSIS

	   use Net::SFTP::Foreign::Compat;
	   my $sftp = Net::SFTP::Foreign::Compat->new($host);
	   $sftp->get("foo", "bar");
	   $sftp->put("bar", "baz");

	   use Net::SFTP::Foreign::Compat ':supplant';
	   my $sftp = Net::SFTP->new($host);

DESCRIPTION

       This package is a wrapper around Net::SFTP::Foreign that provides an API (mostly) compatible with that of Net::SFTP.

       Methods on this package are identical to those in Net::SFTP except that Net::SFTP::Foreign::Attributes::Compat objects have to be used
       instead of Net::SFTP::Attributes.

       If the ":supplant" tag is used, this module installs also wrappers on the "Net::SFTP" and Net::SFTP::Attributes packages so no other parts
       of the program have to modified in order to move from Net::SFTP to Net::SFTP::Foreign.

   Setting defaults
       The hash %Net::SFTP::Foreign::DEFAULTS can be used to set default values for Net::SFTP::Foreign methods called under the hood and otherwise
       not accesible through the Net::SFTP API.

       The entries currently supported are:

       new => @opts
	   extra options passed to Net::SFTP::Foreign constructor.

       get => @opts
	   extra options passed to Net::SFTP::Foreign::get method.

       put => @opts
	   extra options passed to Net::SFTP::Foreign::put method.

       ls  => @opts
	   extra options passed to Net::SFTP::Foreign::ls method.

COPYRIGHT

       Copyright (c) 2006-2008, 2011 Salvador Fandin~o

       All rights reserved.  This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-05-04					   Net::SFTP::Foreign::Compat(3pm)

Net::SFTP::Foreign::Attributes(3pm)			User Contributed Perl Documentation		       Net::SFTP::Foreign::Attributes(3pm)

NAME

       Net::SFTP::Foreign::Attributes - File/directory attribute container

SYNOPSIS

	   use Net::SFTP::Foreign;

	   my $a1 = Net::SFTP::Foreign::Attributes->new();
	   $a1->set_size($size);
	   $a1->set_ugid($uid, $gid);

	   my $a2 = $sftp->stat($file)
	       or die "remote stat command failed: ".$sftp->status;

	   my $size = $a2->size;
	   my $mtime = $a2->mtime;

DESCRIPTION

       Net::SFTP::Foreign::Attributes encapsulates file/directory attributes for Net::SFTP::Foreign. It also provides serialization and
       deserialization methods to encode/decode attributes into Net::SFTP::Foreign::Buffer objects.

USAGE

       Net::SFTP::Foreign::Attributes->new()
	   Returns a new "Net::SFTP::Foreign::Attributes" object.

       Net::SFTP::Foreign::Attributes->new_from_buffer($buffer)
	   Creates a new attributes object and populates it with information read from $buffer.

       $attrs->as_buffer
	   Serializes the Attributes object $attrs into a buffer object.

       $attrs->flags
	   returns the value of the flags field.

       $attrs->size
	   returns the values of the size field or undef if it is not set.

       $attrs->uid
	   returns the value of the uid field or undef if it is not set.

       $attrs->gid
	   returns the value of the gid field or undef if it is not set.

       $attrs->perm
	   returns the value of the permissions field or undef if it is not set.

	   See also "stat" in perlfunc for instructions on how to process the returned value with the Fcntl module.

	   For instance, the following code checks if some attributes object corresponds to a directory:

	     use Fctnl qw(S_ISDIR);
	     ...
	     if (S_ISDIR($attr->perm)) {
	       # it is a directory!
	     }

       $attrs->atime
	   returns the value of the atime field or undef if it is not set.

       $attrs->mtime
	   returns the value of the mtime field or undef if it is not set.

       %extended = $attr->extended
	   returns the vendor-dependent extended attributes

       $attrs->set_size($size)
	   sets the value of the size field, or if $size is undef removes the field. The flags field is adjusted accordingly.

       $attrs->set_perm($perm)
	   sets the value of the permsissions field or removes it if the value is undefined. The flags field is also adjusted.

       $attr->set_ugid($uid, $gid)
	   sets the values of the uid and gid fields, or removes them if they are undefined values. The flags field is adjusted.

	   This pair of fields can not be set separatelly because they share the same bit on the flags field and so both have to be set or not.

       $attr->set_amtime($atime, $mtime)
	   sets the values of the atime and mtime fields or remove them if they are undefined values. The flags field is also adjusted.

       $attr->set_extended(%extended)
	   sets the vendor-dependent extended attributes

       $attr->append_extended(%more_extended)
	   adds more pairs to the list of vendor-dependent extended attributes

COPYRIGHT

       Copyright (c) 2006-2008 Salvador Fandin~o.

       All rights reserved.  This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-05-11				       Net::SFTP::Foreign::Attributes(3pm)