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.



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
398
# File 'lib/zip/zip.rb', line 352

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.



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

def comment
  @comment
end

#compressed_sizeObject

Returns the value of attribute compressed_size.



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

def compressed_size
  @compressed_size
end

#compression_methodObject

Returns the value of attribute compression_method.



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

def compression_method
  @compression_method
end

#crcObject

Returns the value of attribute crc.



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

def crc
  @crc
end

#externalFileAttributesObject

Returns the value of attribute externalFileAttributes.



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

def externalFileAttributes
  @externalFileAttributes
end

#extraObject

Returns the value of attribute extra.



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

def extra
  @extra
end

#filepathObject (readonly)

:nodoc:



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

def filepath
  @filepath
end

Returns the value of attribute follow_symlinks.



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

def follow_symlinks
  @follow_symlinks
end

#fstypeObject

Returns the value of attribute fstype.



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

def fstype
  @fstype
end

#ftypeObject (readonly)

:nodoc:



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

def ftype
  @ftype
end

#gp_flagsObject

Returns the value of attribute gp_flags.



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

def gp_flags
  @gp_flags
end

#header_signatureObject

Returns the value of attribute header_signature.



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

def header_signature
  @header_signature
end

#localHeaderOffsetObject

Returns the value of attribute localHeaderOffset.



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

def localHeaderOffset
  @localHeaderOffset
end

#nameObject

Returns the value of attribute name.



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

def name
  @name
end

#restore_ownershipObject

Returns the value of attribute restore_ownership.



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

def restore_ownership
  @restore_ownership
end

#restore_permissionsObject

Returns the value of attribute restore_permissions.



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

def restore_permissions
  @restore_permissions
end

#restore_timesObject

Returns the value of attribute restore_times.



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

def restore_times
  @restore_times
end

#sizeObject

Returns the value of attribute size.



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

def size
  @size
end

#unix_gidObject

Returns the value of attribute unix_gid.



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

def unix_gid
  @unix_gid
end

#unix_permsObject

Returns the value of attribute unix_perms.



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

def unix_perms
  @unix_perms
end

#unix_uidObject

Returns the value of attribute unix_uid.



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

def unix_uid
  @unix_uid
end

#zipfileObject

Returns the value of attribute zipfile.



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

def zipfile
  @zipfile
end

Class Method Details

.read_c_dir_entry(io) ⇒ Object

:nodoc:all



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

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



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

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



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

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

#==(other) ⇒ Object



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

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



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

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:



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

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).



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

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:



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

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

#file_stat(path) ⇒ Object

:nodoc:



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

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:



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
799
# File 'lib/zip/zip.rb', line 771

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:



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

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.



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
769
# File 'lib/zip/zip.rb', line 739

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



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

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

#local_entry_offsetObject

:nodoc:all



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

def local_entry_offset  #:nodoc:all
  localHeaderOffset + local_header_size
end

#local_header_sizeObject

:nodoc:all



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

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)


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

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

#next_header_offsetObject

:nodoc:all



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

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

#parent_as_stringObject



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

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



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
629
# File 'lib/zip/zip.rb', line 564

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



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
532
# File 'lib/zip/zip.rb', line 495

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:



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

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:



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

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

#timeObject Also known as: mtime



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

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



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

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

#to_sObject



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

def to_s
  @name
end

#write_c_dir_entry(io) ⇒ Object

:nodoc:all



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
718
# File 'lib/zip/zip.rb', line 671

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



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

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



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

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