Subversion
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
svn_types.h
Go to the documentation of this file.
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_types.h
24  * @brief Subversion's data types
25  */
26 
27 #ifndef SVN_TYPES_H
28 #define SVN_TYPES_H
29 
30 /* ### this should go away, but it causes too much breakage right now */
31 #include <stdlib.h>
32 
33 #include <apr.h> /* for apr_size_t, apr_int64_t, ... */
34 #include <apr_errno.h> /* for apr_status_t */
35 #include <apr_pools.h> /* for apr_pool_t */
36 #include <apr_hash.h> /* for apr_hash_t */
37 #include <apr_tables.h> /* for apr_array_push() */
38 #include <apr_time.h> /* for apr_time_t */
39 #include <apr_strings.h> /* for apr_atoi64() */
40 
41 #ifdef __cplusplus
42 extern "C" {
43 #endif /* __cplusplus */
44 
45 
46 
47 /** Macro used to mark deprecated functions.
48  *
49  * @since New in 1.6.
50  */
51 #ifndef SVN_DEPRECATED
52 # if !defined(SWIGPERL) && !defined(SWIGPYTHON) && !defined(SWIGRUBY)
53 # if defined(__GNUC__) && (__GNUC__ >= 4 || (__GNUC__==3 && __GNUC_MINOR__>=1))
54 # define SVN_DEPRECATED __attribute__((deprecated))
55 # elif defined(_MSC_VER) && _MSC_VER >= 1300
56 # define SVN_DEPRECATED __declspec(deprecated)
57 # else
58 # define SVN_DEPRECATED
59 # endif
60 # else
61 # define SVN_DEPRECATED
62 # endif
63 #endif
64 
65 
66 /** Indicate whether the current platform supports unaligned data access.
67  *
68  * On the majority of machines running SVN (x86 / x64), unaligned access
69  * is much cheaper than repeated aligned access. Define this macro to 1
70  * on those machines.
71  * Unaligned access on other machines (e.g. IA64) will trigger memory
72  * access faults or simply misbehave.
73  *
74  * @since New in 1.7.
75  */
76 #ifndef SVN_UNALIGNED_ACCESS_IS_OK
77 # if defined(_M_IX86) || defined(_M_X64) || defined(i386) || defined(__x86_64)
78 # define SVN_UNALIGNED_ACCESS_IS_OK 1
79 # else
80 # define SVN_UNALIGNED_ACCESS_IS_OK 0
81 # endif
82 #endif
83 
84 
85 /** Subversion error object.
86  *
87  * Defined here, rather than in svn_error.h, to avoid a recursive @#include
88  * situation.
89  */
90 typedef struct svn_error_t
91 {
92  /** APR error value; possibly an SVN_ custom error code (see
93  * `svn_error_codes.h' for a full listing).
94  */
95  apr_status_t apr_err;
96 
97  /** Details from the producer of error.
98  *
99  * Note that if this error was generated by Subversion's API, you'll
100  * probably want to use svn_err_best_message() to get a single
101  * descriptive string for this error chain (see the @a child member)
102  * or svn_handle_error2() to print the error chain in full. This is
103  * because Subversion's API functions sometimes add many links to
104  * the error chain that lack details (used only to produce virtual
105  * stack traces). (Use svn_error_purge_tracing() to remove those
106  * trace-only links from the error chain.)
107  */
108  const char *message;
109 
110  /** Pointer to the error we "wrap" (may be @c NULL). Via this
111  * member, individual error object can be strung together into an
112  * "error chain".
113  */
115 
116  /** The pool in which this error object is allocated. (If
117  * Subversion's APIs are used to manage error chains, then this pool
118  * will contain the whole error chain of which this object is a
119  * member.) */
120  apr_pool_t *pool;
121 
122  /** Source file where the error originated (iff @c SVN_DEBUG;
123  * undefined otherwise).
124  */
125  const char *file;
126 
127  /** Source line where the error originated (iff @c SVN_DEBUG;
128  * undefined otherwise).
129  */
130  long line;
131 
132 } svn_error_t;
133 
134 /* See svn_version.h.
135  Defined here to avoid including svn_version.h from all public headers. */
136 typedef struct svn_version_t svn_version_t;
137 
138 /** @defgroup APR_ARRAY_compat_macros APR Array Compatibility Helper Macros
139  * These macros are provided by APR itself from version 1.3.
140  * Definitions are provided here for when using older versions of APR.
141  * @{
142  */
143 
144 /** index into an apr_array_header_t */
145 #ifndef APR_ARRAY_IDX
146 #define APR_ARRAY_IDX(ary,i,type) (((type *)(ary)->elts)[i])
147 #endif
148 
149 /** easier array-pushing syntax */
150 #ifndef APR_ARRAY_PUSH
151 #define APR_ARRAY_PUSH(ary,type) (*((type *)apr_array_push(ary)))
152 #endif
153 
154 /** @} */
155 
156 /** @defgroup apr_hash_utilities APR Hash Table Helpers
157  * These functions enable the caller to dereference an APR hash table index
158  * without type casts or temporary variables.
159  *
160  * ### These are private, and may go away when APR implements them natively.
161  * @{
162  */
163 
164 /** Return the key of the hash table entry indexed by @a hi. */
165 const void *
166 svn__apr_hash_index_key(const apr_hash_index_t *hi);
167 
168 /** Return the key length of the hash table entry indexed by @a hi. */
169 apr_ssize_t
170 svn__apr_hash_index_klen(const apr_hash_index_t *hi);
171 
172 /** Return the value of the hash table entry indexed by @a hi. */
173 void *
174 svn__apr_hash_index_val(const apr_hash_index_t *hi);
175 
176 /** On Windows, APR_STATUS_IS_ENOTDIR includes several kinds of
177  * invalid-pathname error but not ERROR_INVALID_NAME, so we include it.
178  * We also include ERROR_DIRECTORY as that was not included in apr versions
179  * before 1.4.0 and this fix is not backported */
180 /* ### These fixes should go into APR. */
181 #ifndef WIN32
182 #define SVN__APR_STATUS_IS_ENOTDIR(s) APR_STATUS_IS_ENOTDIR(s)
183 #else
184 #define SVN__APR_STATUS_IS_ENOTDIR(s) (APR_STATUS_IS_ENOTDIR(s) \
185  || ((s) == APR_OS_START_SYSERR + ERROR_DIRECTORY) \
186  || ((s) == APR_OS_START_SYSERR + ERROR_INVALID_NAME))
187 #endif
188 
189 /** @} */
190 
191 /** The various types of nodes in the Subversion filesystem. */
192 typedef enum svn_node_kind_t
193 {
194  /** absent */
196 
197  /** regular file */
199 
200  /** directory */
202 
203  /** something's here, but we don't know what */
206 
207 /** Return a constant string expressing @a kind as an English word, e.g.,
208  * "file", "dir", etc. The string is not localized, as it may be used for
209  * client<->server communications. If the kind is not recognized, return
210  * "unknown".
211  *
212  * @since New in 1.6.
213  */
214 const char *
216 
217 /** Return the appropriate node_kind for @a word. @a word is as
218  * returned from svn_node_kind_to_word(). If @a word does not
219  * represent a recognized kind or is @c NULL, return #svn_node_unknown.
220  *
221  * @since New in 1.6.
222  */
224 svn_node_kind_from_word(const char *word);
225 
226 /** Generic three-state property to represent an unknown value for values
227  * that are just like booleans. The values have been set deliberately to
228  * make tristates disjoint from #svn_boolean_t.
229  *
230  * @note It is unsafe to use apr_pcalloc() to allocate these, since '0' is
231  * not a valid value.
232  *
233  * @since New in 1.7. */
234 typedef enum svn_tristate_t
235 {
236  svn_tristate_false = 2,
237  svn_tristate_true,
238  svn_tristate_unknown
240 
241 /** Return a constant string "true", "false" or NULL representing the value of
242  * @a tristate.
243  *
244  * @since New in 1.7.
245  */
246 const char *
248 
249 /** Return the appropriate tristate for @a word. If @a word is "true", returns
250  * #svn_tristate_true; if @a word is "false", returns #svn_tristate_false,
251  * for all other values (including NULL) returns #svn_tristate_unknown.
252  *
253  * @since New in 1.7.
254  */
256 svn_tristate__from_word(const char * word);
257 
258 
259 /** About Special Files in Subversion
260  *
261  * Subversion denotes files that cannot be portably created or
262  * modified as "special" files (svn_node_special). It stores these
263  * files in the repository as a plain text file with the svn:special
264  * property set. The file contents contain: a platform-specific type
265  * string, a space character, then any information necessary to create
266  * the file on a supported platform. For example, if a symbolic link
267  * were being represented, the repository file would have the
268  * following contents:
269  *
270  * "link /path/to/link/target"
271  *
272  * Where 'link' is the identifier string showing that this special
273  * file should be a symbolic link and '/path/to/link/target' is the
274  * destination of the symbolic link.
275  *
276  * Special files are stored in the text-base exactly as they are
277  * stored in the repository. The platform specific files are created
278  * in the working copy at EOL/keyword translation time using
279  * svn_subst_copy_and_translate2(). If the current platform does not
280  * support a specific special file type, the file is copied into the
281  * working copy as it is seen in the repository. Because of this,
282  * users of other platforms can still view and modify the special
283  * files, even if they do not have their unique properties.
284  *
285  * New types of special files can be added by:
286  * 1. Implementing a platform-dependent routine to create a uniquely
287  * named special file and one to read the special file in
288  * libsvn_subr/io.c.
289  * 2. Creating a new textual name similar to
290  * SVN_SUBST__SPECIAL_LINK_STR in libsvn_subr/subst.c.
291  * 3. Handling the translation/detranslation case for the new type in
292  * create_special_file and detranslate_special_file, using the
293  * routines from 1.
294  */
295 
296 /** A revision number. */
297 typedef long int svn_revnum_t;
298 
299 /** Valid revision numbers begin at 0 */
300 #define SVN_IS_VALID_REVNUM(n) ((n) >= 0)
301 
302 /** The 'official' invalid revision num */
303 #define SVN_INVALID_REVNUM ((svn_revnum_t) -1)
304 
305 /** Not really invalid...just unimportant -- one day, this can be its
306  * own unique value, for now, just make it the same as
307  * #SVN_INVALID_REVNUM.
308  */
309 #define SVN_IGNORED_REVNUM ((svn_revnum_t) -1)
310 
311 /** Convert NULL-terminated C string @a str to a revision number. */
312 #define SVN_STR_TO_REV(str) ((svn_revnum_t) atol(str))
313 
314 /**
315  * Parse NULL-terminated C string @a str as a revision number and
316  * store its value in @a rev. If @a endptr is non-NULL, then the
317  * address of the first non-numeric character in @a str is stored in
318  * it. If there are no digits in @a str, then @a endptr is set (if
319  * non-NULL), and the error #SVN_ERR_REVNUM_PARSE_FAILURE error is
320  * returned. Negative numbers parsed from @a str are considered
321  * invalid, and result in the same error.
322  *
323  * @since New in 1.5.
324  */
325 svn_error_t *
326 svn_revnum_parse(svn_revnum_t *rev,
327  const char *str,
328  const char **endptr);
329 
330 /** Originally intended to be used in printf()-style functions to format
331  * revision numbers. Deprecated due to incompatibilities with language
332  * translation tools (e.g. gettext).
333  *
334  * New code should use a bare "%ld" format specifier for formatting revision
335  * numbers.
336  *
337  * @deprecated Provided for backward compatibility with the 1.0 API.
338  */
339 #define SVN_REVNUM_T_FMT "ld"
340 
341 
342 /** The size of a file in the Subversion FS. */
343 typedef apr_int64_t svn_filesize_t;
344 
345 /** The 'official' invalid file size constant. */
346 #define SVN_INVALID_FILESIZE ((svn_filesize_t) -1)
347 
348 /** In printf()-style functions, format file sizes using this. */
349 #define SVN_FILESIZE_T_FMT APR_INT64_T_FMT
350 
351 #ifndef DOXYGEN_SHOULD_SKIP_THIS
352 /* Parse a base-10 numeric string into a 64-bit unsigned numeric value. */
353 /* NOTE: Private. For use by Subversion's own code only. See issue #1644. */
354 /* FIXME: APR should supply a function to do this, such as "apr_atoui64". */
355 #define svn__atoui64(X) ((apr_uint64_t) apr_atoi64(X))
356 #endif
357 
358 
359 /** YABT: Yet Another Boolean Type */
360 typedef int svn_boolean_t;
361 
362 #ifndef TRUE
363 /** uhh... true */
364 #define TRUE 1
365 #endif /* TRUE */
366 
367 #ifndef FALSE
368 /** uhh... false */
369 #define FALSE 0
370 #endif /* FALSE */
371 
372 
373 /** An enum to indicate whether recursion is needed. */
375 {
376  svn_nonrecursive = 1,
377  svn_recursive
378 };
379 
380 /** The concept of depth for directories.
381  *
382  * @note This is similar to, but not exactly the same as, the WebDAV
383  * and LDAP concepts of depth.
384  *
385  * @since New in 1.5.
386  */
387 typedef enum svn_depth_t
388 {
389  /* The order of these depths is important: the higher the number,
390  the deeper it descends. This allows us to compare two depths
391  numerically to decide which should govern. */
392 
393  /** Depth undetermined or ignored. In some contexts, this means the
394  client should choose an appropriate default depth. The server
395  will generally treat it as #svn_depth_infinity. */
397 
398  /** Exclude (i.e., don't descend into) directory D.
399  @note In Subversion 1.5, svn_depth_exclude is *not* supported
400  anywhere in the client-side (libsvn_wc/libsvn_client/etc) code;
401  it is only supported as an argument to set_path functions in the
402  ra and repos reporters. (This will enable future versions of
403  Subversion to run updates, etc, against 1.5 servers with proper
404  svn_depth_exclude behavior, once we get a chance to implement
405  client-side support for svn_depth_exclude.)
406  */
408 
409  /** Just the named directory D, no entries. Updates will not pull in
410  any files or subdirectories not already present. */
412 
413  /** D + its file children, but not subdirs. Updates will pull in any
414  files not already present, but not subdirectories. */
416 
417  /** D + immediate children (D and its entries). Updates will pull in
418  any files or subdirectories not already present; those
419  subdirectories' this_dir entries will have depth-empty. */
421 
422  /** D + all descendants (full recursion from D). Updates will pull
423  in any files or subdirectories not already present; those
424  subdirectories' this_dir entries will have depth-infinity.
425  Equivalent to the pre-1.5 default update behavior. */
427 
428 } svn_depth_t;
429 
430 
431 /** Return a constant string expressing @a depth as an English word,
432  * e.g., "infinity", "immediates", etc. The string is not localized,
433  * as it may be used for client<->server communications.
434  *
435  * @since New in 1.5.
436  */
437 const char *
439 
440 
441 /** Return the appropriate depth for @a depth_str. @a word is as
442  * returned from svn_depth_to_word(). If @a depth_str does not
443  * represent a recognized depth, return #svn_depth_unknown.
444  *
445  * @since New in 1.5.
446  */
448 svn_depth_from_word(const char *word);
449 
450 
451 /* Return #svn_depth_infinity if boolean @a recurse is TRUE, else
452  * return #svn_depth_files.
453  *
454  * @note New code should never need to use this, it is called only
455  * from pre-depth APIs, for compatibility.
456  *
457  * @since New in 1.5.
458  */
459 #define SVN_DEPTH_INFINITY_OR_FILES(recurse) \
460  ((recurse) ? svn_depth_infinity : svn_depth_files)
461 
462 
463 /* Return #svn_depth_infinity if boolean @a recurse is TRUE, else
464  * return #svn_depth_immediates.
465  *
466  * @note New code should never need to use this, it is called only
467  * from pre-depth APIs, for compatibility.
468  *
469  * @since New in 1.5.
470  */
471 #define SVN_DEPTH_INFINITY_OR_IMMEDIATES(recurse) \
472  ((recurse) ? svn_depth_infinity : svn_depth_immediates)
473 
474 
475 /* Return #svn_depth_infinity if boolean @a recurse is TRUE, else
476  * return #svn_depth_empty.
477  *
478  * @note New code should never need to use this, it is called only
479  * from pre-depth APIs, for compatibility.
480  *
481  * @since New in 1.5.
482  */
483 #define SVN_DEPTH_INFINITY_OR_EMPTY(recurse) \
484  ((recurse) ? svn_depth_infinity : svn_depth_empty)
485 
486 
487 /* Return a recursion boolean based on @a depth.
488  *
489  * Although much code has been converted to use depth, some code still
490  * takes a recurse boolean. In most cases, it makes sense to treat
491  * unknown or infinite depth as recursive, and any other depth as
492  * non-recursive (which in turn usually translates to #svn_depth_files).
493  */
494 #define SVN_DEPTH_IS_RECURSIVE(depth) \
495  (((depth) == svn_depth_infinity || (depth) == svn_depth_unknown) \
496  ? TRUE : FALSE)
497 
498 
499 /**
500  * It is sometimes convenient to indicate which parts of an #svn_dirent_t
501  * object you are actually interested in, so that calculating and sending
502  * the data corresponding to the other fields can be avoided. These values
503  * can be used for that purpose.
504  *
505  * @defgroup svn_dirent_fields Dirent fields
506  * @{
507  */
508 
509 /** An indication that you are interested in the @c kind field */
510 #define SVN_DIRENT_KIND 0x00001
511 
512 /** An indication that you are interested in the @c size field */
513 #define SVN_DIRENT_SIZE 0x00002
514 
515 /** An indication that you are interested in the @c has_props field */
516 #define SVN_DIRENT_HAS_PROPS 0x00004
517 
518 /** An indication that you are interested in the @c created_rev field */
519 #define SVN_DIRENT_CREATED_REV 0x00008
520 
521 /** An indication that you are interested in the @c time field */
522 #define SVN_DIRENT_TIME 0x00010
523 
524 /** An indication that you are interested in the @c last_author field */
525 #define SVN_DIRENT_LAST_AUTHOR 0x00020
526 
527 /** A combination of all the dirent fields */
528 #define SVN_DIRENT_ALL ~((apr_uint32_t ) 0)
529 
530 /** @} */
531 
532 /** A general subversion directory entry. */
533 typedef struct svn_dirent_t
534 {
535  /** node kind */
537 
538  /** length of file text, or 0 for directories */
539  svn_filesize_t size;
540 
541  /** does the node have props? */
542  svn_boolean_t has_props;
543 
544  /** last rev in which this node changed */
545  svn_revnum_t created_rev;
546 
547  /** time of created_rev (mod-time) */
548  apr_time_t time;
549 
550  /** author of created_rev */
551  const char *last_author;
552 
553  /* IMPORTANT: If you extend this struct, check svn_dirent_dup(). */
554 } svn_dirent_t;
555 
556 
557 /** Return a deep copy of @a dirent, allocated in @a pool.
558  *
559  * @since New in 1.4.
560  */
561 svn_dirent_t *
562 svn_dirent_dup(const svn_dirent_t *dirent,
563  apr_pool_t *pool);
564 
565 
566 
567 /** Keyword substitution.
568  *
569  * All the keywords Subversion recognizes.
570  *
571  * Note that there is a better, more general proposal out there, which
572  * would take care of both internationalization issues and custom
573  * keywords (e.g., $NetBSD$). See
574  *
575  * @verbatim
576  http://subversion.tigris.org/servlets/ReadMsg?list=dev&msgNo=8921
577  =====
578  From: "Jonathan M. Manning" <jmanning@alisa-jon.net>
579  To: dev@subversion.tigris.org
580  Date: Fri, 14 Dec 2001 11:56:54 -0500
581  Message-ID: <87970000.1008349014@bdldevel.bl.bdx.com>
582  Subject: Re: keywords @endverbatim
583  *
584  * and Eric Gillespie's support of same:
585  *
586  * @verbatim
587  http://subversion.tigris.org/servlets/ReadMsg?list=dev&msgNo=8757
588  =====
589  From: "Eric Gillespie, Jr." <epg@pretzelnet.org>
590  To: dev@subversion.tigris.org
591  Date: Wed, 12 Dec 2001 09:48:42 -0500
592  Message-ID: <87k7vsebp1.fsf@vger.pretzelnet.org>
593  Subject: Re: Customizable Keywords @endverbatim
594  *
595  * However, it is considerably more complex than the scheme below.
596  * For now we're going with simplicity, hopefully the more general
597  * solution can be done post-1.0.
598  *
599  * @defgroup svn_types_keywords Keyword definitions
600  * @{
601  */
602 
603 /** The maximum size of an expanded or un-expanded keyword. */
604 #define SVN_KEYWORD_MAX_LEN 255
605 
606 /** The most recent revision in which this file was changed. */
607 #define SVN_KEYWORD_REVISION_LONG "LastChangedRevision"
608 
609 /** Short version of LastChangedRevision */
610 #define SVN_KEYWORD_REVISION_SHORT "Rev"
611 
612 /** Medium version of LastChangedRevision, matching the one CVS uses.
613  * @since New in 1.1. */
614 #define SVN_KEYWORD_REVISION_MEDIUM "Revision"
615 
616 /** The most recent date (repository time) when this file was changed. */
617 #define SVN_KEYWORD_DATE_LONG "LastChangedDate"
618 
619 /** Short version of LastChangedDate */
620 #define SVN_KEYWORD_DATE_SHORT "Date"
621 
622 /** Who most recently committed to this file. */
623 #define SVN_KEYWORD_AUTHOR_LONG "LastChangedBy"
624 
625 /** Short version of LastChangedBy */
626 #define SVN_KEYWORD_AUTHOR_SHORT "Author"
627 
628 /** The URL for the head revision of this file. */
629 #define SVN_KEYWORD_URL_LONG "HeadURL"
630 
631 /** Short version of HeadURL */
632 #define SVN_KEYWORD_URL_SHORT "URL"
633 
634 /** A compressed combination of the other four keywords. */
635 #define SVN_KEYWORD_ID "Id"
636 
637 /** A full combination of the first four keywords.
638  * @since New in 1.6. */
639 #define SVN_KEYWORD_HEADER "Header"
640 
641 /** @} */
642 
643 
644 /** All information about a commit.
645  *
646  * @note Objects of this type should always be created using the
647  * svn_create_commit_info() function.
648  *
649  * @since New in 1.3.
650  */
651 typedef struct svn_commit_info_t
652 {
653  /** just-committed revision. */
654  svn_revnum_t revision;
655 
656  /** server-side date of the commit. */
657  const char *date;
658 
659  /** author of the commit. */
660  const char *author;
661 
662  /** error message from post-commit hook, or NULL. */
663  const char *post_commit_err;
664 
665  /** repository root, may be @c NULL if unknown.
666  @since New in 1.7. */
667  const char *repos_root;
668 
670 
671 
672 /**
673  * Allocate an object of type #svn_commit_info_t in @a pool and
674  * return it.
675  *
676  * The @c revision field of the new struct is set to #SVN_INVALID_REVNUM.
677  * All other fields are initialized to @c NULL.
678  *
679  * @note Any object of the type #svn_commit_info_t should
680  * be created using this function.
681  * This is to provide for extending the svn_commit_info_t in
682  * the future.
683  *
684  * @since New in 1.3.
685  */
687 svn_create_commit_info(apr_pool_t *pool);
688 
689 
690 /**
691  * Return a deep copy @a src_commit_info allocated in @a pool.
692  *
693  * @since New in 1.4.
694  */
696 svn_commit_info_dup(const svn_commit_info_t *src_commit_info,
697  apr_pool_t *pool);
698 
699 
700 /**
701  * A structure to represent a path that changed for a log entry.
702  *
703  * @note To allow for extending the #svn_log_changed_path2_t structure in
704  * future releases, always use svn_log_changed_path2_create() to allocate
705  * the structure.
706  *
707  * @since New in 1.6.
708  */
710 {
711  /** 'A'dd, 'D'elete, 'R'eplace, 'M'odify */
712  char action;
713 
714  /** Source path of copy (if any). */
715  const char *copyfrom_path;
716 
717  /** Source revision of copy (if any). */
718  svn_revnum_t copyfrom_rev;
719 
720  /** The type of the node, may be svn_node_unknown. */
722 
723  /** Is the text modified, may be svn_tristate_unknown.
724  * @since New in 1.7. */
726 
727  /** Are properties modified, may be svn_tristate_unknown.
728  * @since New in 1.7. */
730 
731  /* NOTE: Add new fields at the end to preserve binary compatibility.
732  Also, if you add fields here, you have to update
733  svn_log_changed_path2_dup(). */
735 
736 /**
737  * Returns an #svn_log_changed_path2_t, allocated in @a pool with all fields
738  * initialized to NULL, None or empty values.
739  *
740  * @note To allow for extending the #svn_log_changed_path2_t structure in
741  * future releases, this function should always be used to allocate the
742  * structure.
743  *
744  * @since New in 1.6.
745  */
747 svn_log_changed_path2_create(apr_pool_t *pool);
748 
749 /**
750  * Return a deep copy of @a changed_path, allocated in @a pool.
751  *
752  * @since New in 1.6.
753  */
756  apr_pool_t *pool);
757 
758 /**
759  * A structure to represent a path that changed for a log entry. Same as
760  * #svn_log_changed_path2_t, but without the node kind.
761  *
762  * @deprecated Provided for backward compatibility with the 1.5 API.
763  */
765 {
766  /** 'A'dd, 'D'elete, 'R'eplace, 'M'odify */
767  char action;
768 
769  /** Source path of copy (if any). */
770  const char *copyfrom_path;
771 
772  /** Source revision of copy (if any). */
773  svn_revnum_t copyfrom_rev;
774 
776 
777 
778 /**
779  * Return a deep copy of @a changed_path, allocated in @a pool.
780  *
781  * @since New in 1.3.
782  * @deprecated Provided for backward compatibility with the 1.5 API.
783  */
787  apr_pool_t *pool);
788 
789 /**
790  * A structure to represent all the information about a particular log entry.
791  *
792  * @note To allow for extending the #svn_log_entry_t structure in future
793  * releases, always use svn_log_entry_create() to allocate the structure.
794  *
795  * @since New in 1.5.
796  */
797 typedef struct svn_log_entry_t
798 {
799  /** A hash containing as keys every path committed in @a revision; the
800  * values are (#svn_log_changed_path_t *) structures.
801  *
802  * The subversion core libraries will always set this field to the same
803  * value as changed_paths2 for compatibility reasons.
804  *
805  * @deprecated Provided for backward compatibility with the 1.5 API.
806  */
807  apr_hash_t *changed_paths;
808 
809  /** The revision of the commit. */
810  svn_revnum_t revision;
811 
812  /** The hash of requested revision properties, which may be NULL if it
813  * would contain no revprops. */
814  apr_hash_t *revprops;
815 
816  /**
817  * Whether or not this message has children.
818  *
819  * When a log operation requests additional merge information, extra log
820  * entries may be returned as a result of this entry. The new entries, are
821  * considered children of the original entry, and will follow it. When
822  * the HAS_CHILDREN flag is set, the receiver should increment its stack
823  * depth, and wait until an entry is provided with SVN_INVALID_REVNUM which
824  * indicates the end of the children.
825  *
826  * For log operations which do not request additional merge information, the
827  * HAS_CHILDREN flag is always FALSE.
828  *
829  * For more information see:
830  * https://svn.apache.org/repos/asf/subversion/trunk/notes/merge-tracking/design.html#commutative-reporting
831  */
832  svn_boolean_t has_children;
833 
834  /** A hash containing as keys every path committed in @a revision; the
835  * values are (#svn_log_changed_path2_t *) structures.
836  *
837  * If this value is not @c NULL, it MUST have the same value as
838  * changed_paths or svn_log_entry_dup() will not create an identical copy.
839  *
840  * The subversion core libraries will always set this field to the same
841  * value as changed_paths for compatibility with users assuming an older
842  * version.
843  *
844  * @note See http://svn.haxx.se/dev/archive-2010-08/0362.shtml for
845  * further explanation.
846  *
847  * @since New in 1.6.
848  */
849  apr_hash_t *changed_paths2;
850 
851  /**
852  * Whether @a revision should be interpreted as non-inheritable in the
853  * same sense of #svn_merge_range_t.
854  *
855  * @since New in 1.7.
856  */
857  svn_boolean_t non_inheritable;
858 
859  /**
860  * Whether @a revision is a merged revision resulting from a reverse merge.
861  *
862  * @since New in 1.7.
863  */
864  svn_boolean_t subtractive_merge;
865 
866  /* NOTE: Add new fields at the end to preserve binary compatibility.
867  Also, if you add fields here, you have to update
868  svn_log_entry_dup(). */
870 
871 /**
872  * Returns an #svn_log_entry_t, allocated in @a pool with all fields
873  * initialized to NULL values.
874  *
875  * @note To allow for extending the #svn_log_entry_t structure in future
876  * releases, this function should always be used to allocate the structure.
877  *
878  * @since New in 1.5.
879  */
881 svn_log_entry_create(apr_pool_t *pool);
882 
883 /** Return a deep copy of @a log_entry, allocated in @a pool.
884  *
885  * The resulting svn_log_entry_t has @c changed_paths set to the same
886  * value as @c changed_path2. @c changed_paths will be @c NULL if
887  * @c changed_paths2 was @c NULL.
888  *
889  * @since New in 1.6.
890  */
892 svn_log_entry_dup(const svn_log_entry_t *log_entry, apr_pool_t *pool);
893 
894 /** The callback invoked by log message loopers, such as
895  * #svn_ra_plugin_t.get_log() and svn_repos_get_logs().
896  *
897  * This function is invoked once on each log message, in the order
898  * determined by the caller (see above-mentioned functions).
899  *
900  * @a baton is what you think it is, and @a log_entry contains relevant
901  * information for the log message. Any of @a log_entry->author,
902  * @a log_entry->date, or @a log_entry->message may be @c NULL.
903  *
904  * If @a log_entry->date is neither NULL nor the empty string, it was
905  * generated by svn_time_to_cstring() and can be converted to
906  * @c apr_time_t with svn_time_from_cstring().
907  *
908  * If @a log_entry->changed_paths is non-@c NULL, then it contains as keys
909  * every path committed in @a log_entry->revision; the values are
910  * (#svn_log_changed_path_t *) structures.
911  *
912  * If @a log_entry->has_children is @c TRUE, the message will be followed
913  * immediately by any number of merged revisions (child messages), which are
914  * terminated by an invocation with SVN_INVALID_REVNUM. This usage may
915  * be recursive.
916  *
917  * Use @a pool for temporary allocation. If the caller is iterating
918  * over log messages, invoking this receiver on each, we recommend the
919  * standard pool loop recipe: create a subpool, pass it as @a pool to
920  * each call, clear it after each iteration, destroy it after the loop
921  * is done. (For allocation that must last beyond the lifetime of a
922  * given receiver call, use a pool in @a baton.)
923  *
924  * @since New in 1.5.
925  */
926 
927 typedef svn_error_t *(*svn_log_entry_receiver_t)(
928  void *baton,
929  svn_log_entry_t *log_entry,
930  apr_pool_t *pool);
931 
932 /**
933  * Similar to #svn_log_entry_receiver_t, except this uses separate
934  * parameters for each part of the log entry.
935  *
936  * @deprecated Provided for backward compatibility with the 1.4 API.
937  */
938 typedef svn_error_t *(*svn_log_message_receiver_t)(
939  void *baton,
940  apr_hash_t *changed_paths,
941  svn_revnum_t revision,
942  const char *author,
943  const char *date, /* use svn_time_from_cstring() if need apr_time_t */
944  const char *message,
945  apr_pool_t *pool);
946 
947 
948 /** Callback function type for commits.
949  *
950  * When a commit succeeds, an instance of this is invoked with the
951  * @a commit_info, along with the @a baton closure.
952  * @a pool can be used for temporary allocations.
953  *
954  * @since New in 1.4.
955  */
956 typedef svn_error_t *(*svn_commit_callback2_t)(
957  const svn_commit_info_t *commit_info,
958  void *baton,
959  apr_pool_t *pool);
960 
961 /** Same as #svn_commit_callback2_t, but uses individual
962  * data elements instead of the #svn_commit_info_t structure
963  *
964  * @deprecated Provided for backward compatibility with the 1.3 API.
965  */
966 typedef svn_error_t *(*svn_commit_callback_t)(
967  svn_revnum_t new_revision,
968  const char *date,
969  const char *author,
970  void *baton);
971 
972 
973 /** A buffer size that may be used when processing a stream of data.
974  *
975  * @note We don't use this constant any longer, since it is considered to be
976  * unnecessarily large.
977  *
978  * @deprecated Provided for backwards compatibility with the 1.3 API.
979  */
980 #define SVN_STREAM_CHUNK_SIZE 102400
981 
982 #ifndef DOXYGEN_SHOULD_SKIP_THIS
983 /*
984  * The maximum amount we (ideally) hold in memory at a time when
985  * processing a stream of data.
986  *
987  * For example, when copying data from one stream to another, do it in
988  * blocks of this size.
989  *
990  * NOTE: This is an internal macro, put here for convenience.
991  * No public API may depend on the particular value of this macro.
992  */
993 #define SVN__STREAM_CHUNK_SIZE 16384
994 #endif
995 
996 /** The maximum amount we can ever hold in memory. */
997 /* FIXME: Should this be the same as SVN_STREAM_CHUNK_SIZE? */
998 #define SVN_MAX_OBJECT_SIZE (((apr_size_t) -1) / 2)
999 
1000 
1001 
1002 /* ### Note: despite being about mime-TYPES, these probably don't
1003  * ### belong in svn_types.h. However, no other header is more
1004  * ### appropriate, and didn't feel like creating svn_validate.h for
1005  * ### so little.
1006  */
1007 
1008 /** Validate @a mime_type.
1009  *
1010  * If @a mime_type does not contain a "/", or ends with non-alphanumeric
1011  * data, return #SVN_ERR_BAD_MIME_TYPE, else return success.
1012  *
1013  * Use @a pool only to find error allocation.
1014  *
1015  * Goal: to match both "foo/bar" and "foo/bar; charset=blah", without
1016  * being too strict about it, but to disallow mime types that have
1017  * quotes, newlines, or other garbage on the end, such as might be
1018  * unsafe in an HTTP header.
1019  */
1020 svn_error_t *
1021 svn_mime_type_validate(const char *mime_type,
1022  apr_pool_t *pool);
1023 
1024 
1025 /** Return FALSE iff @a mime_type is a textual type.
1026  *
1027  * All mime types that start with "text/" are textual, plus some special
1028  * cases (for example, "image/x-xbitmap").
1029  */
1030 svn_boolean_t
1031 svn_mime_type_is_binary(const char *mime_type);
1032 
1033 
1034 
1035 /** A user defined callback that subversion will call with a user defined
1036  * baton to see if the current operation should be continued. If the operation
1037  * should continue, the function should return #SVN_NO_ERROR, if not, it
1038  * should return #SVN_ERR_CANCELLED.
1039  */
1040 typedef svn_error_t *(*svn_cancel_func_t)(void *cancel_baton);
1041 
1042 
1043 
1044 /**
1045  * A lock object, for client & server to share.
1046  *
1047  * A lock represents the exclusive right to add, delete, or modify a
1048  * path. A lock is created in a repository, wholly controlled by the
1049  * repository. A "lock-token" is the lock's UUID, and can be used to
1050  * learn more about a lock's fields, and or/make use of the lock.
1051  * Because a lock is immutable, a client is free to not only cache the
1052  * lock-token, but the lock's fields too, for convenience.
1053  *
1054  * Note that the 'is_dav_comment' field is wholly ignored by every
1055  * library except for mod_dav_svn. The field isn't even marshalled
1056  * over the network to the client. Assuming lock structures are
1057  * created with apr_pcalloc(), a default value of 0 is universally safe.
1058  *
1059  * @note in the current implementation, only files are lockable.
1060  *
1061  * @since New in 1.2.
1062  */
1063 typedef struct svn_lock_t
1064 {
1065  const char *path; /**< the path this lock applies to */
1066  const char *token; /**< unique URI representing lock */
1067  const char *owner; /**< the username which owns the lock */
1068  const char *comment; /**< (optional) description of lock */
1069  svn_boolean_t is_dav_comment; /**< was comment made by generic DAV client? */
1070  apr_time_t creation_date; /**< when lock was made */
1071  apr_time_t expiration_date; /**< (optional) when lock will expire;
1072  If value is 0, lock will never expire. */
1073 } svn_lock_t;
1074 
1075 /**
1076  * Returns an #svn_lock_t, allocated in @a pool with all fields initialized
1077  * to NULL values.
1078  *
1079  * @note To allow for extending the #svn_lock_t structure in the future
1080  * releases, this function should always be used to allocate the structure.
1081  *
1082  * @since New in 1.2.
1083  */
1084 svn_lock_t *
1085 svn_lock_create(apr_pool_t *pool);
1086 
1087 /**
1088  * Return a deep copy of @a lock, allocated in @a pool.
1089  *
1090  * @since New in 1.2.
1091  */
1092 svn_lock_t *
1093 svn_lock_dup(const svn_lock_t *lock, apr_pool_t *pool);
1094 
1095 /**
1096  * Return a formatted Universal Unique IDentifier (UUID) string.
1097  *
1098  * @since New in 1.4.
1099  */
1100 const char *
1101 svn_uuid_generate(apr_pool_t *pool);
1102 
1103 /**
1104  * Mergeinfo representing a merge of a range of revisions.
1105  *
1106  * @since New in 1.5
1107  */
1108 typedef struct svn_merge_range_t
1109 {
1110  /**
1111  * If the 'start' field is less than the 'end' field then 'start' is
1112  * exclusive and 'end' inclusive of the range described. This is termed
1113  * a forward merge range. If 'start' is greater than 'end' then the
1114  * opposite is true. This is termed a reverse merge range. If 'start'
1115  * equals 'end' the meaning of the range is not defined.
1116  */
1117  svn_revnum_t start;
1118  svn_revnum_t end;
1119 
1120  /**
1121  * Whether this merge range should be inherited by treewise
1122  * descendants of the path to which the range applies. */
1123  svn_boolean_t inheritable;
1125 
1126 /**
1127  * Return a copy of @a range, allocated in @a pool.
1128  *
1129  * @since New in 1.5.
1130  */
1132 svn_merge_range_dup(const svn_merge_range_t *range, apr_pool_t *pool);
1133 
1134 /**
1135  * Returns true if the changeset committed in revision @a rev is one
1136  * of the changesets in the range @a range.
1137  *
1138  * @since New in 1.5.
1139  */
1140 svn_boolean_t
1141 svn_merge_range_contains_rev(const svn_merge_range_t *range, svn_revnum_t rev);
1142 
1143 
1144 
1145 /** @defgroup node_location_seg_reporting Node location segment reporting.
1146  * @{ */
1147 
1148 /**
1149  * A representation of a segment of a object's version history with an
1150  * emphasis on the object's location in the repository as of various
1151  * revisions.
1152  *
1153  * @since New in 1.5.
1154  */
1156 {
1157  /** The beginning (oldest) and ending (youngest) revisions for this
1158  segment. */
1159  svn_revnum_t range_start;
1160  svn_revnum_t range_end;
1161 
1162  /** The absolute (sans leading slash) path for this segment. May be
1163  NULL to indicate gaps in an object's history. */
1164  const char *path;
1165 
1167 
1168 
1169 /**
1170  * A callback invoked by generators of #svn_location_segment_t
1171  * objects, used to report information about a versioned object's
1172  * history in terms of its location in the repository filesystem over
1173  * time.
1174  */
1175 typedef svn_error_t *(*svn_location_segment_receiver_t)(
1176  svn_location_segment_t *segment,
1177  void *baton,
1178  apr_pool_t *pool);
1179 
1180 
1181 /**
1182  * Return a deep copy of @a segment, allocated in @a pool.
1183  *
1184  * @since New in 1.5.
1185  */
1188  apr_pool_t *pool);
1189 
1190 /** @} */
1191 
1192 /** A line number, such as in a file or a stream.
1193  *
1194  * @since New in 1.7.
1195  */
1196 typedef unsigned long svn_linenum_t;
1197 
1198 /* The maximum value of an svn_linenum_t.
1199  *
1200  * @since New in 1.7.
1201  */
1202 #define SVN_LINENUM_MAX_VALUE ULONG_MAX
1203 
1204 
1205 #ifdef __cplusplus
1206 }
1207 #endif /* __cplusplus */
1208 
1209 
1210 /*
1211  * Everybody and their brother needs to deal with svn_error_t, the error
1212  * codes, and whatever else. While they *should* go and include svn_error.h
1213  * in order to do that... bah. Let's just help everybody out and include
1214  * that header whenever somebody grabs svn_types.h.
1215  *
1216  * Note that we do this at the END of this header so that its contents
1217  * are available to svn_error.h (our guards will prevent the circular
1218  * include). We also need to do the include *outside* of the cplusplus
1219  * guard.
1220  */
1221 #include "svn_error.h"
1222 
1223 
1224 /*
1225  * Subversion developers may want to use some additional debugging facilities
1226  * while working on the code. We'll pull that in here, so individual source
1227  * files don't have to include this header manually.
1228  */
1229 #ifdef SVN_DEBUG
1230 #include "private/svn_debug.h"
1231 #endif
1232 
1233 
1234 #endif /* SVN_TYPES_H */
struct svn_log_changed_path_t svn_log_changed_path_t
A structure to represent a path that changed for a log entry.
apr_hash_t * changed_paths
A hash containing as keys every path committed in revision; the values are (svn_log_changed_path_t *)...
Definition: svn_types.h:807
const char * post_commit_err
error message from post-commit hook, or NULL.
Definition: svn_types.h:663
char action
&#39;A&#39;dd, &#39;D&#39;elete, &#39;R&#39;eplace, &#39;M&#39;odify
Definition: svn_types.h:767
svn_commit_info_t * svn_commit_info_dup(const svn_commit_info_t *src_commit_info, apr_pool_t *pool)
Return a deep copy src_commit_info allocated in pool.
const char * author
author of the commit.
Definition: svn_types.h:660
const char * repos_root
repository root, may be NULL if unknown.
Definition: svn_types.h:667
svn_depth_t
The concept of depth for directories.
Definition: svn_types.h:387
svn_lock_t * svn_lock_dup(const svn_lock_t *lock, apr_pool_t *pool)
Return a deep copy of lock, allocated in pool.
svn_revnum_t created_rev
last rev in which this node changed
Definition: svn_types.h:545
const char * file
Source file where the error originated (iff SVN_DEBUG; undefined otherwise).
Definition: svn_types.h:125
svn_boolean_t svn_mime_type_is_binary(const char *mime_type)
Return FALSE iff mime_type is a textual type.
svn_revnum_t revision
just-committed revision.
Definition: svn_types.h:654
svn_log_changed_path2_t * svn_log_changed_path2_create(apr_pool_t *pool)
Returns an svn_log_changed_path2_t, allocated in pool with all fields initialized to NULL...
svn_tristate_t
Generic three-state property to represent an unknown value for values that are just like booleans...
Definition: svn_types.h:234
svn_error_t * svn_mime_type_validate(const char *mime_type, apr_pool_t *pool)
Validate mime_type.
svn_tristate_t text_modified
Is the text modified, may be svn_tristate_unknown.
Definition: svn_types.h:725
const char * last_author
author of created_rev
Definition: svn_types.h:551
struct svn_log_entry_t svn_log_entry_t
A structure to represent all the information about a particular log entry.
svn_commit_info_t * svn_create_commit_info(apr_pool_t *pool)
Allocate an object of type svn_commit_info_t in pool and return it.
All information about a commit.
Definition: svn_types.h:651
const char * token
unique URI representing lock
Definition: svn_types.h:1066
svn_boolean_t svn_merge_range_contains_rev(const svn_merge_range_t *range, svn_revnum_t rev)
Returns true if the changeset committed in revision rev is one of the changesets in the range range...
svn_recurse_kind
An enum to indicate whether recursion is needed.
Definition: svn_types.h:374
directory
Definition: svn_types.h:201
svn_node_kind_t node_kind
The type of the node, may be svn_node_unknown.
Definition: svn_types.h:721
svn_boolean_t is_dav_comment
was comment made by generic DAV client?
Definition: svn_types.h:1069
svn_node_kind_t kind
node kind
Definition: svn_types.h:536
svn_revnum_t range_start
The beginning (oldest) and ending (youngest) revisions for this segment.
Definition: svn_types.h:1159
svn_merge_range_t * svn_merge_range_dup(const svn_merge_range_t *range, apr_pool_t *pool)
Return a copy of range, allocated in pool.
svn_log_entry_t * svn_log_entry_dup(const svn_log_entry_t *log_entry, apr_pool_t *pool)
Return a deep copy of log_entry, allocated in pool.
svn_boolean_t has_props
does the node have props?
Definition: svn_types.h:542
D + all descendants (full recursion from D).
Definition: svn_types.h:426
Mergeinfo representing a merge of a range of revisions.
Definition: svn_types.h:1108
svn_depth_t svn_depth_from_word(const char *word)
Return the appropriate depth for depth_str.
struct svn_lock_t svn_lock_t
A lock object, for client &amp; server to share.
A lock object, for client &amp; server to share.
Definition: svn_types.h:1063
svn_filesize_t size
length of file text, or 0 for directories
Definition: svn_types.h:539
svn_log_changed_path_t * svn_log_changed_path_dup(const svn_log_changed_path_t *changed_path, apr_pool_t *pool)
Return a deep copy of changed_path, allocated in pool.
const char * comment
(optional) description of lock
Definition: svn_types.h:1068
svn_tristate_t svn_tristate__from_word(const char *word)
Return the appropriate tristate for word.
svn_location_segment_t * svn_location_segment_dup(const svn_location_segment_t *segment, apr_pool_t *pool)
Return a deep copy of segment, allocated in pool.
D + its file children, but not subdirs.
Definition: svn_types.h:415
svn_node_kind_t
The various types of nodes in the Subversion filesystem.
Definition: svn_types.h:192
apr_pool_t * pool
The pool in which this error object is allocated.
Definition: svn_types.h:120
apr_ssize_t svn__apr_hash_index_klen(const apr_hash_index_t *hi)
Return the key length of the hash table entry indexed by hi.
svn_log_entry_t * svn_log_entry_create(apr_pool_t *pool)
Returns an svn_log_entry_t, allocated in pool with all fields initialized to NULL values...
svn_node_kind_t svn_node_kind_from_word(const char *word)
Return the appropriate node_kind for word.
apr_time_t time
time of created_rev (mod-time)
Definition: svn_types.h:548
const char * message
Details from the producer of error.
Definition: svn_types.h:108
svn_tristate_t props_modified
Are properties modified, may be svn_tristate_unknown.
Definition: svn_types.h:729
Subversion error object.
Definition: svn_types.h:90
const char * svn_depth_to_word(svn_depth_t depth)
Return a constant string expressing depth as an English word, e.g., &quot;infinity&quot;, &quot;immediates&quot;, etc.
struct svn_error_t * child
Pointer to the error we &quot;wrap&quot; (may be NULL).
Definition: svn_types.h:114
const char * date
server-side date of the commit.
Definition: svn_types.h:657
svn_revnum_t revision
The revision of the commit.
Definition: svn_types.h:810
svn_boolean_t subtractive_merge
Whether revision is a merged revision resulting from a reverse merge.
Definition: svn_types.h:864
apr_status_t apr_err
APR error value; possibly an SVN_ custom error code (see `svn_error_codes.h&#39; for a full listing)...
Definition: svn_types.h:95
apr_int64_t svn_filesize_t
The size of a file in the Subversion FS.
Definition: svn_types.h:343
Depth undetermined or ignored.
Definition: svn_types.h:396
svn_dirent_t * svn_dirent_dup(const svn_dirent_t *dirent, apr_pool_t *pool)
Return a deep copy of dirent, allocated in pool.
svn_log_changed_path2_t * svn_log_changed_path2_dup(const svn_log_changed_path2_t *changed_path, apr_pool_t *pool)
Return a deep copy of changed_path, allocated in pool.
apr_hash_t * revprops
The hash of requested revision properties, which may be NULL if it would contain no revprops...
Definition: svn_types.h:814
A structure to represent a path that changed for a log entry.
Definition: svn_types.h:709
svn_boolean_t non_inheritable
Whether revision should be interpreted as non-inheritable in the same sense of svn_merge_range_t.
Definition: svn_types.h:857
svn_boolean_t inheritable
Whether this merge range should be inherited by treewise descendants of the path to which the range a...
Definition: svn_types.h:1123
unsigned long svn_linenum_t
A line number, such as in a file or a stream.
Definition: svn_types.h:1196
Version information.
Definition: svn_version.h:150
svn_error_t * svn_revnum_parse(svn_revnum_t *rev, const char *str, const char **endptr)
Parse NULL-terminated C string str as a revision number and store its value in rev.
const char * copyfrom_path
Source path of copy (if any).
Definition: svn_types.h:770
D + immediate children (D and its entries).
Definition: svn_types.h:420
const void * svn__apr_hash_index_key(const apr_hash_index_t *hi)
Return the key of the hash table entry indexed by hi.
A structure to represent a path that changed for a log entry.
Definition: svn_types.h:764
something&#39;s here, but we don&#39;t know what
Definition: svn_types.h:204
apr_hash_t * changed_paths2
A hash containing as keys every path committed in revision; the values are (svn_log_changed_path2_t *...
Definition: svn_types.h:849
svn_boolean_t has_children
Whether or not this message has children.
Definition: svn_types.h:832
const char * copyfrom_path
Source path of copy (if any).
Definition: svn_types.h:715
#define SVN_DEPRECATED
Macro used to mark deprecated functions.
Definition: svn_types.h:58
struct svn_merge_range_t svn_merge_range_t
Mergeinfo representing a merge of a range of revisions.
const char * path
The absolute (sans leading slash) path for this segment.
Definition: svn_types.h:1164
const char * svn_uuid_generate(apr_pool_t *pool)
Return a formatted Universal Unique IDentifier (UUID) string.
struct svn_log_changed_path2_t svn_log_changed_path2_t
A structure to represent a path that changed for a log entry.
regular file
Definition: svn_types.h:198
struct svn_dirent_t svn_dirent_t
A general subversion directory entry.
struct svn_error_t svn_error_t
Subversion error object.
A general subversion directory entry.
Definition: svn_types.h:533
Common exception handling for Subversion.
long line
Source line where the error originated (iff SVN_DEBUG; undefined otherwise).
Definition: svn_types.h:130
long int svn_revnum_t
About Special Files in Subversion.
Definition: svn_types.h:297
const char * path
the path this lock applies to
Definition: svn_types.h:1065
absent
Definition: svn_types.h:195
apr_time_t expiration_date
(optional) when lock will expire; If value is 0, lock will never expire.
Definition: svn_types.h:1071
void * svn__apr_hash_index_val(const apr_hash_index_t *hi)
Return the value of the hash table entry indexed by hi.
const char * owner
the username which owns the lock
Definition: svn_types.h:1067
char action
&#39;A&#39;dd, &#39;D&#39;elete, &#39;R&#39;eplace, &#39;M&#39;odify
Definition: svn_types.h:712
svn_lock_t * svn_lock_create(apr_pool_t *pool)
Returns an svn_lock_t, allocated in pool with all fields initialized to NULL values.
int svn_boolean_t
YABT: Yet Another Boolean Type.
Definition: svn_types.h:360
const char * svn_tristate__to_word(svn_tristate_t tristate)
Return a constant string &quot;true&quot;, &quot;false&quot; or NULL representing the value of tristate.
Just the named directory D, no entries.
Definition: svn_types.h:411
const char * svn_node_kind_to_word(svn_node_kind_t kind)
Return a constant string expressing kind as an English word, e.g., &quot;file&quot;, &quot;dir&quot;, etc...
svn_revnum_t copyfrom_rev
Source revision of copy (if any).
Definition: svn_types.h:718
Exclude (i.e., don&#39;t descend into) directory D.
Definition: svn_types.h:407
svn_revnum_t start
If the &#39;start&#39; field is less than the &#39;end&#39; field then &#39;start&#39; is exclusive and &#39;end&#39; inclusive of th...
Definition: svn_types.h:1117
svn_revnum_t copyfrom_rev
Source revision of copy (if any).
Definition: svn_types.h:773
struct svn_location_segment_t svn_location_segment_t
A representation of a segment of a object&#39;s version history with an emphasis on the object&#39;s location...
struct svn_commit_info_t svn_commit_info_t
All information about a commit.
A structure to represent all the information about a particular log entry.
Definition: svn_types.h:797
A representation of a segment of a object&#39;s version history with an emphasis on the object&#39;s location...
Definition: svn_types.h:1155
apr_time_t creation_date
when lock was made
Definition: svn_types.h:1070