subversion/libsvn_wc/entries.h - subversion - Git at Google

 /*
  * entries.h :  manipulating entries
  *
  * ====================================================================
  * Copyright (c) 2000-2002 CollabNet.  All rights reserved.
  *
  * This software is licensed as described in the file COPYING, which
  * you should have received as part of this distribution.  The terms
  * are also available at http://subversion.tigris.org/license-1.html.
  * If newer versions of this license are posted there, you may use a
  * newer version instead, at your option.
  *
  * This software consists of voluntary contributions made by many
  * individuals.  For exact contribution history, see the revision
  * history and logs, available at http://subversion.tigris.org/.
  * ====================================================================
  */


 #ifndef SVN_LIBSVN_WC_ENTRIES_H
 #define SVN_LIBSVN_WC_ENTRIES_H

 #include <apr_pools.h>
 #include "svn_types.h"
 #include "svn_string.h"
 #include "svn_error.h"

 #ifdef __cplusplus
 extern "C" {
 #endif /* __cplusplus */


 #define SVN_WC__ENTRIES_TOPLEVEL       "wc-entries"
 #define SVN_WC__ENTRIES_ENTRY          "entry"

 /* String representations for svn_node_kind.  This maybe should be
    abstracted farther out? */
 #define SVN_WC__ENTRIES_ATTR_FILE_STR   "file"
 #define SVN_WC__ENTRIES_ATTR_DIR_STR    "dir"


 /* The names of the XML attributes for storing entries' information.
    ### If you add or remove items here, you probably want to make sure
    to do the same for the SVN_WC__ENTRY_MODIFY_* #defines as well. */
 #define SVN_WC__ENTRY_ATTR_NAME          "name"
 #define SVN_WC__ENTRY_ATTR_REVISION      "revision"
 #define SVN_WC__ENTRY_ATTR_URL           "url"
 #define SVN_WC__ENTRY_ATTR_KIND          "kind"
 #define SVN_WC__ENTRY_ATTR_TEXT_TIME     "text-time"
 #define SVN_WC__ENTRY_ATTR_PROP_TIME     "prop-time"
 #define SVN_WC__ENTRY_ATTR_CHECKSUM      "checksum"     /* ### not used */
 #define SVN_WC__ENTRY_ATTR_SCHEDULE      "schedule"
 #define SVN_WC__ENTRY_ATTR_COPIED        "copied"
 #define SVN_WC__ENTRY_ATTR_COPYFROM_URL  "copyfrom-url"
 #define SVN_WC__ENTRY_ATTR_COPYFROM_REV  "copyfrom-rev"
 #define SVN_WC__ENTRY_ATTR_CONFLICT_OLD  "conflict-old" /* saved old file */
 #define SVN_WC__ENTRY_ATTR_CONFLICT_NEW  "conflict-new" /* saved new file */
 #define SVN_WC__ENTRY_ATTR_CONFLICT_WRK  "conflict-wrk" /* saved wrk file */
 #define SVN_WC__ENTRY_ATTR_PREJFILE      "prop-reject-file"
 #define SVN_WC__ENTRY_ATTR_CMT_REV       "committed-rev"
 #define SVN_WC__ENTRY_ATTR_CMT_DATE      "committed-date"
 #define SVN_WC__ENTRY_ATTR_CMT_AUTHOR    "last-author"


 /* Initialize an entries file based on URL, in th adm area for
    PATH.  The adm area must not already have an entries file. */
 svn_error_t *svn_wc__entries_init (svn_stringbuf_t *path,
                                    svn_stringbuf_t *url,
                                    apr_pool_t *pool);


 /* Create or overwrite an `entries' file for PATH using the contents
    of ENTRIES.  See also svn_wc_entries_read() in the public api. */
 svn_error_t *svn_wc__entries_write (apr_hash_t *entries,
                                     svn_stringbuf_t *path,
                                     apr_pool_t *pool);


 /* Create a new entry from the attributes hash ATTS.  Use POOL for all
    allocations, EXCEPT that **NEW_ENTRY->attributes will simply point
    to the ATTS passed to the function -- this hash is not copied into
    a new pool!  MODIFY_FLAGS are set to the fields that were
    explicitly modified by the attribute hash.  */
 svn_error_t *svn_wc__atts_to_entry (svn_wc_entry_t **new_entry,
                                     apr_uint32_t *modify_flags,
                                     apr_hash_t *atts,
                                     apr_pool_t *pool);


 /* The MODIFY_FLAGS that tell svn_wc__entry_modify which parameters to
    pay attention to.  ### These should track the changes made to the
    SVN_WC__ENTRY_ATTR_* #defines! */
 #define SVN_WC__ENTRY_MODIFY_REVISION      0x00000001
 #define SVN_WC__ENTRY_MODIFY_URL           0x00000002
 #define SVN_WC__ENTRY_MODIFY_KIND          0x00000004
 #define SVN_WC__ENTRY_MODIFY_TEXT_TIME     0x00000008
 #define SVN_WC__ENTRY_MODIFY_PROP_TIME     0x00000010
 #define SVN_WC__ENTRY_MODIFY_CHECKSUM      0x00000020
 #define SVN_WC__ENTRY_MODIFY_SCHEDULE      0x00000040
 #define SVN_WC__ENTRY_MODIFY_COPIED        0x00000080
 #define SVN_WC__ENTRY_MODIFY_COPYFROM_URL  0x00000100
 #define SVN_WC__ENTRY_MODIFY_COPYFROM_REV  0x00000200
 #define SVN_WC__ENTRY_MODIFY_CONFLICT_OLD  0x00000400
 #define SVN_WC__ENTRY_MODIFY_CONFLICT_NEW  0x00000800
 #define SVN_WC__ENTRY_MODIFY_CONFLICT_WRK  0x00001000
 #define SVN_WC__ENTRY_MODIFY_PREJFILE      0x00002000
 #define SVN_WC__ENTRY_MODIFY_CMT_REV       0x00004000
 #define SVN_WC__ENTRY_MODIFY_CMT_DATE      0x00008000
 #define SVN_WC__ENTRY_MODIFY_CMT_AUTHOR    0x00010000


 /* ...or perhaps this to mean all of those above... */
 #define SVN_WC__ENTRY_MODIFY_ALL           0x7FFFFFFF

 /* ...ORed together with this to mean "I really mean this, don't be
    trying to protect me from myself on this one." */
 #define SVN_WC__ENTRY_MODIFY_FORCE         0x80000000


 /* Modify an entry for NAME in parent dir PATH by folding ("merging")
    in changes, and sync those changes to disk.  New values for the
    entry are pulled from their respective fields in ENTRY, and
    MODIFY_FLAGS is a bitmask to specify which of those field to pay
    attention to.

    - ENTRY->kind specifies the node kind for this entry, and is
      *required* to be set to one of the following valid values:
      'svn_node_dir', 'svn_node_file'.

    - NAME can be NULL to specify that the caller wishes to modify the
      "this dir" entry in PATH.

    Perform all allocations in POOL.

    NOTE: when you call this function, the entries file will be read,
    tweaked, and written back out.  */
 svn_error_t *svn_wc__entry_modify (svn_stringbuf_t *path,
                                    svn_stringbuf_t *name,
                                    svn_wc_entry_t *entry,
                                    apr_uint32_t modify_flags,
                                    apr_pool_t *pool);

 /* Remove entry NAME from ENTRIES, unconditionally. */
 void svn_wc__entry_remove (apr_hash_t *entries, svn_stringbuf_t *name);


 /* Tweak the entry NAME within hash ENTRIES.  If NEW_URL is non-null,
  * make this the entry's new url.  If NEW_REV is valid, make this the
  * entry's working revision.  (This is purely an in-memory operation.)
  *
  * (Intended as a helper to svn_wc__do_update_cleanup, which see.)
  */
 svn_error_t *
 svn_wc__tweak_entry (apr_hash_t *entries,
                      const svn_stringbuf_t *name,
                      const svn_stringbuf_t *new_url,
                      const svn_revnum_t new_rev,
                      apr_pool_t *pool);


 #ifdef __cplusplus
 }
 #endif /* __cplusplus */

 #endif /* SVN_LIBSVN_WC_ENTRIES_H */


 /*
  * local variables:
  * eval: (load-file "../../tools/dev/svn-dev.el")
  * end:
  */
	/*
	* entries.h : manipulating entries
	*
	* ====================================================================
	* Copyright (c) 2000-2002 CollabNet. All rights reserved.
	*
	* This software is licensed as described in the file COPYING, which
	* you should have received as part of this distribution. The terms
	* are also available at http://subversion.tigris.org/license-1.html.
	* If newer versions of this license are posted there, you may use a
	* newer version instead, at your option.
	*
	* This software consists of voluntary contributions made by many
	* individuals. For exact contribution history, see the revision
	* history and logs, available at http://subversion.tigris.org/.
	* ====================================================================
	*/


	#ifndef SVN_LIBSVN_WC_ENTRIES_H
	#define SVN_LIBSVN_WC_ENTRIES_H

	#include <apr_pools.h>
	#include "svn_types.h"
	#include "svn_string.h"
	#include "svn_error.h"

	#ifdef __cplusplus
	extern "C" {
	#endif /* __cplusplus */


	#define SVN_WC__ENTRIES_TOPLEVEL "wc-entries"
	#define SVN_WC__ENTRIES_ENTRY "entry"

	/* String representations for svn_node_kind. This maybe should be
	abstracted farther out? */
	#define SVN_WC__ENTRIES_ATTR_FILE_STR "file"
	#define SVN_WC__ENTRIES_ATTR_DIR_STR "dir"


	/* The names of the XML attributes for storing entries' information.
	### If you add or remove items here, you probably want to make sure
	to do the same for the SVN_WC__ENTRY_MODIFY_* #defines as well. */
	#define SVN_WC__ENTRY_ATTR_NAME "name"
	#define SVN_WC__ENTRY_ATTR_REVISION "revision"
	#define SVN_WC__ENTRY_ATTR_URL "url"
	#define SVN_WC__ENTRY_ATTR_KIND "kind"
	#define SVN_WC__ENTRY_ATTR_TEXT_TIME "text-time"
	#define SVN_WC__ENTRY_ATTR_PROP_TIME "prop-time"
	#define SVN_WC__ENTRY_ATTR_CHECKSUM "checksum" /* ### not used */
	#define SVN_WC__ENTRY_ATTR_SCHEDULE "schedule"
	#define SVN_WC__ENTRY_ATTR_COPIED "copied"
	#define SVN_WC__ENTRY_ATTR_COPYFROM_URL "copyfrom-url"
	#define SVN_WC__ENTRY_ATTR_COPYFROM_REV "copyfrom-rev"
	#define SVN_WC__ENTRY_ATTR_CONFLICT_OLD "conflict-old" /* saved old file */
	#define SVN_WC__ENTRY_ATTR_CONFLICT_NEW "conflict-new" /* saved new file */
	#define SVN_WC__ENTRY_ATTR_CONFLICT_WRK "conflict-wrk" /* saved wrk file */
	#define SVN_WC__ENTRY_ATTR_PREJFILE "prop-reject-file"
	#define SVN_WC__ENTRY_ATTR_CMT_REV "committed-rev"
	#define SVN_WC__ENTRY_ATTR_CMT_DATE "committed-date"
	#define SVN_WC__ENTRY_ATTR_CMT_AUTHOR "last-author"



	/* Initialize an entries file based on URL, in th adm area for
	PATH. The adm area must not already have an entries file. */
	svn_error_t svn_wc__entries_init (svn_stringbuf_t path,
	svn_stringbuf_t *url,
	apr_pool_t *pool);


	/* Create or overwrite an `entries' file for PATH using the contents
	of ENTRIES. See also svn_wc_entries_read() in the public api. */
	svn_error_t svn_wc__entries_write (apr_hash_t entries,
	svn_stringbuf_t *path,
	apr_pool_t *pool);


	/* Create a new entry from the attributes hash ATTS. Use POOL for all
	allocations, EXCEPT that **NEW_ENTRY->attributes will simply point
	to the ATTS passed to the function -- this hash is not copied into
	a new pool! MODIFY_FLAGS are set to the fields that were
	explicitly modified by the attribute hash. */
	svn_error_t svn_wc__atts_to_entry (svn_wc_entry_t *new_entry,
	apr_uint32_t *modify_flags,
	apr_hash_t *atts,
	apr_pool_t *pool);


	/* The MODIFY_FLAGS that tell svn_wc__entry_modify which parameters to
	pay attention to. ### These should track the changes made to the
	SVN_WC__ENTRY_ATTR_* #defines! */
	#define SVN_WC__ENTRY_MODIFY_REVISION 0x00000001
	#define SVN_WC__ENTRY_MODIFY_URL 0x00000002
	#define SVN_WC__ENTRY_MODIFY_KIND 0x00000004
	#define SVN_WC__ENTRY_MODIFY_TEXT_TIME 0x00000008
	#define SVN_WC__ENTRY_MODIFY_PROP_TIME 0x00000010
	#define SVN_WC__ENTRY_MODIFY_CHECKSUM 0x00000020
	#define SVN_WC__ENTRY_MODIFY_SCHEDULE 0x00000040
	#define SVN_WC__ENTRY_MODIFY_COPIED 0x00000080
	#define SVN_WC__ENTRY_MODIFY_COPYFROM_URL 0x00000100
	#define SVN_WC__ENTRY_MODIFY_COPYFROM_REV 0x00000200
	#define SVN_WC__ENTRY_MODIFY_CONFLICT_OLD 0x00000400
	#define SVN_WC__ENTRY_MODIFY_CONFLICT_NEW 0x00000800
	#define SVN_WC__ENTRY_MODIFY_CONFLICT_WRK 0x00001000
	#define SVN_WC__ENTRY_MODIFY_PREJFILE 0x00002000
	#define SVN_WC__ENTRY_MODIFY_CMT_REV 0x00004000
	#define SVN_WC__ENTRY_MODIFY_CMT_DATE 0x00008000
	#define SVN_WC__ENTRY_MODIFY_CMT_AUTHOR 0x00010000


	/* ...or perhaps this to mean all of those above... */
	#define SVN_WC__ENTRY_MODIFY_ALL 0x7FFFFFFF

	/* ...ORed together with this to mean "I really mean this, don't be
	trying to protect me from myself on this one." */
	#define SVN_WC__ENTRY_MODIFY_FORCE 0x80000000


	/* Modify an entry for NAME in parent dir PATH by folding ("merging")
	in changes, and sync those changes to disk. New values for the
	entry are pulled from their respective fields in ENTRY, and
	MODIFY_FLAGS is a bitmask to specify which of those field to pay
	attention to.

	- ENTRY->kind specifies the node kind for this entry, and is
	required to be set to one of the following valid values:
	'svn_node_dir', 'svn_node_file'.

	- NAME can be NULL to specify that the caller wishes to modify the
	"this dir" entry in PATH.

	Perform all allocations in POOL.

	NOTE: when you call this function, the entries file will be read,
	tweaked, and written back out. */
	svn_error_t svn_wc__entry_modify (svn_stringbuf_t path,
	svn_stringbuf_t *name,
	svn_wc_entry_t *entry,
	apr_uint32_t modify_flags,
	apr_pool_t *pool);

	/* Remove entry NAME from ENTRIES, unconditionally. */
	void svn_wc__entry_remove (apr_hash_t entries, svn_stringbuf_t name);


	/* Tweak the entry NAME within hash ENTRIES. If NEW_URL is non-null,
	* make this the entry's new url. If NEW_REV is valid, make this the
	* entry's working revision. (This is purely an in-memory operation.)
	*
	* (Intended as a helper to svn_wc__do_update_cleanup, which see.)
	*/
	svn_error_t *
	svn_wc__tweak_entry (apr_hash_t *entries,
	const svn_stringbuf_t *name,
	const svn_stringbuf_t *new_url,
	const svn_revnum_t new_rev,
	apr_pool_t *pool);


	#ifdef __cplusplus
	}
	#endif /* __cplusplus */

	#endif /* SVN_LIBSVN_WC_ENTRIES_H */


	/*
	* local variables:
	* eval: (load-file "../../tools/dev/svn-dev.el")
	* end:
	*/