import errno

import generic

import os

import pkg.portable as portable

import pkg.actions

import pkg.client.api_errors as apx

import stat

class DirectoryAction(generic.Action):

"""Class representing a directory-type packaging object."""

__slots__ = []

name = "dir"

key_attr = "path"

unique_attrs = "path", "mode", "owner", "group"

globally_identical = True

refcountable = True

namespace_group = "path"

ordinality = generic._orderdict[name]

def compare(self, other):

return cmp(self.attrs["path"], other.attrs["path"])

def differences(self, other):

"""Returns a list of attributes that have different values

diffs = generic.Action.differences(self, other)

if "mode" in diffs and \

int(self.attrs.get("mode", "0"), 8) == int(other.attrs.get("mode", "0"), 8):

diffs.remove("mode")

return diffs

def directory_references(self):

return [os.path.normpath(self.attrs["path"])]

def install(self, pkgplan, orig):

"""Client-side method that installs a directory."""

mode = None

try:

mode = int(self.attrs.get("mode", None), 8)

except (TypeError, ValueError):

# Mode isn't valid, so let validate raise a more

# informative error.

self.validate(fmri=pkgplan.destination_fmri)

omode = oowner = ogroup = None

owner, group = self.get_fsobj_uid_gid(pkgplan,

pkgplan.destination_fmri)

if orig:

try:

omode = int(orig.attrs.get("mode", None), 8)

except (TypeError, ValueError):

# Mode isn't valid, so let validate raise a more

# informative error.

orig.validate(fmri=pkgplan.origin_fmri)

oowner, ogroup = orig.get_fsobj_uid_gid(pkgplan,

pkgplan.origin_fmri)

path = self.get_installed_path(pkgplan.image.get_root())

# Don't allow installation through symlinks.

self.fsobj_checkpath(pkgplan, path)

# XXX Hack! (See below comment.)

if not portable.is_admin():

mode |= stat.S_IWUSR

if not orig:

try:

self.makedirs(path, mode=mode,

fmri=pkgplan.destination_fmri)

except OSError, e:

if e.filename != path:

# makedirs failed for some component

# of the path.

raise

fs = os.lstat(path)

fs_mode = stat.S_IFMT(fs.st_mode)

if e.errno == errno.EROFS:

# Treat EROFS like EEXIST if both are

# applicable, since we'll end up with

# EROFS instead.

if stat.S_ISDIR(fs_mode):

return

raise

elif e.errno != errno.EEXIST:

raise

if stat.S_ISLNK(fs_mode):

# User has replaced directory with a

# link, or a package has been poorly

# implemented. It isn't safe to

# simply re-create the directory as

# that won't restore the files that

# are supposed to be contained within.

err_txt = _("Unable to create "

"directory %s; it has been "

"replaced with a link. To "

"continue, please remove the "

"link or restore the directory "

"to its original location and "

"try again.") % path

raise apx.ActionExecutionError(

self, details=err_txt, error=e,

fmri=pkgplan.destination_fmri)

elif stat.S_ISREG(fs_mode):

# User has replaced directory with a

# file, or a package has been poorly

# implemented. Salvage what's there,

# and drive on.

pkgplan.salvage(path)

os.mkdir(path, mode)

elif stat.S_ISDIR(fs_mode):

# The directory already exists, but

# ensure that the mode matches what's

# expected.

os.chmod(path, mode)

# The downside of chmodding the directory is that as a non-root

# user, if we set perms u-w, we won't be able to put anything in

# it, which is often not what we want at install time. We save

# the chmods for the postinstall phase, but it's always possible

# that a later package install will want to place something in

# this directory and then be unable to. So perhaps we need to

# (in all action types) chmod the parent directory to u+w on

# failure, and chmod it back aftwards. The trick is to

# recognize failure due to missing file_dac_write in contrast to

# other failures. Or can we require that everyone simply have

# file_dac_write who wants to use the tools. Probably not.

elif mode != omode:

os.chmod(path, mode)

# if we're salvaging contents, move 'em now.

# directories with "salvage-from" attribute

# set will scavenge any available contents

# that matches specified directory and

# move it underneath itself on install or update.

# This is here to support directory rename

# when old directory has unpackaged contents, or

# consolidation of content from older directories.

for salvage_from in self.attrlist("salvage-from"):

pkgplan.salvage_from(salvage_from, path)

if not orig or oowner != owner or ogroup != group:

try:

portable.chown(path, owner, group)

except OSError, e:

if e.errno != errno.EPERM and \

e.errno != errno.ENOSYS:

raise

def verify(self, img, **args):

"""Returns a tuple of lists of the form (errors, warnings,

lstat, errors, warnings, info, abort = \

self.verify_fsobj_common(img, stat.S_IFDIR)

return errors, warnings, info

def remove(self, pkgplan):

path = self.get_installed_path(pkgplan.image.get_root())

try:

os.rmdir(path)

except OSError, e:

if e.errno == errno.ENOENT:

pass

elif e.errno in (errno.EEXIST, errno.ENOTEMPTY):

# Cannot remove directory since it's

# not empty.

pkgplan.salvage(path)

elif e.errno == errno.ENOTDIR:

# Either the user or another package has changed

# this directory into a link or file. Salvage

# what's there and drive on.

pkgplan.salvage(path)

elif e.errno == errno.EBUSY and os.path.ismount(path):

# User has replaced directory with mountpoint,

# or a package has been poorly implemented.

if not self.attrs.get("implicit"):

err_txt = _("Unable to remove %s; it is "

"in use as a mountpoint. To "

"continue, please unmount the "

"filesystem at the target "

"location and try again.") % path

raise apx.ActionExecutionError(self,

details=err_txt, error=e,

fmri=pkgplan.origin_fmri)

elif e.errno == errno.EBUSY:

# os.path.ismount() is broken for lofs

# filesystems, so give a more generic

# error.

if not self.attrs.get("implicit"):

err_txt = _("Unable to remove %s; it "

"is in use by the system, another "

"process, or as a mountpoint.") \

% path

raise apx.ActionExecutionError(self,

details=err_txt, error=e,

fmri=pkgplan.origin_fmri)

elif e.errno != errno.EACCES: # this happens on Windows

raise

def generate_indices(self):

"""Generates the indices needed by the search dictionary. See

return [

(self.name, "basename",

os.path.basename(self.attrs["path"].rstrip(os.path.sep)),

None),

(self.name, "path", os.path.sep + self.attrs["path"],

None)

]

def validate(self, fmri=None):

"""Performs additional validation of action attributes that

errors = generic.Action._validate(self, fmri=fmri,

raise_errors=False, required_attrs=("owner", "group"))

errors.extend(self._validate_fsobj_common())

if errors:

raise pkg.actions.InvalidActionAttributesError(self,

errors, fmri=fmri)