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.



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

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.



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

def comment
  @comment
end

#compressed_sizeObject

Returns the value of attribute compressed_size.



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

def compressed_size
  @compressed_size
end

#compression_methodObject

Returns the value of attribute compression_method.



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

def compression_method
  @compression_method
end

#crcObject

Returns the value of attribute crc.



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

def crc
  @crc
end

#externalFileAttributesObject

Returns the value of attribute externalFileAttributes.



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

def externalFileAttributes
  @externalFileAttributes
end

#extraObject

Returns the value of attribute extra.



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

def extra
  @extra
end

#filepathObject (readonly)

:nodoc:



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

def filepath
  @filepath
end

Returns the value of attribute follow_symlinks.



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

def follow_symlinks
  @follow_symlinks
end

#fstypeObject

Returns the value of attribute fstype.



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

def fstype
  @fstype
end

#ftypeObject (readonly)

:nodoc:



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

def ftype
  @ftype
end

#gp_flagsObject

Returns the value of attribute gp_flags.



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

def gp_flags
  @gp_flags
end

#header_signatureObject

Returns the value of attribute header_signature.



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

def header_signature
  @header_signature
end

#localHeaderOffsetObject

Returns the value of attribute localHeaderOffset.



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

def localHeaderOffset
  @localHeaderOffset
end

#nameObject

Returns the value of attribute name.



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

def name
  @name
end

#restore_ownershipObject

Returns the value of attribute restore_ownership.



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

def restore_ownership
  @restore_ownership
end

#restore_permissionsObject

Returns the value of attribute restore_permissions.



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

def restore_permissions
  @restore_permissions
end

#restore_timesObject

Returns the value of attribute restore_times.



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

def restore_times
  @restore_times
end

#sizeObject

Returns the value of attribute size.



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

def size
  @size
end

#unix_gidObject

Returns the value of attribute unix_gid.



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

def unix_gid
  @unix_gid
end

#unix_permsObject

Returns the value of attribute unix_perms.



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

def unix_perms
  @unix_perms
end

#unix_uidObject

Returns the value of attribute unix_uid.



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

def unix_uid
  @unix_uid
end

#zipfileObject

Returns the value of attribute zipfile.



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

def zipfile
  @zipfile
end

Class Method Details

.read_c_dir_entry(io) ⇒ Object

:nodoc:all



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

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



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

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



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

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

#==(other) ⇒ Object



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

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



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

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:



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

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



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

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:



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

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

#file_stat(path) ⇒ Object

:nodoc:



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

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:



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

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:



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

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.



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

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



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

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

#local_entry_offsetObject

:nodoc:all



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

def local_entry_offset  #:nodoc:all
  localHeaderOffset + local_header_size
end

#local_header_sizeObject

:nodoc:all



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

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)


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

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

#next_header_offsetObject

:nodoc:all



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

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

#parent_as_stringObject



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

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



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

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



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

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:



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

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:



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

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

#timeObject Also known as: mtime



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

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



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

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

#to_sObject



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

def to_s
  @name
end

#write_c_dir_entry(io) ⇒ Object

:nodoc:all



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

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



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

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



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

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