1 /** 2 * @copyright 3 * ==================================================================== 4 * Licensed to the Apache Software Foundation (ASF) under one 5 * or more contributor license agreements. See the NOTICE file 6 * distributed with this work for additional information 7 * regarding copyright ownership. The ASF licenses this file 8 * to you under the Apache License, Version 2.0 (the 9 * "License"); you may not use this file except in compliance 10 * with the License. You may obtain a copy of the License at 11 * 12 * http://www.apache.org/licenses/LICENSE-2.0 13 * 14 * Unless required by applicable law or agreed to in writing, 15 * software distributed under the License is distributed on an 16 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 17 * KIND, either express or implied. See the License for the 18 * specific language governing permissions and limitations 19 * under the License. 20 * ==================================================================== 21 * @endcopyright 22 * 23 * @file svn_props.h 24 * @brief Subversion properties 25 */ 26 27 /* ==================================================================== */ 28 29 #ifndef SVN_PROPS_H 30 #define SVN_PROPS_H 31 32 #include <apr_pools.h> /* for apr_pool_t */ 33 #include <apr_tables.h> /* for apr_array_header_t */ 34 #include <apr_hash.h> /* for apr_hash_t */ 35 36 #include "svn_types.h" /* for svn_boolean_t, svn_error_t */ 37 #include "svn_string.h" /* for svn_string_t */ 38 39 #ifdef __cplusplus 40 extern "C" { 41 #endif /* __cplusplus */ 42 43 /** 44 * @defgroup svn_props_support Properties management utilities 45 * @{ 46 */ 47 48 49 50 /** A general in-memory representation of a single property. Most of 51 * the time, property lists will be stored completely in hashes. But 52 * sometimes it's useful to have an "ordered" collection of 53 * properties, in which case we use an array of these structures. 54 * 55 * Also: sometimes we want a list that represents a set of property 56 * *changes*, and in this case, an @c apr_hash_t won't work -- there's no 57 * way to represent a property deletion, because we can't store a @c NULL 58 * value in a hash. So instead, we use these structures. 59 */ 60 typedef struct svn_prop_t 61 { 62 const char *name; /**< Property name */ 63 const svn_string_t *value; /**< Property value */ 64 } svn_prop_t; 65 66 67 /** 68 * Return a duplicate of @a prop, allocated in @a pool. No part of the new 69 * structure will be shared with @a prop. 70 * 71 * @since New in 1.3. 72 */ 73 svn_prop_t * 74 svn_prop_dup(const svn_prop_t *prop, 75 apr_pool_t *pool); 76 77 78 /** 79 * Duplicate an @a array of svn_prop_t items using @a pool. 80 * 81 * @since New in 1.3. 82 */ 83 apr_array_header_t * 84 svn_prop_array_dup(const apr_array_header_t *array, 85 apr_pool_t *pool); 86 87 88 /** A structure to represent inherited properties. 89 * 90 * @since New in 1.8. 91 */ 92 typedef struct svn_prop_inherited_item_t 93 { 94 /** The absolute working copy path, relative filesystem path, or URL 95 * from which the properties in @a prop_hash are inherited. (For 96 * details about which path specification format is in use for a 97 * particular instance of this structure, consult the documentation 98 * for the API which produced it.) */ 99 const char *path_or_url; 100 101 /** A hash of (<tt>const char *</tt>) inherited property names, and 102 * (<tt>svn_string_t *</tt>) property values. */ 103 apr_hash_t *prop_hash; 104 105 } svn_prop_inherited_item_t; 106 107 108 /** 109 * Given a hash (keys <tt>const char *</tt> and values <tt>const 110 * svn_string_t</tt>) of properties, returns an array of svn_prop_t 111 * items using @a pool. 112 * 113 * @since New in 1.5. 114 */ 115 apr_array_header_t * 116 svn_prop_hash_to_array(const apr_hash_t *hash, 117 apr_pool_t *pool); 118 119 /** 120 * Given an array of svn_prop_t items, return a hash mapping const char * 121 * property names to const svn_string_t * values. 122 * 123 * @warning The behaviour on #svn_prop_t objects with a @c NULL @c 124 * svn_prop_t.value member is undefined. 125 * 126 * @since New in 1.7. 127 */ 128 apr_hash_t * 129 svn_prop_array_to_hash(const apr_array_header_t *properties, 130 apr_pool_t *result); 131 132 /** 133 * Creates a deep copy of @a hash (keys <tt>const char *</tt> and 134 * values <tt>const svn_string_t *</tt>) in @a pool. 135 * 136 * @since New in 1.6. 137 */ 138 apr_hash_t * 139 svn_prop_hash_dup(const apr_hash_t *hash, 140 apr_pool_t *pool); 141 142 /** 143 * Return the value of property @a prop_name as it is in @a properties, 144 * with values <tt>const svn_string_t</tt>. If @a prop_name is not 145 * in @a properties or @a properties is NULL, return NULL. 146 * 147 * @since New in 1.7. 148 */ 149 const char * 150 svn_prop_get_value(const apr_hash_t *properties, 151 const char *prop_name); 152 153 /** 154 * Subversion distinguishes among several kinds of properties, 155 * particularly on the client-side. There is no "unknown" kind; if 156 * there's nothing special about a property name, the default category 157 * is @c svn_prop_regular_kind. 158 */ 159 typedef enum svn_prop_kind 160 { 161 /** In .svn/entries, i.e., author, date, etc. */ 162 svn_prop_entry_kind, 163 164 /** Client-side only, stored by specific RA layer. */ 165 svn_prop_wc_kind, 166 167 /** Seen if user does "svn proplist"; note that this includes some "svn:" 168 * props and all user props, i.e. ones stored in the repository fs. 169 */ 170 svn_prop_regular_kind 171 } svn_prop_kind_t; 172 173 /** Return the property kind of a property named @a prop_name. 174 * 175 * @since New in 1.8. 176 */ 177 svn_prop_kind_t 178 svn_property_kind2(const char *prop_name); 179 180 /** Return the prop kind of a property named @a prop_name, and 181 * (if @a prefix_len is non-@c NULL) set @a *prefix_len to the length of 182 * the prefix of @a prop_name that was sufficient to distinguish its kind. 183 * 184 * @deprecated Provided for backward compatibility with the 1.7 API. 185 */ 186 SVN_DEPRECATED 187 svn_prop_kind_t 188 svn_property_kind(int *prefix_len, 189 const char *prop_name); 190 191 192 /** Return @c TRUE iff @a prop_name represents the name of a Subversion 193 * property. That is, any property name in Subversion's name space for 194 * versioned or unversioned properties, regardless whether the particular 195 * property name is recognized. 196 */ 197 svn_boolean_t 198 svn_prop_is_svn_prop(const char *prop_name); 199 200 201 /** Return @c TRUE iff @a props has at least one property whose name 202 * represents the name of a Subversion property, in the sense of 203 * svn_prop_is_svn_prop(). 204 * 205 * @since New in 1.5. 206 */ 207 svn_boolean_t 208 svn_prop_has_svn_prop(const apr_hash_t *props, 209 apr_pool_t *pool); 210 211 /** Return @c TRUE iff @a prop_name is a Subversion property whose 212 * value is interpreted as a boolean. 213 * 214 * @since New in 1.5. 215 */ 216 svn_boolean_t 217 svn_prop_is_boolean(const char *prop_name); 218 219 /** Return @c TRUE iff @a prop_name is in the "svn:" name space and is a 220 * known revision property ("svn:log" or "svn:date", e.g.). 221 * 222 * This will return @c FALSE for any property name that is not known by this 223 * version of the library, even though the name may be known to other (for 224 * example, later) Subversion software. 225 * 226 * @since New in 1.8. 227 */ 228 svn_boolean_t 229 svn_prop_is_known_svn_rev_prop(const char *prop_name); 230 231 /** Return @c TRUE iff @a prop_name is in the "svn:" name space and is a 232 * known versioned property that is allowed on a file and/or on a 233 * directory ("svn:eol-style", "svn:ignore", or "svn:mergeinfo", e.g.). 234 * 235 * This will return @c FALSE for any property name that is not known 236 * by this version of the library, even though the name may be known 237 * to other (for example, later) Subversion software. 238 * 239 * @since New in 1.8. 240 */ 241 svn_boolean_t 242 svn_prop_is_known_svn_node_prop(const char *prop_name); 243 244 /** Return @c TRUE iff @a prop_name is in the "svn:" name space and is 245 * a known versioned property that is allowed on a file 246 * ("svn:eol-style" or "svn:mergeinfo", e.g.). 247 * 248 * This will return @c FALSE for any property name that is not known 249 * by this version of the library, even though the name may be known 250 * to other (for example, later) Subversion software. 251 * 252 * @since New in 1.8. 253 */ 254 svn_boolean_t 255 svn_prop_is_known_svn_file_prop(const char *prop_name); 256 257 /** Return @c TRUE iff @a prop_name is in the "svn:" name space and is 258 * a known versioned property that is allowed on a directory 259 * ("svn:ignore" or "svn:mergeinfo", e.g.). 260 * 261 * This will return @c FALSE for any property name that is not known 262 * by this version of the library, even though the name may be known 263 * to other (for example, later) Subversion software. 264 * 265 * @since New in 1.8. 266 */ 267 svn_boolean_t 268 svn_prop_is_known_svn_dir_prop(const char *prop_name); 269 270 /** If @a prop_name requires that its value be stored as UTF8/LF in the 271 * repository, then return @c TRUE. Else return @c FALSE. This is for 272 * users of libsvn_client or libsvn_fs, since it their responsibility 273 * to do this translation in both directions. (See 274 * svn_subst_translate_string()/svn_subst_detranslate_string() for 275 * help with this task.) 276 */ 277 svn_boolean_t 278 svn_prop_needs_translation(const char *prop_name); 279 280 281 /** Given a @a proplist array of @c svn_prop_t structures, allocate 282 * three new arrays in @a pool. Categorize each property and then 283 * create new @c svn_prop_t structures in the proper lists. Each new 284 * @c svn_prop_t structure's fields will point to the same data within 285 * @a proplist's structures. 286 * 287 * Callers may pass NULL for each of the property lists in which they 288 * are uninterested. If no props exist in a certain category, and the 289 * property list argument for that category is non-NULL, then that 290 * array will come back with <tt>->nelts == 0</tt>. 291 */ 292 svn_error_t * 293 svn_categorize_props(const apr_array_header_t *proplist, 294 apr_array_header_t **entry_props, 295 apr_array_header_t **wc_props, 296 apr_array_header_t **regular_props, 297 apr_pool_t *pool); 298 299 300 /** Given two property hashes (<tt>const char *name</tt> -> <tt>const 301 * svn_string_t *value</tt>), deduce the differences between them (from 302 * @a source_props -> @c target_props). Set @a propdiffs to a new array of 303 * @c svn_prop_t structures, with one entry for each property that differs, 304 * including properties that exist in @a source_props or @a target_props but 305 * not both. The @c value field of each entry is that property's value from 306 * @a target_props or NULL if that property only exists in @a source_props. 307 * 308 * Allocate the array from @a pool. Allocate the contents of the array from 309 * @a pool or by reference to the storage of the input hashes or both. 310 * 311 * For note, here's a quick little table describing the logic of this 312 * routine: 313 * 314 * @verbatim 315 source_props target_props event 316 ------------ ------------ ----- 317 value = foo value = NULL Deletion occurred. 318 value = foo value = bar Set occurred (modification) 319 value = NULL value = baz Set occurred (creation) @endverbatim 320 */ 321 svn_error_t * 322 svn_prop_diffs(apr_array_header_t **propdiffs, 323 const apr_hash_t *target_props, 324 const apr_hash_t *source_props, 325 apr_pool_t *pool); 326 327 328 /** 329 * Return @c TRUE iff @a prop_name is a valid property name. 330 * 331 * For now, "valid" means the ASCII subset of an XML "Name". 332 * XML "Name" is defined at http://www.w3.org/TR/REC-xml#sec-common-syn 333 * 334 * @since New in 1.5. 335 */ 336 svn_boolean_t 337 svn_prop_name_is_valid(const char *prop_name); 338 339 340 341 /* Defines for reserved ("svn:") property names. */ 342 343 /** All Subversion property names start with this. */ 344 #define SVN_PROP_PREFIX "svn:" 345 346 347 /** Visible properties 348 * 349 * These are regular properties that are attached to ordinary files 350 * and dirs, and are visible (and tweakable) by svn client programs 351 * and users. Adding these properties causes specific effects. 352 * 353 * @note the values of these properties are always UTF8-encoded with 354 * LF line-endings. It is the burden of svn library users to enforce 355 * this. Use svn_prop_needs_translation() to discover if a 356 * certain property needs translation, and you can use 357 * svn_subst_translate_string()/svn_subst_detranslate_string() 358 * to do the translation. 359 * 360 * @defgroup svn_prop_visible_props Visible properties 361 * @{ 362 */ 363 364 /** Properties whose values are interpreted as booleans (such as 365 * svn:executable, svn:needs_lock, and svn:special) always fold their 366 * value to this. 367 * 368 * @since New in 1.5. 369 */ 370 #define SVN_PROP_BOOLEAN_TRUE "*" 371 372 /** The mime-type of a given file. */ 373 #define SVN_PROP_MIME_TYPE SVN_PROP_PREFIX "mime-type" 374 375 /** The ignore patterns for a given directory. */ 376 #define SVN_PROP_IGNORE SVN_PROP_PREFIX "ignore" 377 378 /** The line ending style for a given file. */ 379 #define SVN_PROP_EOL_STYLE SVN_PROP_PREFIX "eol-style" 380 381 /** The "activated" keywords (for keyword substitution) for a given file. */ 382 #define SVN_PROP_KEYWORDS SVN_PROP_PREFIX "keywords" 383 384 /** Set to either TRUE or FALSE if we want a file to be executable or not. */ 385 #define SVN_PROP_EXECUTABLE SVN_PROP_PREFIX "executable" 386 387 /** The value to force the executable property to when set. 388 * 389 * @deprecated Provided for backward compatibility with the 1.4 API. 390 * Use @c SVN_PROP_BOOLEAN_TRUE instead. 391 */ 392 #define SVN_PROP_EXECUTABLE_VALUE SVN_PROP_BOOLEAN_TRUE 393 394 /** Set to TRUE ('*') if we want a file to be set to read-only when 395 * not locked. FALSE is indicated by deleting the property. */ 396 #define SVN_PROP_NEEDS_LOCK SVN_PROP_PREFIX "needs-lock" 397 398 /** The value to force the needs-lock property to when set. 399 * 400 * @deprecated Provided for backward compatibility with the 1.4 API. 401 * Use @c SVN_PROP_BOOLEAN_TRUE instead. 402 */ 403 #define SVN_PROP_NEEDS_LOCK_VALUE SVN_PROP_BOOLEAN_TRUE 404 405 /** Set if the file should be treated as a special file. */ 406 #define SVN_PROP_SPECIAL SVN_PROP_PREFIX "special" 407 408 /** The value to force the special property to when set. 409 * 410 * @deprecated Provided for backward compatibility with the 1.4 API. 411 * Use @c SVN_PROP_BOOLEAN_TRUE instead. 412 */ 413 #define SVN_PROP_SPECIAL_VALUE SVN_PROP_BOOLEAN_TRUE 414 415 /** Describes external items to check out into this directory. 416 * 417 * The format is a series of lines, each in the following format: 418 * [-r REV] URL[@PEG] LOCALPATH 419 * LOCALPATH is relative to the directory having this property. 420 * REV pins the external to revision REV. 421 * URL may be a full URL or a relative URL starting with one of: 422 * ../ to the parent directory of the extracted external 423 * ^/ to the repository root 424 * / to the server root 425 * // to the URL scheme 426 * The following format is supported for interoperability with 427 * Subversion 1.4 and earlier clients: 428 * LOCALPATH [-r PEG] URL 429 * The ambiguous format 'relative_path relative_path' is taken as 430 * 'relative_url relative_path' with peg revision support. 431 * Lines starting with a '#' character are ignored. 432 */ 433 #define SVN_PROP_EXTERNALS SVN_PROP_PREFIX "externals" 434 435 /** Merge info property used to record a resource's merge history. 436 * 437 * The format is a series of lines containing merge paths and revision 438 * ranges, such as: 439 * 440 * @verbatim 441 /trunk: 1-6,9,37-38 442 /trunk/foo: 10 @endverbatim 443 * @since New in 1.5. 444 */ 445 #define SVN_PROP_MERGEINFO SVN_PROP_PREFIX "mergeinfo" 446 447 /** Property used to record inheritable configuration auto-props. 448 * 449 * @since New in 1.8. 450 */ 451 #define SVN_PROP_INHERITABLE_AUTO_PROPS SVN_PROP_PREFIX "auto-props" 452 453 /** Property used to record inheritable configuration ignores. 454 * 455 * @since New in 1.8. 456 */ 457 #define SVN_PROP_INHERITABLE_IGNORES SVN_PROP_PREFIX "global-ignores" 458 459 /** Meta-data properties. 460 * 461 * The following properties are used for storing meta-data about 462 * individual entries in the meta-data branches of subversion, 463 * see issue #1256 or browseable at 464 * http://svn.apache.org/viewvc/subversion/branches/meta-data-versioning/ . 465 * Furthermore @c svntar (http://svn.borg.ch/svntar/) and @c FSVS 466 * (http://fsvs.tigris.org/) use these, too. 467 * 468 * Please note that these formats are very UNIX-centric currently; 469 * a bit of discussion about Windows can be read at 470 * http://article.gmane.org/gmane.comp.version-control.subversion.devel/103991 471 * 472 * @defgroup svn_prop_meta_data Meta-data properties 473 * @{ */ 474 475 /** The files' last modification time. 476 * This is stored as string in the form @c "2008-08-07T07:38:51.008782Z", to 477 * be converted by the functions @c svn_time_to_cstring() and 478 * @c svn_time_from_cstring(). */ 479 #define SVN_PROP_TEXT_TIME SVN_PROP_PREFIX "text-time" 480 481 /** The files' owner. 482 * Stored as numeric ID, optionally followed by whitespace and the string: 483 * @c "1000 pmarek". Parsers @b should accept any number of whitespace, 484 * and writers @b should put exactly a single space. */ 485 #define SVN_PROP_OWNER SVN_PROP_PREFIX "owner" 486 487 /** The files' group. 488 * The same format as for @c SVN_PROP_OWNER, the owner-property. */ 489 #define SVN_PROP_GROUP SVN_PROP_PREFIX "group" 490 491 /** The files' unix-mode. 492 * Stored in octal, with a leading @c 0; may have 5 digits if any of @c setuid, 493 * @c setgid or @c sticky are set; an example is @c "0644". */ 494 #define SVN_PROP_UNIX_MODE SVN_PROP_PREFIX "unix-mode" 495 496 /** @} */ /* Meta-data properties */ 497 498 /** 499 * This is a list of all user-visible and -settable versioned node 500 * properties. 501 * 502 * @since New in 1.8. 503 */ 504 #define SVN_PROP_NODE_ALL_PROPS SVN_PROP_MIME_TYPE, \ 505 SVN_PROP_IGNORE, \ 506 SVN_PROP_EOL_STYLE, \ 507 SVN_PROP_KEYWORDS, \ 508 SVN_PROP_EXECUTABLE, \ 509 SVN_PROP_NEEDS_LOCK, \ 510 SVN_PROP_SPECIAL, \ 511 SVN_PROP_EXTERNALS, \ 512 SVN_PROP_MERGEINFO, \ 513 SVN_PROP_INHERITABLE_AUTO_PROPS, \ 514 SVN_PROP_INHERITABLE_IGNORES, \ 515 \ 516 SVN_PROP_TEXT_TIME, \ 517 SVN_PROP_OWNER, \ 518 SVN_PROP_GROUP, \ 519 SVN_PROP_UNIX_MODE, 520 521 /** @} */ 522 523 /** WC props are props that are invisible to users: they're generated 524 * by an RA layer, and stored in secret parts of .svn/. 525 * 526 * @defgroup svn_prop_invisible_props Invisible properties 527 * @{ 528 */ 529 530 /** The property name *prefix* that makes a property a "WC property". 531 * 532 * For example, WebDAV RA implementations might store a versioned-resource 533 * url as a WC prop like this: 534 * 535 * <pre reason="Should use 'verbatim' instead, but Doxygen v1.6.1 & v1.7.1 536 * then doesn't recognize the #define; presumably a bug."> 537 name = svn:wc:dav_url 538 val = http://www.example.com/repos/452348/e.289 </pre> 539 * 540 * The client will try to protect WC props by warning users against 541 * changing them. The client will also send them back to the RA layer 542 * when committing. 543 */ 544 #define SVN_PROP_WC_PREFIX SVN_PROP_PREFIX "wc:" 545 546 /** Another type of non-user-visible property. "Entry properties" are 547 * stored as fields with the administrative 'entries' file. 548 */ 549 #define SVN_PROP_ENTRY_PREFIX SVN_PROP_PREFIX "entry:" 550 551 /** The revision this entry was last committed to on. */ 552 #define SVN_PROP_ENTRY_COMMITTED_REV SVN_PROP_ENTRY_PREFIX "committed-rev" 553 554 /** The date this entry was last committed to on. */ 555 #define SVN_PROP_ENTRY_COMMITTED_DATE SVN_PROP_ENTRY_PREFIX "committed-date" 556 557 /** The author who last committed to this entry. */ 558 #define SVN_PROP_ENTRY_LAST_AUTHOR SVN_PROP_ENTRY_PREFIX "last-author" 559 560 /** The UUID of this entry's repository. */ 561 #define SVN_PROP_ENTRY_UUID SVN_PROP_ENTRY_PREFIX "uuid" 562 563 /** The lock token for this entry. 564 * @since New in 1.2. */ 565 #define SVN_PROP_ENTRY_LOCK_TOKEN SVN_PROP_ENTRY_PREFIX "lock-token" 566 567 /** When custom, user-defined properties are passed over the wire, they will 568 * have this prefix added to their name. 569 */ 570 #define SVN_PROP_CUSTOM_PREFIX SVN_PROP_PREFIX "custom:" 571 572 /** @} */ 573 574 /** 575 * These are reserved properties attached to a "revision" object in 576 * the repository filesystem. They can be queried by using 577 * svn_fs_revision_prop(). 578 * 579 * @defgroup svn_props_revision_props Revision properties 580 * @{ 581 */ 582 583 /** The fs revision property that stores a commit's author. */ 584 #define SVN_PROP_REVISION_AUTHOR SVN_PROP_PREFIX "author" 585 586 /** The fs revision property that stores a commit's log message. */ 587 #define SVN_PROP_REVISION_LOG SVN_PROP_PREFIX "log" 588 589 /** The fs revision property that stores a commit's date. */ 590 #define SVN_PROP_REVISION_DATE SVN_PROP_PREFIX "date" 591 592 /** The fs revision property that stores a commit's "original" date. 593 * 594 * The svn:date property must be monotonically increasing, along with 595 * the revision number. In certain scenarios, this may pose a problem 596 * when the revision represents a commit that occurred at a time which 597 * does not fit within the sequencing required for svn:date. This can 598 * happen, for instance, when the revision represents a commit to a 599 * foreign version control system, or possibly when two Subversion 600 * repositories are combined. This property can be used to record the 601 * TRUE, original date of the commit. 602 */ 603 #define SVN_PROP_REVISION_ORIG_DATE SVN_PROP_PREFIX "original-date" 604 605 /** The presence of this fs revision property indicates that the 606 * revision was automatically generated by the mod_dav_svn 607 * autoversioning feature. The value is irrelevant. 608 */ 609 #define SVN_PROP_REVISION_AUTOVERSIONED SVN_PROP_PREFIX "autoversioned" 610 611 612 /* More reserved revision props in the 'svn:' namespace, used by the 613 svnsync tool: */ 614 615 /** Prefix for all svnsync custom properties. 616 * @since New in 1.4. 617 */ 618 #define SVNSYNC_PROP_PREFIX SVN_PROP_PREFIX "sync-" 619 620 /* The following revision properties are set on revision 0 of 621 * destination repositories by svnsync: 622 */ 623 624 /** Used to enforce mutually exclusive destination repository access. 625 * @since New in 1.4. 626 */ 627 #define SVNSYNC_PROP_LOCK SVNSYNC_PROP_PREFIX "lock" 628 629 /** Identifies the repository's source URL. 630 * @since New in 1.4. 631 */ 632 #define SVNSYNC_PROP_FROM_URL SVNSYNC_PROP_PREFIX "from-url" 633 /** Identifies the repository's source UUID. 634 * @since New in 1.4. 635 */ 636 #define SVNSYNC_PROP_FROM_UUID SVNSYNC_PROP_PREFIX "from-uuid" 637 638 /** Identifies the last completely mirrored revision. 639 * @since New in 1.4. 640 */ 641 #define SVNSYNC_PROP_LAST_MERGED_REV SVNSYNC_PROP_PREFIX "last-merged-rev" 642 643 /** Identifies the revision currently being copied. 644 * @since New in 1.4. 645 */ 646 #define SVNSYNC_PROP_CURRENTLY_COPYING SVNSYNC_PROP_PREFIX "currently-copying" 647 648 649 /** 650 * This is a list of all revision properties. 651 */ 652 #define SVN_PROP_REVISION_ALL_PROPS SVN_PROP_REVISION_AUTHOR, \ 653 SVN_PROP_REVISION_LOG, \ 654 SVN_PROP_REVISION_DATE, \ 655 SVN_PROP_REVISION_AUTOVERSIONED, \ 656 SVN_PROP_REVISION_ORIG_DATE, \ 657 SVNSYNC_PROP_LOCK, \ 658 SVNSYNC_PROP_FROM_URL, \ 659 SVNSYNC_PROP_FROM_UUID, \ 660 SVNSYNC_PROP_LAST_MERGED_REV, \ 661 SVNSYNC_PROP_CURRENTLY_COPYING, 662 663 /** @} */ 664 665 /** 666 * These are reserved properties attached to a "transaction" object in 667 * the repository filesystem in advance of the pre-commit hook script 668 * running on the server, but then automatically removed from the 669 * transaction before its promotion to a new revision. 670 * 671 * @defgroup svn_props_ephemeral_txnprops Ephemeral transaction properties 672 * @{ 673 */ 674 675 /** The prefix used for all (ephemeral) transaction properties. 676 * 677 * @since New in 1.8. 678 */ 679 #define SVN_PROP_TXN_PREFIX SVN_PROP_PREFIX "txn-" 680 681 /** Identifies the client version compatibility level. For clients 682 * compiled against Subversion libraries, this is @c SVN_VER_NUMBER. 683 * Third-party implementations are advised to use similar formatting 684 * for values of this property. 685 * 686 * @since New in 1.8. 687 */ 688 #define SVN_PROP_TXN_CLIENT_COMPAT_VERSION \ 689 SVN_PROP_TXN_PREFIX "client-compat-version" 690 691 /** Identifies the client's user agent string, if any. 692 * 693 * @since New in 1.8. 694 */ 695 #define SVN_PROP_TXN_USER_AGENT \ 696 SVN_PROP_TXN_PREFIX "user-agent" 697 698 /** The prefix reserved for copies of (ephemeral) transaction 699 * properties designed to outlive the transaction. Administrators may 700 * choose to, in their pre-commit hook scripts, copy the values of one 701 * or more properties named @c SVN_PROP_TXN_PREFIX + "something" 702 * to new properties named @c SVN_PROP_REVISION_PREFIX + "something", 703 * allowing that information to survive the commit-time removal of 704 * ephemeral transaction properties. 705 * 706 * @since New in 1.8. 707 */ 708 #define SVN_PROP_REVISION_PREFIX SVN_PROP_PREFIX "revision-" 709 710 711 /** @} */ 712 713 /** @} */ 714 715 716 717 #ifdef __cplusplus 718 } 719 #endif /* __cplusplus */ 720 721 #endif /* SVN_PROPS_H */ 722