props.c File Reference

Properties handling - prop-get, prop-set, prop-list. More...

#include <sys/types.h>
#include <limits.h>
#include <unistd.h>
#include <gdbm.h>
#include <fcntl.h>
#include <subversion-1/svn_props.h>
#include "global.h"
#include "waa.h"
#include "url.h"
#include "helper.h"
#include "actions.h"
#include "hash_ops.h"
#include "props.h"
#include "update.h"
#include "ignore.h"
#include "est_ops.h"
#include "add_unvers.h"
#include "warnings.h"

Include dependency graph for props.c:

Go to the source code of this file.

Defines
#define	FSVS_PROP_PREFIX "fsvs:"
	The common prefix.
#define	FSVS_PROP_COMMIT_PIPE FSVS_PROP_PREFIX "commit-pipe"
	The name for the commit-pipe property.
#define	FSVS_PROP_UPDATE_PIPE FSVS_PROP_PREFIX "update-pipe"
	The name of the update-pipe property.
#define	FSVS_PROP_INSTALL_CMD FSVS_PROP_PREFIX "install"
	Local install commandline.
#define	FSVS_PROP_ORIG_MD5 FSVS_PROP_PREFIX "original-md5"
	The MD5 of the original (un-encoded) data.
propNames Meta-data property names.
Depending on the subversion sources there may be some of these already defined - especially if the header files are from the meta-data branches. These would override the defaults - but lets hope that they'll always be compatible!
#define	SVN_PROP_TEXT_TIME SVN_PROP_PREFIX "text-time"
#define	SVN_PROP_OWNER SVN_PROP_PREFIX "owner"
#define	SVN_PROP_GROUP SVN_PROP_PREFIX "group"
#define	SVN_PROP_UNIX_MODE SVN_PROP_PREFIX "unix-mode"
Functions
int	prp__open_byname (char wcfile, int gdbm_mode, hash_t db)
	-.
int	prp__open_byestat (struct estat sts, int gdbm_mode, hash_t db)
	-.
int	prp__set (hash_t db, const char name, const char data, int datalen)
	-.
int	prp__set_svnstr (hash_t db, const char name, const svn_string_t utf8_value)
	-.
int	prp__store (hash_t db, datum key, datum value)
	-.
int	prp__get (hash_t db, char keycp, datum value)
	-.
int	prp__set_from_aprhash (struct estat sts, apr_hash_t props, enum prp__set_from_aprhash_e flags, hash_t props_db, apr_pool_t pool)
	-.
int	prp__g_work (struct estat root, int argc, char argv[])
	-.
int	prp__s_work (struct estat root, int argc, char argv[])
	-.
int	prp__open_get_close (struct estat sts, char name, char *data, int len)
	-.
int	prp__l_work (struct estat root, int argc, char argv[])
	-.
int	prp__unlink_db_for_estat (struct estat *sts)
	-.
Variables
const char	prp___to_be_removed_value []
	-.


char	propname_mtime [] = SVN_PROP_TEXT_TIME
	Modification time - `svn:text-time`.
char	propname_owner [] = SVN_PROP_OWNER
	-.
char	propname_group [] = SVN_PROP_GROUP
	-.
char	propname_origmd5 [] = FSVS_PROP_ORIG_MD5
	-.
char	propname_umode [] = SVN_PROP_UNIX_MODE
	-.
char	propname_special [] = SVN_PROP_SPECIAL
	-.
char	propval_special [] = SVN_PROP_SPECIAL_VALUE
	-.
char	propval_commitpipe [] = FSVS_PROP_COMMIT_PIPE
	-.
char	propval_updatepipe [] = FSVS_PROP_UPDATE_PIPE
	-.
char	propval_orig_md5 [] = FSVS_PROP_ORIG_MD5
	-.

Detailed Description

Properties handling - prop-get, prop-set, prop-list.

Deleted properties are marked locally be a special value; callers need to check by using prp__prop_will_be_removed().

Todo:: --xml, --raw, --dump switches?

Todo:: should prop-get and prop-list use UTF-8 or local encoding? Currently the names and values are dumped as-is, ie. UTF-8.

Definition in file props.c.

Define Documentation

#define SVN_PROP_GROUP SVN_PROP_PREFIX "group"

Definition at line 280 of file props.c.

#define SVN_PROP_OWNER SVN_PROP_PREFIX "owner"

Definition at line 277 of file props.c.

#define SVN_PROP_TEXT_TIME SVN_PROP_PREFIX "text-time"

Definition at line 274 of file props.c.

#define SVN_PROP_UNIX_MODE SVN_PROP_PREFIX "unix-mode"

Definition at line 283 of file props.c.

Function Documentation

int prp__g_work	(	struct estat *	root,
		int	argc,
		char *	argv[]
	)

-.

Definition at line 561 of file props.c.

References ac__Usage_this, DEBUGP, hsh__close(), prp__fetch(), prp__open_byname(), prp__prop_will_be_removed(), STOPIF, STOPIF_CODE_EPIPE, and waa__find_common_base().

Here is the call graph for this function:

int prp__get	(	hash_t	db,
		char *	keycp,
		datum *	value
	)

-.

Get a value, addressed by a string; key length is calculated inclusive the \0.

Wrapper for prp__fetch().

Definition at line 445 of file props.c.

References prp__fetch().

Referenced by prp__open_get_close(), and up__fetch_decoder().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__l_work	(	struct estat *	root,
		int	argc,
		char *	argv[]
	)

-.

Definition at line 779 of file props.c.

References ac__Usage_this, DEBUGP, hlp__safe_print(), hsh__close(), opt__is_verbose(), prp__fetch(), prp__first(), prp__next(), prp__open_byname(), prp__prop_will_be_removed(), STOPIF, STOPIF_CODE_EPIPE, and waa__find_common_base().

Here is the call graph for this function:

int prp__open_byestat	(	struct estat *	sts,
		int	gdbm_mode,
		hash_t *	db
	)

-.

Open a property file, by struct estat.

Returns ENOENT silently.

Definition at line 366 of file props.c.

References ops__build_path(), prp__open_byname(), and STOPIF.

Referenced by ops__apply_group(), prp__open_get_close(), prp__s_work(), prp__set_from_aprhash(), and up__fetch_decoder().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__open_byname	(	char *	wcfile,
		int	gdbm_mode,
		hash_t *	db
	)

-.

Open a property file, by WC-path.

Just a wrapper for the normal property operation.

Must be silent for ENOENT, so that fsvs pl * doesn't give an error.

Definition at line 350 of file props.c.

References hsh__new(), STOPIF, and WAA__PROP_EXT.

Referenced by prp__g_work(), prp__l_work(), and prp__open_byestat().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__open_get_close	(	struct estat *	sts,
		char *	name,
		char **	data,
		int *	len
	)

-.

Open, fetch, close a property hash corresponding to sts and name.

data and len are optional output parameters, ie. may be NULL. if data is used, it must be free()d.

Returns ENOENT silently.

Definition at line 749 of file props.c.

References hsh__close(), IF_FREE, prp__get(), prp__open_byestat(), and STOPIF.

Here is the call graph for this function:

int prp__s_work	(	struct estat *	root,
		int	argc,
		char *	argv[]
	)

-.

Depending on action->i_val properties are removed or added.

Definition at line 628 of file props.c.

References ac__Usage_this, action, au__prepare_for_added(), current_url, DEBUGP, estat::flags, FS_REMOVED, hlp__lstat(), hsh__close(), actionlist_t::i_val, ign__is_ignore(), ops__apply_group(), OPS__CREATE, OPS__FAIL_NOT_LIST, ops__traverse(), prp___to_be_removed_value, prp__fetch(), prp__open_byestat(), prp__store(), RF_ADD, RF_ISNEW, RF_PUSHPROPS, estat::st, STOPIF, estat::url, wa__warn(), waa__find_common_base(), waa__input_tree(), waa__output_tree(), and WRN__PROP_NAME_RESERVED.

Here is the call graph for this function:

int prp__set	(	hash_t	db,
		const char *	name,
		const char *	data,
		int	datalen
	)

-.

Set a property by name and data/datalen.

If datalen is -1, strlen(data) is used.

Definition at line 383 of file props.c.

References BUG_ON, prp__store(), and STOPIF.

Referenced by prp__set_svnstr().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__set_from_aprhash	(	struct estat *	sts,
		apr_hash_t *	props,
		enum prp__set_from_aprhash_e	flags,
		hash_t *	props_db,
		apr_pool_t *	pool
	)

-.

Writes the given set of properties of sts into its prop file.

The meta-data of the entry is overwritten with the data coming from the repository; its estat::remote_status is set. If props_db is not NULL, the still opened property database is returned.

Todo:

store in utf-8? local encoding? What if it's binary??? Better do no translation, ie store as UTF-8.

Definition at line 461 of file props.c.

References DEBUGP, HASH_REMEMBER_FILENAME, hsh__close(), ONLY_KEEP_USERDEF, prp__open_byestat(), prp__set_svnstr(), prp__unlink_db_for_estat(), STOPIF, STORE_IN_FS, and up__parse_prop().

Referenced by ops__apply_group(), rev__get_props(), rev__get_text_to_stream(), and rev__install_file().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__set_svnstr	(	hash_t	db,
		const char *	name,
		const svn_string_t *	utf8_value
	)			`[inline]`

-.

Set a property by svn_string_t.

Convenience function. The svn_string_t has the number of characters used, whereas we store the \0 at the end, too.

Definition at line 422 of file props.c.

References prp__set().

Referenced by prp__set_from_aprhash().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__store	(	hash_t	db,
		datum	key,
		datum	value
	)

-.

Store the value; basic function.

Definition at line 432 of file props.c.

References DEBUGP, hsh__store(), and STOPIF.

Referenced by prp__s_work(), and prp__set().

Here is the call graph for this function:

Here is the caller graph for this function:

int prp__unlink_db_for_estat ( struct estat * sts )

-.

Definition at line 869 of file props.c.

References ops__build_path(), STOPIF, waa__get_gwd_flag(), waa__get_waa_directory(), and WAA__PROP_EXT.

Referenced by prp__set_from_aprhash().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

char propname_group[] = SVN_PROP_GROUP

-.

Group - svn:group.

Definition at line 308 of file props.c.

Referenced by ci___set_props(), and up__parse_prop().

char propname_mtime[] = SVN_PROP_TEXT_TIME

Modification time - svn:text-time.

Property names from the subversion name-space

FSVS has a number of reserved property names, where it stores the meta-data and other per-entry data in the repository.

Property names from the subversion name-space

Such names are already in use in the mtime and meta-data branches of subversion; we use the values defined in svn_props.h (if any), or use the originally used values to be compatible.

These start all with the string defined in SVN_PROP_PREFIX, which is svn: .

Definition at line 304 of file props.c.

Referenced by ci___set_props(), and up__parse_prop().

char propname_origmd5[] = FSVS_PROP_ORIG_MD5

-.

Original MD5 for encoded entries.

Definition at line 310 of file props.c.

Referenced by ci__nondir(), and up__parse_prop().

char propname_owner[] = SVN_PROP_OWNER

-.

Owner - svn:owner.

Definition at line 306 of file props.c.

Referenced by ci___set_props(), and up__parse_prop().

char propname_special[] = SVN_PROP_SPECIAL

-.

Flag for special entry.

Subversion defines that for symlinks; we use that for devices, too.

Definition at line 315 of file props.c.

Referenced by ci__nondir(), rev__install_file(), and up__parse_prop().

char propname_umode[] = SVN_PROP_UNIX_MODE

-.

Unix mode - svn:unix-mode.

Definition at line 312 of file props.c.

Referenced by ci___set_props(), and up__parse_prop().

char propval_commitpipe[] = FSVS_PROP_COMMIT_PIPE

-.

Commit-pipe program.

This will get the local file as STDIN, and its output goes to the repository. See FSVS_PROP_COMMIT_PIPE.

Definition at line 322 of file props.c.

Referenced by ci___send_user_props().

char propval_orig_md5[] = FSVS_PROP_ORIG_MD5

-.

Definition at line 329 of file props.c.

char propval_special[] = SVN_PROP_SPECIAL_VALUE

-.

The value for the special property; normally "*".

Definition at line 317 of file props.c.

Referenced by ci__nondir(), and up__parse_prop().

char propval_updatepipe[] = FSVS_PROP_UPDATE_PIPE

-.

Update-pipe program.

This will get the repository file as STDIN, and its output goes to a local temporary file, which gets installed. See FSVS_PROP_UPDATE_PIPE.

Definition at line 327 of file props.c.

Referenced by rev__get_text_to_stream(), sync___recurse(), up__fetch_decoder(), and up__parse_prop().

const char prp___to_be_removed_value[]

Initial value:

    "FSVS:INTERNAL-\nto-be-removed\n-"
    "\x8f\xc1\xa6\xe5\x86\x0a\x01\x72\x54\x89\x25\x23\x03\xc3\xfa\x75"

-.

Value string for to-be-removed properties.

I thought about using "constant prefix.$random" => "$propertyname" for them - but it's more work than simply ignoring them before listing.

And as they're not widely used, it's easier this way.

Definition at line 339 of file props.c.

Referenced by prp__prop_will_be_removed(), and prp__s_work().

props.c File Reference

Defines

Functions

Variables

Detailed Description

Define Documentation

Function Documentation

Variable Documentation

Property names from the subversion name-space

Property names from the subversion name-space