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.



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
399
400
401
402
403
# File 'lib/zip/zip.rb', line 357

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.



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

def comment
  @comment
end

#compressed_sizeObject

Returns the value of attribute compressed_size.



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

def compressed_size
  @compressed_size
end

#compression_methodObject

Returns the value of attribute compression_method.



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

def compression_method
  @compression_method
end

#crcObject

Returns the value of attribute crc.



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

def crc
  @crc
end

#externalFileAttributesObject

Returns the value of attribute externalFileAttributes.



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

def externalFileAttributes
  @externalFileAttributes
end

#extraObject

Returns the value of attribute extra.



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

def extra
  @extra
end

#filepathObject (readonly)

:nodoc:



355
356
357
# File 'lib/zip/zip.rb', line 355

def filepath
  @filepath
end

Returns the value of attribute follow_symlinks.



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

def follow_symlinks
  @follow_symlinks
end

#fstypeObject

Returns the value of attribute fstype.



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

def fstype
  @fstype
end

#ftypeObject (readonly)

:nodoc:



355
356
357
# File 'lib/zip/zip.rb', line 355

def ftype
  @ftype
end

#gp_flagsObject

Returns the value of attribute gp_flags.



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

def gp_flags
  @gp_flags
end

#header_signatureObject

Returns the value of attribute header_signature.



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

def header_signature
  @header_signature
end

#localHeaderOffsetObject

Returns the value of attribute localHeaderOffset.



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

def localHeaderOffset
  @localHeaderOffset
end

#nameObject

Returns the value of attribute name.



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

def name
  @name
end

#restore_ownershipObject

Returns the value of attribute restore_ownership.



352
353
354
# File 'lib/zip/zip.rb', line 352

def restore_ownership
  @restore_ownership
end

#restore_permissionsObject

Returns the value of attribute restore_permissions.



352
353
354
# File 'lib/zip/zip.rb', line 352

def restore_permissions
  @restore_permissions
end

#restore_timesObject

Returns the value of attribute restore_times.



352
353
354
# File 'lib/zip/zip.rb', line 352

def restore_times
  @restore_times
end

#sizeObject

Returns the value of attribute size.



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

def size
  @size
end

#unix_gidObject

Returns the value of attribute unix_gid.



353
354
355
# File 'lib/zip/zip.rb', line 353

def unix_gid
  @unix_gid
end

#unix_permsObject

Returns the value of attribute unix_perms.



353
354
355
# File 'lib/zip/zip.rb', line 353

def unix_perms
  @unix_perms
end

#unix_uidObject

Returns the value of attribute unix_uid.



353
354
355
# File 'lib/zip/zip.rb', line 353

def unix_uid
  @unix_uid
end

#zipfileObject

Returns the value of attribute zipfile.



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

def zipfile
  @zipfile
end

Class Method Details

.read_c_dir_entry(io) ⇒ Object

:nodoc:all



636
637
638
639
640
641
642
# File 'lib/zip/zip.rb', line 636

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



539
540
541
542
543
544
545
# File 'lib/zip/zip.rb', line 539

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



738
739
740
# File 'lib/zip/zip.rb', line 738

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

#==(other) ⇒ Object



725
726
727
728
729
730
731
732
733
734
735
736
# File 'lib/zip/zip.rb', line 725

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



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

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:



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

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



465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
# File 'lib/zip/zip.rb', line 465

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:



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

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

#file_stat(path) ⇒ Object

:nodoc:



644
645
646
647
648
649
650
# File 'lib/zip/zip.rb', line 644

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:



776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
# File 'lib/zip/zip.rb', line 776

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:



652
653
654
655
656
657
658
659
# File 'lib/zip/zip.rb', line 652

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.



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
770
771
772
773
774
# File 'lib/zip/zip.rb', line 744

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



823
824
825
# File 'lib/zip/zip.rb', line 823

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

#local_entry_offsetObject

:nodoc:all



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

def local_entry_offset  #:nodoc:all
  localHeaderOffset + local_header_size
end

#local_header_sizeObject

:nodoc:all



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

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)


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

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

#next_header_offsetObject

:nodoc:all



460
461
462
# File 'lib/zip/zip.rb', line 460

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

#parent_as_stringObject



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

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



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
630
631
632
633
634
# File 'lib/zip/zip.rb', line 569

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



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
533
534
535
536
537
# File 'lib/zip/zip.rb', line 500

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:



661
662
663
664
665
666
667
668
669
670
671
672
673
674
# File 'lib/zip/zip.rb', line 661

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:



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

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

#timeObject Also known as: mtime



405
406
407
408
409
410
411
412
413
# File 'lib/zip/zip.rb', line 405

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



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

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

#to_sObject



481
482
483
# File 'lib/zip/zip.rb', line 481

def to_s
  @name
end

#write_c_dir_entry(io) ⇒ Object

:nodoc:all



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
719
720
721
722
723
# File 'lib/zip/zip.rb', line 676

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



547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
# File 'lib/zip/zip.rb', line 547

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



806
807
808
809
810
811
812
813
814
815
# File 'lib/zip/zip.rb', line 806

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