zypp::media::MediaISO Class Reference

Implementation class for ISO MediaHandler. More...

#include <MediaISO.h>

Inheritance diagram for zypp::media::MediaISO:
[legend]

List of all members.

Public Member Functions

 MediaISO (const Url &url_r, const Pathname &attach_point_hint_r)
virtual ~MediaISO ()
virtual bool isAttached () const
 True if media is attached.

Protected Member Functions

virtual void attachTo (bool next=false)
 Call concrete handler to attach the media.
virtual void releaseFrom (const std::string &ejectDev="")
 Call concrete handler to release the media.
virtual void getFile (const Pathname &filename) const
 Call concrete handler to provide file below attach point.
virtual void getDir (const Pathname &dirname, bool recurse_r) const
 Call concrete handler to provide directory content (not recursive!) below attach point.
virtual void getDirInfo (std::list< std::string > &retlist, const Pathname &dirname, bool dots=true) const
 Call concrete handler to provide a content list of directory on media via retlist.
virtual void getDirInfo (filesystem::DirContent &retlist, const Pathname &dirname, bool dots=true) const
 Basically the same as getDirInfo above.
virtual bool getDoesFileExist (const Pathname &filename) const
 check if a file exists

Private Member Functions

std::string findUnusedLoopDevice ()

Private Attributes

Pathname _isofile
MediaAccessId _isosource
std::string _filesystem

Detailed Description

Implementation class for ISO MediaHandler.

See also:
MediaHandler

Definition at line 35 of file MediaISO.h.

Constructor & Destructor Documentation

zypp::media::MediaISO::MediaISO ( const Url &  url_r,
const Pathname &  attach_point_hint_r 
)

Definition at line 48 of file MediaISO.cc.

References _filesystem, _isofile, zypp::media::MediaHandler::_parentId, zypp::media::MediaHandler::_url, zypp::Url::asString(), zypp::url::encode(), ERR, zypp::Url::getQueryParam(), zypp::Url::getScheme(), zypp::Url::isValid(), MIL, zypp::media::MediaManager::open(), zypp::Exception::remember(), zypp::Url::setPathName(), URL_SAFE_CHARS, ZYPP_CAUGHT, and ZYPP_THROW.

zypp::media::MediaISO::~MediaISO (  )  [virtual]

Definition at line 125 of file MediaISO.cc.

References zypp::media::MediaHandler::_parentId, zypp::media::MediaManager::close(), DBG, zypp::media::MediaManager::isOpen(), and zypp::media::MediaHandler::release().

Member Function Documentation

string zypp::media::MediaISO::findUnusedLoopDevice (  )  [private]

Definition at line 152 of file MediaISO.cc.

References zypp::media::MediaHandler::_url, zypp::ExternalProgram::close(), DBG, ERR, LOSETUP_TOOL_PATH, zypp::externalprogram::ExternalDataSource::receiveLine(), zypp::ExternalProgram::Stderr_To_Stdout, and ZYPP_THROW.

Referenced by attachTo().

void zypp::media::MediaISO::attachTo ( bool  next = false  )  [protected, virtual]

Call concrete handler to attach the media.

Asserted that not already attached, and attachPoint is a directory.

Parameters:
next try next available device in turn until end of device list is reached (for media which are accessible through multiple devices like cdroms).
Exceptions:
MediaException 

Todo:
make this thread-safe - another thread might pick up the same device

Implements zypp::media::MediaHandler.

Definition at line 178 of file MediaISO.cc.

References _filesystem, _isofile, zypp::media::MediaHandler::_parentId, zypp::media::MediaHandler::_url, zypp::str::asString(), zypp::Url::asString(), zypp::media::MediaManager::attach(), zypp::media::AttachedMedia::attachPoint, zypp::media::MediaHandler::attachPoint(), zypp::media::MediaHandler::createAttachPoint(), DBG, ERR, zypp::filesystem::expandlink(), zypp::media::MediaHandler::findAttachedMedia(), findUnusedLoopDevice(), isAttached(), zypp::media::MediaHandler::isUseableAttachPoint(), zypp::media::MediaManager::localPath(), zypp::media::AttachedMedia::mediaSource, zypp::media::Mount::mount(), zypp::media::MediaManager::provideFile(), zypp::media::MediaManager::release(), zypp::media::MediaHandler::removeAttachPoint(), zypp::media::MediaHandler::setAttachPoint(), zypp::media::MediaHandler::setMediaSource(), zypp::media::Mount::umount(), zypp::media::MediaHandler::url(), ZYPP_CAUGHT, and ZYPP_THROW.

void zypp::media::MediaISO::releaseFrom ( const std::string &  ejectDev = ""  )  [protected, virtual]

Call concrete handler to release the media.

If eject is true, and the media is used in one handler instance only, physically eject the media (i.e. CD-ROM).

Asserted that media is attached.

Parameters:
ejectDev Device to eject. None if empty.
Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 294 of file MediaISO.cc.

References zypp::media::MediaHandler::_parentId, zypp::str::asString(), zypp::media::MediaHandler::attachPoint(), zypp::media::MediaManager::release(), zypp::media::Mount::umount(), WAR, and ZYPP_CAUGHT.

void zypp::media::MediaISO::getFile ( const Pathname &  filename  )  const [protected, virtual]

Call concrete handler to provide file below attach point.

Default implementation provided, that returns whether a file is located at 'localRoot + filename'.

Asserted that media is attached.

Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 320 of file MediaISO.cc.

void zypp::media::MediaISO::getDir ( const Pathname &  dirname,
bool  recurse_r 
) const [protected, virtual]

Call concrete handler to provide directory content (not recursive!) below attach point.

Return E_not_supported_by_media if media does not support retrieval of directory content.

Default implementation provided, that returns whether a directory is located at 'localRoot + dirname'.

Asserted that media is attached.

Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 326 of file MediaISO.cc.

void zypp::media::MediaISO::getDirInfo ( std::list< std::string > &  retlist,
const Pathname &  dirname,
bool  dots = true 
) const [protected, virtual]

Call concrete handler to provide a content list of directory on media via retlist.

If dots is false entries starting with '.' are not reported.

Return E_not_supported_by_media if media does not support retrieval of directory content.

Default implementation provided, that returns the content of a directory at 'localRoot + dirnname' retrieved via 'readdir'.

Asserted that media is attached and retlist is empty.

Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 333 of file MediaISO.cc.

Referenced by getDirInfo().

void zypp::media::MediaISO::getDirInfo ( filesystem::DirContent &  retlist,
const Pathname &  dirname,
bool  dots = true 
) const [protected, virtual]

Basically the same as getDirInfo above.

The content list is returned as filesystem::DirContent, which includes name and filetype of each directory entry. Retrieving the filetype usg. requires an additional stat call for each entry, thus it's more expensive than a simple readdir.

Asserted that media is attached and retlist is empty.

Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 341 of file MediaISO.cc.

References getDirInfo().

bool zypp::media::MediaISO::getDoesFileExist ( const Pathname &  filename  )  const [protected, virtual]

check if a file exists

Asserted that url is a file and not a dir.

Exceptions:
MediaException 

Implements zypp::media::MediaHandler.

Definition at line 348 of file MediaISO.cc.

bool zypp::media::MediaISO::isAttached (  )  const [virtual]

True if media is attached.

Reimplemented from zypp::media::MediaHandler.

Definition at line 146 of file MediaISO.cc.

References zypp::media::MediaHandler::checkAttached().

Referenced by attachTo().

Member Data Documentation

Pathname zypp::media::MediaISO::_isofile [private]

Definition at line 38 of file MediaISO.h.

Referenced by attachTo(), and MediaISO().

MediaAccessId zypp::media::MediaISO::_isosource [private]

Definition at line 39 of file MediaISO.h.

std::string zypp::media::MediaISO::_filesystem [private]

Definition at line 40 of file MediaISO.h.

Referenced by attachTo(), and MediaISO().

The documentation for this class was generated from the following files:
doxygen