GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SVN::DUMP::RECORD (3)

.ds Aq ’

NAME

SVN::Dump::Record - A SVN dump record

CONTENTS

SYNOPSIS



    # SVN::Dump::Record objects are returned by the next_record()
    # method of SVN::Dump



DESCRIPTION

An SVN::Dump::Record object represents a Subversion dump record.

METHODS

SVN::Dump provides the following gourps of methods:

    Record methods

new() Create a new empty SVN::Dump::Record object.
type() Return the record type, as guessed from its headers.

The method dies if the record type cannot be determined.

set_header( $h, $v ) Set the header $h to the value $v.
get_header( $h ) Get the value of header $h.
set_property( $p, $v ) Set the property $p to the value $v.
get_property( $p ) Get the value of property $p.
delete_property( @k ) Delete the properties named in @p. Properties that do not exist in the record will be silently ignored.
set_text( $t ) Set the value of the text block.
get_text() Get the value of the text block.

    Inner blocks manipulation

A SVN::Dump::Record is composed of several inner blocks of various kinds: SVN::Dump::Headers, SVN::Dump::Property and SVN::Dump::Text.

The following methods provide access to these blocks:
set_headers_block( $headers )
get_headers_block() Get or set the SVN::Dump::Headers object that represents the record headers.
set_property_block( $property )
get_property_block() Get or set the SVN::Dump::Property object that represents the record property block.
delete_property( @keys ) Delete the given properties. Behaves like the builtin delete().
set_text_block( $text )
get_text_block() Get or set the SVN::Dump::Text object that represents the record text block.
set_included_record( $record )
get_included_record() Some special record are actually output recursiveley by <B>svnadmin dumpB>. The record in the record is stored within the parent record, so they are parsed as a single record with an included record.

get_record() / set_record() give access to the included record.

According to the Subversion sources (subversion/libsvn_repos/dump.c), this is a delete original, then add-with-history node. The dump looks like this:



    Node-path: tags/mytag/myfile
    Node-kind: file
    Node-action: delete
   
    Node-path: tags/mytag/myfile
    Node-kind: file
    Node-action: add
    Node-copyfrom-rev: 23
    Node-copyfrom-path: trunk/myfile



Note that there is a single blank line after the first header block, and four after the included one.

update_headers() Update the various ...-length headers. Used internally.

<B>You must call this method if you update the inner property or text blocks directly, or the results of B>as_string()<B> will be inconsistent.B>

    Information methods

has_prop() Return a boolean value indicating if the record has a property block.
has_text() Return a boolean value indicating if the record has a text block.
has_prop_only() Return a boolean value indicating if the record has only a property block (and no text block).
has_prop_or_text() Return a boolean value indicating if the record has a property block or a text block.
property_length() Return the length of the property block.
text_length() Return the length of the text block.

    Output method

as_string() Return a string representation of the record that will be understood by other Subversion tools, such as svnadmin.

<B>Warning:B> dumping a record currently returns the information that was read from the original dump. This means that if you modified the property or text block of a record, the headers will be inconsistent.

ENCAPSULATION

When using SVN::Dump to manipulate a SVN dump, one should not access the SVN::Dump::Headers, SVN::Dump::Property and SVN::Dump::Text components of a SVN::Dump::Record object directly, but use the appropriate set_...() and get_...() methods of the record object.

These methods compute the appropriate modifications of the header values, so that the as_string() method outputs the correct information after any modification of the record.

SEE ALSO

SVN::Dump, SVN::Dump::Reader, SVN::Dump::Headers, SVN::Dump::Property, SVN::Dump::Text.

COPYRIGHT

Copyright 2006-2013 Philippe Bruhat (BooK), All Rights Reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 SVN::DUMP::RECORD (3) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.