setting file permissions through sftp

[gman]

Hello, I am using Net::SFTP to upload files and change the file permissions. How do I read, in unix style, the file perm format?

*** file permisions: $VAR1 = bless( {
                 'uid' => 500,
                 'flags' => 15,
                 'mtime' => 1203350526,
                 'atime' => 1203350526,
                 'perm' => 33092,
                 'gid' => 500,
                 'size' => '0'
               }, 'Net::SFTP::Attributes' );

 my $attrs = Net::SFTP::Attributes->new(Stat => [ stat "test.file" ]);
        print "*** file permisions: " . Dumper($attrs) ."\n";
        $attrs->perm( [ '0777' ] ); # what format is this?
        $sftp->do_setstat('test.file', $attrs);
        $attrs = Net::SFTP::Attributes->new(Stat => [ stat "test.file"
+ ]);
        print "*** file permisions: " . ($attrs->{'perm'}) ."\n";

Thanks, Cory

[pc88mxer]

Unix permissions are most easily read when expressed in octal. The basic permissions consist of one octal digit (3 bits) for owner, group and other. The bits in each octal digit stand for: read, write and execute. So a unix file permission of 0321 (leading 0 stands for octal) would read:
• owner has read, write and execute
• group has write and execute
• other only has execute permission
Here's a page with a fuller presentation and a multitude of tables to help you decode them. It also explains the set user id, set group id and stick-bit permissions.

In your example, the 0777 means that everyone (user, group and other) has all (read, write and execute) permissions. Note, however, that the file permissions will be modified by the current umask when the file is created.

[gman]

I am still not understanding the relationship between what Net::SFTP::Attributes ( 'perm' => 33092, ) and unix style file permissions? Am I missing something obvious?

[almut]

You have to convert the value to octal representation, e.g.

my $perm = 33092;

printf "%o\n", $perm & 07777;   # prints 504

Also, to set the permissions, you probably want $attrs->perm( 0777 ), not $attrs->perm( [ '0777' ] ). The square brackets in the docs mean optional, i.e. you'd specify nothing to retrieve the value (combined 'setter' and 'getter' method...).

Update: forgot to mention the '& 07777' above masks off the four octal groups of interest here, i.e. three times rwx (for user/group/other), plus the SUID/SGID/sticky octal group (the latter is the first (leftmost) one).