libcdio-osx/include/cdio++/iso9660.hpp

/* -*- C++ -*-
    $Id: iso9660.hpp,v 1.2 2006/03/05 08:31:03 rocky Exp $

    Copyright (C) 2006 Rocky Bernstein <rocky@panix.com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

/** \file iso966o.hpp
 *
 *  \brief C++ class for libcdio: the CD Input and Control
 *  library. Applications use this for anything regarding libcdio.
 */

#ifndef __ISO9660_HPP__
#define __ISO9660_HPP__

#include <cdio/iso9660.h>
#include <string.h>

/** ISO 9660 class.
*/
class ISO9660
{

public:

  class PVD
  {
    PVD(iso9660_pvd_t *p_new_pvd)
    { 
      p_pvd = p_new_pvd;
    };

  private:
    iso9660_pvd_t *p_pvd;
  };
    
  class Stat
  {
  public: 
    Stat(iso9660_stat_t *p_new_stat)
    { 
      p_stat = p_new_stat;
    };

  private:
    iso9660_stat_t * p_stat;
  };

  class IFS
  {
  public:
    IFS()
    { 
      p_iso9660=NULL; 
    };

    ~IFS() 
    { 
      iso9660_close(p_iso9660); 
      p_iso9660 = (iso9660_t *) NULL;
    };
    
    /*! Close previously opened ISO 9660 image and free resources
      associated with the image. Call this when done using using an ISO
      9660 image.
      
      @return true is unconditionally returned. If there was an error
      false would be returned.
    */
    bool 
    close()
    {
      iso9660_close(p_iso9660);
      p_iso9660 = (iso9660_t *) NULL;
      return true;
    };
    
    /*!
      Given a directory pointer, find the filesystem entry that contains
      lsn and return information about it.
      
      Returns stat_t of entry if we found lsn, or NULL otherwise.
    */
    Stat *find_lsn(lsn_t i_lsn) 
    {
      iso9660_stat_t *p_stat = iso9660_find_ifs_lsn(p_iso9660, i_lsn);
      if (!p_stat) return (Stat *) NULL;
      return new Stat(p_stat);
    };

    /*!  
      Get the application ID.  psz_app_id is set to NULL if there
      is some problem in getting this and false is returned.
    */
    bool get_application_id(/*out*/ char * &psz_app_id) 
    {
      return iso9660_ifs_get_application_id(p_iso9660, &psz_app_id);
    };
    
    /*!  
      Return the Joliet level recognized. 
    */
    uint8_t get_joliet_level()
    {
      return iso9660_ifs_get_joliet_level(p_iso9660);
    };
    
    /*!  
      Get the preparer ID.  psz_preparer_id is set to NULL if there
      is some problem in getting this and false is returned.
    */
    bool get_preparer_id(/*out*/ char * &psz_preparer_id) 
    {
      return iso9660_ifs_get_preparer_id(p_iso9660, &psz_preparer_id);
    };
    
    /*!  
      Get the publisher ID.  psz_publisher_id is set to NULL if there
      is some problem in getting this and false is returned.
    */
    bool get_publisher_id(/*out*/ char * &psz_publisher_id) 
    {
      return iso9660_ifs_get_publisher_id(p_iso9660, &psz_publisher_id);
    };
    
    /*!  
      Get the system ID.  psz_system_id is set to NULL if there
      is some problem in getting this and false is returned.
    */
    bool get_system_id(/*out*/ char * &psz_system_id) 
    {
      return iso9660_ifs_get_system_id(p_iso9660, &psz_system_id);
    };
    
    /*! Return the volume ID in the PVD. psz_volume_id is set to
      NULL if there is some problem in getting this and false is
      returned.
    */
    bool get_volume_id(/*out*/ char * &psz_volume_id) 
    {
      return iso9660_ifs_get_volume_id(p_iso9660, &psz_volume_id);
    };
    
    /*! Return the volumeset ID in the PVD. psz_volumeset_id is set to
      NULL if there is some problem in getting this and false is
      returned.
    */
    bool get_volumeset_id(/*out*/ char * &psz_volumeset_id) 
    {
      return iso9660_ifs_get_volumeset_id(p_iso9660, &psz_volumeset_id);
    };
    
    /*!
      Return true if ISO 9660 image has extended attrributes (XA).
    */
    bool is_xa () 
    {
      return iso9660_ifs_is_xa (p_iso9660);
    };

    /*! Open an ISO 9660 image for reading. Maybe in the future we will
      have a mode. NULL is returned on error. An open routine should be
      called before using any read routine. If device object was
      previously opened it is closed first.
      
      @param psz_path location of ISO 9660 image
      @param iso_extension_mask the kinds of ISO 9660 extensions will be
      considered on access.
      
      @return true if open succeeded or false if error.
      
      @see open_fuzzy
    */
    bool 
    open(const char *psz_path, 
	 iso_extension_mask_t iso_extension_mask=ISO_EXTENSION_NONE)
    {
      if (p_iso9660) iso9660_close(p_iso9660);
      p_iso9660 = iso9660_open_ext(psz_path, iso_extension_mask);
      return NULL != (iso9660_t *) p_iso9660 ;
    };
    
    /*! Open an ISO 9660 image for "fuzzy" reading. This means that we
      will try to guess various internal offset based on internal
      checks. This may be useful when trying to read an ISO 9660 image
      contained in a file format that libiso9660 doesn't know natively
      (or knows imperfectly.)
      
      Maybe in the future we will have a mode. NULL is returned on
      error.
      
      @see open
    */
    bool 
    open_fuzzy (const char *psz_path,
		iso_extension_mask_t iso_extension_mask=ISO_EXTENSION_NONE,
		uint16_t i_fuzz=20)
    {
      p_iso9660 = iso9660_open_fuzzy_ext(psz_path, iso_extension_mask, i_fuzz);
      //return p_iso9660 != (iso9660_t *) NULL;
      return true;
    };

    /*!
      Read the Super block of an ISO 9660 image but determine framesize
      and datastart and a possible additional offset. Generally here we are
      not reading an ISO 9660 image but a CD-Image which contains an ISO 9660
      filesystem.

      @see read_superblock
    */
    bool 
    read_superblock (iso_extension_mask_t iso_extension_mask=
		     ISO_EXTENSION_NONE,
		     uint16_t i_fuzz=20)
    {
      return iso9660_ifs_read_superblock (p_iso9660, iso_extension_mask);

    };
    
    /*!
      Read the Super block of an ISO 9660 image but determine framesize
      and datastart and a possible additional offset. Generally here we are
      not reading an ISO 9660 image but a CD-Image which contains an ISO 9660
      filesystem.

      @see read_superblock
    */
    bool 
    read_superblock_fuzzy (iso_extension_mask_t iso_extension_mask=
			   ISO_EXTENSION_NONE,
			   uint16_t i_fuzz=20)
    {
      return iso9660_ifs_fuzzy_read_superblock (p_iso9660, iso_extension_mask, 
						i_fuzz);

    };
    
    /*!
      Seek to a position and then read n bytes. Size read is returned.
    */
    long int seek_read (void *ptr, lsn_t start, long int i_size=1) 
    {
      return iso9660_iso_seek_read (p_iso9660, ptr, start, i_size);
    };

    /*!  
      Return file status for pathname. NULL is returned on error.
    */
    Stat *stat (const char psz_path[], bool b_translate=false) 
    {
      iso9660_stat_t *p_stat;
      
      if (b_translate) 
	p_stat = iso9660_ifs_stat_translate (p_iso9660, psz_path);
      else 
	p_stat = iso9660_ifs_stat (p_iso9660, psz_path);
      if (!p_stat) return (Stat *) NULL;
      return new Stat(p_stat);
    }
    
  private:
    iso9660_t *p_iso9660;
  };

};


#endif /* __ISO9660_HPP__ */