Class: Zip::ZipEntry

Inherits:
Object show all
Defined in:
lib/zip/zip.rb

Direct Known Subclasses

ZipStreamableDirectory, ZipStreamableStream

Constant Summary collapse

STORED =
0
DEFLATED =
8
FSTYPE_FAT =
0
FSTYPE_AMIGA =
1
FSTYPE_VMS =
2
FSTYPE_UNIX =
3
FSTYPE_VM_CMS =
4
FSTYPE_ATARI =
5
FSTYPE_HPFS =
6
FSTYPE_MAC =
7
FSTYPE_Z_SYSTEM =
8
FSTYPE_CPM =
9
FSTYPE_TOPS20 =
10
FSTYPE_NTFS =
11
FSTYPE_QDOS =
12
FSTYPE_ACORN =
13
FSTYPE_VFAT =
14
FSTYPE_MVS =
15
FSTYPE_BEOS =
16
FSTYPE_TANDEM =
17
FSTYPE_THEOS =
18
FSTYPE_MAC_OSX =
19
FSTYPE_ATHEOS =
30
FSTYPES =
{
  FSTYPE_FAT => 'FAT'.freeze,
  FSTYPE_AMIGA => 'Amiga'.freeze,
  FSTYPE_VMS => 'VMS (Vax or Alpha AXP)'.freeze,
  FSTYPE_UNIX => 'Unix'.freeze,
  FSTYPE_VM_CMS => 'VM/CMS'.freeze,
  FSTYPE_ATARI => 'Atari ST'.freeze,
  FSTYPE_HPFS => 'OS/2 or NT HPFS'.freeze,
  FSTYPE_MAC => 'Macintosh'.freeze,
  FSTYPE_Z_SYSTEM => 'Z-System'.freeze,
  FSTYPE_CPM => 'CP/M'.freeze,
  FSTYPE_TOPS20 => 'TOPS-20'.freeze,
  FSTYPE_NTFS => 'NTFS'.freeze,
  FSTYPE_QDOS => 'SMS/QDOS'.freeze,
  FSTYPE_ACORN => 'Acorn RISC OS'.freeze,
  FSTYPE_VFAT => 'Win32 VFAT'.freeze,
  FSTYPE_MVS => 'MVS'.freeze,
  FSTYPE_BEOS => 'BeOS'.freeze,
  FSTYPE_TANDEM => 'Tandem NSK'.freeze,
  FSTYPE_THEOS => 'Theos'.freeze,
  FSTYPE_MAC_OSX => 'Mac OS/X (Darwin)'.freeze,
  FSTYPE_ATHEOS => 'AtheOS'.freeze,
}.freeze
LOCAL_ENTRY_SIGNATURE =
0x04034b50
LOCAL_ENTRY_STATIC_HEADER_LENGTH =
30
LOCAL_ENTRY_TRAILING_DESCRIPTOR_LENGTH =
4+4+4
CENTRAL_DIRECTORY_ENTRY_SIGNATURE =
0x02014b50
CDIR_ENTRY_STATIC_HEADER_LENGTH =
46

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(zipfile = "", name = "", comment = "", extra = "", compressed_size = 0, crc = 0, compression_method = ZipEntry::DEFLATED, size = 0, time = Time.now) ⇒ ZipEntry

Returns a new instance of ZipEntry.



351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
# File 'lib/zip/zip.rb', line 351

def initialize(zipfile = "", name = "", comment = "", extra = "", 
               compressed_size = 0, crc = 0, 
 compression_method = ZipEntry::DEFLATED, size = 0,
 time  = Time.now)
  super()
  if name.starts_with("/")
	raise ZipEntryNameError, "Illegal ZipEntry name '#{name}', name must not start with /" 
  end
  @localHeaderOffset = 0
  @internalFileAttributes = 1
  @externalFileAttributes = 0
  @version = 52 # this library's version
  @ftype = nil # unspecified or unknown
  @filepath = nil
  if Zip::RUNNING_ON_WINDOWS
    @fstype = FSTYPE_FAT
  else
    @fstype = FSTYPE_UNIX
  end
  @zipfile, @comment, @compressed_size, @crc, @extra, @compression_method, 
	@name, @size = zipfile, comment, compressed_size, crc, 
	extra, compression_method, name, size
  @time = time

  @follow_symlinks = false

  @restore_times = true
  @restore_permissions = false
  @restore_ownership = false

# BUG: need an extra field to support uid/gid's
  @unix_uid = nil
  @unix_gid = nil
  @unix_perms = nil
#      @posix_acl = nil
#      @ntfs_acl = nil

  if name_is_directory?
    @ftype = :directory
  else
    @ftype = :file
  end

  unless ZipExtraField === @extra
    @extra = ZipExtraField.new(@extra.to_s)
  end
end

Instance Attribute Details

#commentObject

Returns the value of attribute comment.



342
343
344
# File 'lib/zip/zip.rb', line 342

def comment
  @comment
end

#compressed_sizeObject

Returns the value of attribute compressed_size.



342
343
344
# File 'lib/zip/zip.rb', line 342

def compressed_size
  @compressed_size
end

#compression_methodObject

Returns the value of attribute compression_method.



342
343
344
# File 'lib/zip/zip.rb', line 342

def compression_method
  @compression_method
end

#crcObject

Returns the value of attribute crc.



342
343
344
# File 'lib/zip/zip.rb', line 342

def crc
  @crc
end

#externalFileAttributesObject

Returns the value of attribute externalFileAttributes.



342
343
344
# File 'lib/zip/zip.rb', line 342

def externalFileAttributes
  @externalFileAttributes
end

#extraObject

Returns the value of attribute extra.



342
343
344
# File 'lib/zip/zip.rb', line 342

def extra
  @extra
end

#filepathObject (readonly)

:nodoc:



349
350
351
# File 'lib/zip/zip.rb', line 349

def filepath
  @filepath
end

Returns the value of attribute follow_symlinks.



345
346
347
# File 'lib/zip/zip.rb', line 345

def follow_symlinks
  @follow_symlinks
end

#fstypeObject

Returns the value of attribute fstype.



342
343
344
# File 'lib/zip/zip.rb', line 342

def fstype
  @fstype
end

#ftypeObject (readonly)

:nodoc:



349
350
351
# File 'lib/zip/zip.rb', line 349

def ftype
  @ftype
end

#gp_flagsObject

Returns the value of attribute gp_flags.



342
343
344
# File 'lib/zip/zip.rb', line 342

def gp_flags
  @gp_flags
end

#header_signatureObject

Returns the value of attribute header_signature.



342
343
344
# File 'lib/zip/zip.rb', line 342

def header_signature
  @header_signature
end

#localHeaderOffsetObject

Returns the value of attribute localHeaderOffset.



342
343
344
# File 'lib/zip/zip.rb', line 342

def localHeaderOffset
  @localHeaderOffset
end

#nameObject

Returns the value of attribute name.



342
343
344
# File 'lib/zip/zip.rb', line 342

def name
  @name
end

#restore_ownershipObject

Returns the value of attribute restore_ownership.



346
347
348
# File 'lib/zip/zip.rb', line 346

def restore_ownership
  @restore_ownership
end

#restore_permissionsObject

Returns the value of attribute restore_permissions.



346
347
348
# File 'lib/zip/zip.rb', line 346

def restore_permissions
  @restore_permissions
end

#restore_timesObject

Returns the value of attribute restore_times.



346
347
348
# File 'lib/zip/zip.rb', line 346

def restore_times
  @restore_times
end

#sizeObject

Returns the value of attribute size.



342
343
344
# File 'lib/zip/zip.rb', line 342

def size
  @size
end

#unix_gidObject

Returns the value of attribute unix_gid.



347
348
349
# File 'lib/zip/zip.rb', line 347

def unix_gid
  @unix_gid
end

#unix_permsObject

Returns the value of attribute unix_perms.



347
348
349
# File 'lib/zip/zip.rb', line 347

def unix_perms
  @unix_perms
end

#unix_uidObject

Returns the value of attribute unix_uid.



347
348
349
# File 'lib/zip/zip.rb', line 347

def unix_uid
  @unix_uid
end

#zipfileObject

Returns the value of attribute zipfile.



342
343
344
# File 'lib/zip/zip.rb', line 342

def zipfile
  @zipfile
end

Class Method Details

.read_c_dir_entry(io) ⇒ Object

:nodoc:all



630
631
632
633
634
635
636
# File 'lib/zip/zip.rb', line 630

def ZipEntry.read_c_dir_entry(io)  #:nodoc:all
  entry = new(io.path)
  entry.read_c_dir_entry(io)
  return entry
rescue ZipError
  return nil
end

.read_local_entry(io) ⇒ Object



533
534
535
536
537
538
539
# File 'lib/zip/zip.rb', line 533

def ZipEntry.read_local_entry(io)
  entry = new(io.path)
  entry.read_local_entry(io)
  return entry
rescue ZipError
  return nil
end

Instance Method Details

#<=>(other) ⇒ Object



732
733
734
# File 'lib/zip/zip.rb', line 732

def <=> (other)
  return to_s <=> other.to_s
end

#==(other) ⇒ Object



719
720
721
722
723
724
725
726
727
728
729
730
# File 'lib/zip/zip.rb', line 719

def == (other)
  return false unless other.class == self.class
  # Compares contents of local entry and exposed fields
  (@compression_method == other.compression_method &&
   @crc               == other.crc		     &&
   @compressed_size   == other.compressed_size   &&
   @size              == other.size	             &&
   @name              == other.name	             &&
   @extra             == other.extra             &&
   @filepath          == other.filepath          &&
   self.time.dos_equals(other.time))
end

#cdir_header_sizeObject

:nodoc:all



449
450
451
452
# File 'lib/zip/zip.rb', line 449

def cdir_header_size  #:nodoc:all
  CDIR_ENTRY_STATIC_HEADER_LENGTH  + (@name ?  @name.size : 0) + 
	(@extra ? @extra.c_dir_size : 0) + (@comment ? @comment.size : 0)
end

#directory?Boolean Also known as: is_directory

Returns true if the entry is a directory.

Returns:

  • (Boolean)

Raises:



419
420
421
422
# File 'lib/zip/zip.rb', line 419

def directory?
  raise ZipInternalError, "current filetype is unknown: #{self.inspect}" unless @ftype
  @ftype == :directory
end

#extract(destPath = @name, &onExistsProc) ⇒ Object

Extracts entry to file destPath (defaults to @name).



459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
# File 'lib/zip/zip.rb', line 459

def extract(destPath = @name, &onExistsProc)
  onExistsProc ||= proc { false }

  if directory?
	create_directory(destPath, &onExistsProc)
  elsif file?
	write_file(destPath, &onExistsProc) 
  elsif symlink?
    create_symlink(destPath, &onExistsProc)
  else
    raise RuntimeError, "unknown file type #{self.inspect}"
  end

  self
end

#file?Boolean

Returns true if the entry is a file.

Returns:

  • (Boolean)

Raises:



426
427
428
429
# File 'lib/zip/zip.rb', line 426

def file?
  raise ZipInternalError, "current filetype is unknown: #{self.inspect}" unless @ftype
  @ftype == :file
end

#file_stat(path) ⇒ Object

:nodoc:



638
639
640
641
642
643
644
# File 'lib/zip/zip.rb', line 638

def file_stat(path)	# :nodoc:
  if @follow_symlinks
    return File::stat(path)
  else
    return File::lstat(path)
  end
end

#gather_fileinfo_from_srcpath(srcPath) ⇒ Object

:nodoc:



770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
# File 'lib/zip/zip.rb', line 770

def gather_fileinfo_from_srcpath(srcPath) # :nodoc:
  stat = file_stat(srcPath)
  case stat.ftype
  when 'file'
    if name_is_directory?
      raise ArgumentError,
 "entry name '#{newEntry}' indicates directory entry, but "+
 "'#{srcPath}' is not a directory"
    end
    @ftype = :file
  when 'directory'
    if ! name_is_directory?
      @name += "/"
    end
    @ftype = :directory
  when 'link'
    if name_is_directory?
      raise ArgumentError,
 "entry name '#{newEntry}' indicates directory entry, but "+
 "'#{srcPath}' is not a directory"
    end
    @ftype = :symlink
  else
  	raise RuntimeError, "unknown file type: #{srcPath.inspect} #{stat.inspect}"
  end

  @filepath = srcPath
  get_extra_attributes_from_path(@filepath)
end

#get_extra_attributes_from_path(path) ⇒ Object

:nodoc:



646
647
648
649
650
651
652
653
# File 'lib/zip/zip.rb', line 646

def get_extra_attributes_from_path(path)	# :nodoc:
  unless Zip::RUNNING_ON_WINDOWS
    stat = file_stat(path)
    @unix_uid = stat.uid
    @unix_gid = stat.gid
    @unix_perms = stat.mode & 07777
  end
end

#get_input_stream(&aProc) ⇒ Object

Returns an IO like object for the given ZipEntry. Warning: may behave weird with symlinks.



738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
# File 'lib/zip/zip.rb', line 738

def get_input_stream(&aProc)
  if @ftype == :directory
      return yield(NullInputStream.instance) if block_given?
      return NullInputStream.instance
  elsif @filepath
    case @ftype
    when :file
      return File.open(@filepath, "rb", &aProc)

    when :symlink
      linkpath = File::readlink(@filepath)
      stringio = StringIO.new(linkpath)
      return yield(stringio) if block_given?
      return stringio
    else
      raise "unknown @ftype #{@ftype}"
    end
  else
    zis = ZipInputStream.new(@zipfile, localHeaderOffset)
    zis.get_next_entry
    if block_given?
      begin
 return yield(zis)
	  ensure
 zis.close
	  end
    else
	  return zis
    end
  end
end

#get_raw_input_stream(&aProc) ⇒ Object



817
818
819
# File 'lib/zip/zip.rb', line 817

def get_raw_input_stream(&aProc)
  File.open(@zipfile, "rb", &aProc)
end

#local_entry_offsetObject

:nodoc:all



441
442
443
# File 'lib/zip/zip.rb', line 441

def local_entry_offset  #:nodoc:all
  localHeaderOffset + local_header_size
end

#local_header_sizeObject

:nodoc:all



445
446
447
# File 'lib/zip/zip.rb', line 445

def local_header_size  #:nodoc:all
  LOCAL_ENTRY_STATIC_HEADER_LENGTH + (@name ?  @name.size : 0) + (@extra ? @extra.local_size : 0)
end

#name_is_directory?Boolean

:nodoc:all

Returns:

  • (Boolean)


437
438
439
# File 'lib/zip/zip.rb', line 437

def name_is_directory?  #:nodoc:all
  (%r{\/$} =~ @name) != nil
end

#next_header_offsetObject

:nodoc:all



454
455
456
# File 'lib/zip/zip.rb', line 454

def next_header_offset  #:nodoc:all
  local_entry_offset + self.compressed_size
end

#parent_as_stringObject



811
812
813
814
815
# File 'lib/zip/zip.rb', line 811

def parent_as_string
  entry_name = name.chomp("/")
  slash_index = entry_name.rindex("/")
  slash_index ? entry_name.slice(0, slash_index+1) : nil
end

#read_c_dir_entry(io) ⇒ Object

:nodoc:all



563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
# File 'lib/zip/zip.rb', line 563

def read_c_dir_entry(io)  #:nodoc:all
  staticSizedFieldsBuf = io.read(CDIR_ENTRY_STATIC_HEADER_LENGTH)
  unless (staticSizedFieldsBuf.size == CDIR_ENTRY_STATIC_HEADER_LENGTH)
	raise ZipError, "Premature end of file. Not enough data for zip cdir entry header"
  end

  @header_signature          ,
	@version               , # version of encoding software
    @fstype                , # filesystem type
	@versionNeededToExtract,
	@gp_flags               ,
	@compression_method     ,
	lastModTime            ,
	lastModDate            ,
	@crc                   ,
	@compressed_size        ,
	@size                  ,
	nameLength             ,
	extraLength            ,
	commentLength          ,
	diskNumberStart        ,
	@internalFileAttributes,
	@externalFileAttributes,
	@localHeaderOffset     ,
	@name                  ,
	@extra                 ,
	@comment               = staticSizedFieldsBuf.unpack('VCCvvvvvVVVvvvvvVV')

  unless (@header_signature == CENTRAL_DIRECTORY_ENTRY_SIGNATURE)
	raise ZipError, "Zip local header magic not found at location '#{localHeaderOffset}'"
  end
  set_time(lastModDate, lastModTime)
  
  @name                  = io.read(nameLength)
  if ZipExtraField === @extra
    @extra.merge(io.read(extraLength))
  else
    @extra = ZipExtraField.new(io.read(extraLength))
  end
  @comment               = io.read(commentLength)
  unless (@comment && @comment.length == commentLength)
	raise ZipError, "Truncated cdir zip entry header"
  end

  case @fstype
  when FSTYPE_UNIX
    @unix_perms = (@externalFileAttributes >> 16) & 07777

    case (@externalFileAttributes >> 28)
    when 04
      @ftype = :directory
    when 010
      @ftype = :file
    when 012
      @ftype = :link
    else
      raise ZipInternalError, "unknown file type #{'0%o' % (@externalFileAttributes >> 28)}"
    end
  else
    if name_is_directory?
      @ftype = :directory
    else
      @ftype = :file
    end
  end
end

#read_local_entry(io) ⇒ Object

:nodoc:all



494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
# File 'lib/zip/zip.rb', line 494

def read_local_entry(io)  #:nodoc:all
  @localHeaderOffset = io.tell
  staticSizedFieldsBuf = io.read(LOCAL_ENTRY_STATIC_HEADER_LENGTH)
  unless (staticSizedFieldsBuf.size==LOCAL_ENTRY_STATIC_HEADER_LENGTH)
	raise ZipError, "Premature end of file. Not enough data for zip entry local header"
  end
  
  @header_signature       ,
    @version          ,
	@fstype           ,
	@gp_flags          ,
	@compression_method,
	lastModTime       ,
	lastModDate       ,
	@crc              ,
	@compressed_size   ,
	@size             ,
	nameLength        ,
	extraLength       = staticSizedFieldsBuf.unpack('VCCvvvvVVVvv') 

  unless (@header_signature == LOCAL_ENTRY_SIGNATURE)
	raise ZipError, "Zip local header magic not found at location '#{localHeaderOffset}'"
  end
  set_time(lastModDate, lastModTime)
  
  @name              = io.read(nameLength)
  extra              = io.read(extraLength)

  if (extra && extra.length != extraLength)
	raise ZipError, "Truncated local zip entry header"
  else
    if ZipExtraField === @extra
      @extra.merge(extra)
    else
      @extra = ZipExtraField.new(extra)
    end
  end
end

#set_extra_attributes_on_path(destPath) ⇒ Object

:nodoc:



655
656
657
658
659
660
661
662
663
664
665
666
667
668
# File 'lib/zip/zip.rb', line 655

def set_extra_attributes_on_path(destPath)	# :nodoc:
  return unless (file? or directory?)

  case @fstype
  when FSTYPE_UNIX
    # BUG: does not update timestamps into account
    # ignore setuid/setgid bits by default.  honor if @restore_ownership
    unix_perms_mask = 01777
    unix_perms_mask = 07777 if (@restore_ownership)
  	File::chmod(@unix_perms & unix_perms_mask, destPath) if (@restore_permissions && @unix_perms)
    File::chown(@unix_uid, @unix_gid, destPath) if (@restore_ownership && @unix_uid && @unix_gid && Process::egid == 0)
    # File::utimes()
  end
end

#symlink?Boolean

Returns true if the entry is a symlink.

Returns:

  • (Boolean)

Raises:



432
433
434
435
# File 'lib/zip/zip.rb', line 432

def symlink?
  raise ZipInternalError, "current filetype is unknown: #{self.inspect}" unless @ftype
  @ftype == :link
end

#timeObject Also known as: mtime



399
400
401
402
403
404
405
406
407
# File 'lib/zip/zip.rb', line 399

def time
  if @extra["UniversalTime"]
    @extra["UniversalTime"].mtime
  else
    # Atandard time field in central directory has local time
    # under archive creator. Then, we can't get timezone.
    @time
  end
end

#time=(aTime) ⇒ Object



410
411
412
413
414
415
416
# File 'lib/zip/zip.rb', line 410

def time=(aTime)
  unless @extra.member?("UniversalTime")
    @extra.create("UniversalTime")
  end
  @extra["UniversalTime"].mtime = aTime
  @time = aTime
end

#to_sObject



475
476
477
# File 'lib/zip/zip.rb', line 475

def to_s
  @name
end

#write_c_dir_entry(io) ⇒ Object

:nodoc:all



670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
# File 'lib/zip/zip.rb', line 670

def write_c_dir_entry(io)  #:nodoc:all
  case @fstype
  when FSTYPE_UNIX
    ft = nil
    case @ftype
    when :file
      ft = 010
      @unix_perms ||= 0644
    when :directory
      ft = 004
      @unix_perms ||= 0755
    when :symlink
      ft = 012
      @unix_perms ||= 0755
    else
      raise ZipInternalError, "unknown file type #{self.inspect}"
    end

    @externalFileAttributes = (ft << 12 | (@unix_perms & 07777)) << 16
  end

  io << 
	[CENTRAL_DIRECTORY_ENTRY_SIGNATURE,
    @version                          , # version of encoding software
	@fstype                           , # filesystem type
	0                                 , # @versionNeededToExtract           ,
	0                                 , # @gp_flags                          ,
	@compression_method                ,
    @time.to_binary_dos_time             , # @lastModTime                      ,
	@time.to_binary_dos_date             , # @lastModDate                      ,
	@crc                              ,
	@compressed_size                   ,
	@size                             ,
	@name  ?  @name.length  : 0       ,
	@extra ? @extra.c_dir_length : 0  ,
	@comment ? comment.length : 0     ,
	0                                 , # disk number start
	@internalFileAttributes           , # file type (binary=0, text=1)
	@externalFileAttributes           , # native filesystem attributes
	@localHeaderOffset                ,
	@name                             ,
	@extra                            ,
	@comment                          ].pack('VCCvvvvvVVVvvvvvVV')

  io << @name
  io << (@extra ? @extra.to_c_dir_bin : "")
  io << @comment
end

#write_local_entry(io) ⇒ Object

:nodoc:all



541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
# File 'lib/zip/zip.rb', line 541

def write_local_entry(io)   #:nodoc:all
  @localHeaderOffset = io.tell
  
  io << 
	[LOCAL_ENTRY_SIGNATURE    ,
	0                  ,
	0                         , # @gp_flags                  ,
	@compression_method        ,
	@time.to_binary_dos_time     , # @lastModTime              ,
	@time.to_binary_dos_date     , # @lastModDate              ,
	@crc                      ,
	@compressed_size           ,
	@size                     ,
	@name ? @name.length   : 0,
	@extra? @extra.local_length : 0 ].pack('VvvvvvVVVvv')
  io << @name
  io << (@extra ? @extra.to_local_bin : "")
end

#write_to_zip_output_stream(aZipOutputStream) ⇒ Object

:nodoc:all



800
801
802
803
804
805
806
807
808
809
# File 'lib/zip/zip.rb', line 800

def write_to_zip_output_stream(aZipOutputStream)  #:nodoc:all
  if @ftype == :directory
    aZipOutputStream.put_next_entry(self)
  elsif @filepath
    aZipOutputStream.put_next_entry(self)
    get_input_stream { |is| IOExtras.copy_stream(aZipOutputStream, is) } 
  else
    aZipOutputStream.copy_raw_entry(self)
  end
end