| /** |
| * @copyright |
| * ==================================================================== |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * ==================================================================== |
| * @endcopyright |
| * |
| * @file svn_ra_svn_private.h |
| * @brief Functions used by the server - Internal routines |
| */ |
| |
| #ifndef SVN_RA_SVN_PRIVATE_H |
| #define SVN_RA_SVN_PRIVATE_H |
| |
| #include "svn_ra_svn.h" |
| #include "svn_editor.h" |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif /* __cplusplus */ |
| |
| /** Memory representation of an on-the-wire data item. */ |
| typedef struct svn_ra_svn__item_t svn_ra_svn__item_t; |
| |
| /* A list of svn_ra_svn__item_t objects. */ |
| typedef struct svn_ra_svn__list_t |
| { |
| /* List contents (array). May be NULL if NELTS is 0. */ |
| struct svn_ra_svn__item_t *items; |
| |
| /* Number of elements in ITEMS. */ |
| int nelts; |
| } svn_ra_svn__list_t; |
| |
| /* List element access macro. */ |
| #define SVN_RA_SVN__LIST_ITEM(list, idx) (list)->items[idx] |
| |
| /** Memory representation of an on-the-wire data item. */ |
| struct svn_ra_svn__item_t |
| { |
| /** Variant indicator. */ |
| svn_ra_svn_item_kind_t kind; |
| |
| /** Variant data. */ |
| union { |
| apr_uint64_t number; |
| svn_string_t string; |
| svn_string_t word; |
| svn_ra_svn__list_t list; |
| } u; |
| }; |
| |
| /** Command handler, used by svn_ra_svn__handle_commands(). */ |
| typedef svn_error_t *(*svn_ra_svn__command_handler)(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_ra_svn__list_t *params, |
| void *baton); |
| |
| /** Command table, used by svn_ra_svn_handle_commands(). |
| */ |
| typedef struct svn_ra_svn__cmd_entry_t |
| { |
| /** Name of the command */ |
| const char *cmdname; |
| |
| /** Handler for the command */ |
| svn_ra_svn__command_handler handler; |
| |
| /** Only set when used through a deprecated API. |
| * HANDLER is NULL in that case. */ |
| svn_ra_svn_command_handler deprecated_handler; |
| |
| /** Termination flag. If set, command-handling will cease after |
| * command is processed. */ |
| svn_boolean_t terminate; |
| } svn_ra_svn__cmd_entry_t; |
| |
| |
| /* Return a deep copy of the SOURCE array containing private API |
| * svn_ra_svn__item_t SOURCE to public API *TARGET, allocating |
| * sub-structures in RESULT_POOL. */ |
| apr_array_header_t * |
| svn_ra_svn__to_public_array(const svn_ra_svn__list_t *source, |
| apr_pool_t *result_pool); |
| |
| /* Deep copy contents from private API *SOURCE to public API *TARGET, |
| * allocating sub-structures in RESULT_POOL. */ |
| void |
| svn_ra_svn__to_public_item(svn_ra_svn_item_t *target, |
| const svn_ra_svn__item_t *source, |
| apr_pool_t *result_pool); |
| |
| svn_ra_svn__list_t * |
| svn_ra_svn__to_private_array(const apr_array_header_t *source, |
| apr_pool_t *result_pool); |
| |
| /* Deep copy contents from public API *SOURCE to private API *TARGET, |
| * allocating sub-structures in RESULT_POOL. */ |
| void |
| svn_ra_svn__to_private_item(svn_ra_svn__item_t *target, |
| const svn_ra_svn_item_t *source, |
| apr_pool_t *result_pool); |
| |
| /** Add the capabilities in @a list to @a conn's capabilities. |
| * @a list contains svn_ra_svn__item_t entries (which should be of type |
| * SVN_RA_SVN_WORD; a malformed data error will result if any are not). |
| * |
| * This is idempotent: if a given capability was already set for |
| * @a conn, it remains set. |
| */ |
| svn_error_t * |
| svn_ra_svn__set_capabilities(svn_ra_svn_conn_t *conn, |
| const svn_ra_svn__list_t *list); |
| |
| /** Returns the preferred svndiff version to be used with connection @a conn. |
| */ |
| int |
| svn_ra_svn__svndiff_version(svn_ra_svn_conn_t *conn); |
| |
| |
| /** |
| * Set the shim callbacks to be used by @a conn to @a shim_callbacks. |
| */ |
| svn_error_t * |
| svn_ra_svn__set_shim_callbacks(svn_ra_svn_conn_t *conn, |
| svn_delta_shim_callbacks_t *shim_callbacks); |
| |
| /** |
| * Return the memory pool used to allocate @a conn. |
| */ |
| apr_pool_t * |
| svn_ra_svn__get_pool(svn_ra_svn_conn_t *conn); |
| |
| /** |
| * @defgroup ra_svn_deprecated ra_svn low-level functions |
| * @{ |
| */ |
| |
| /** Write a number over the net. |
| * |
| * Writes will be buffered until the next read or flush. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_number(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| apr_uint64_t number); |
| |
| /** Write a string over the net. |
| * |
| * Writes will be buffered until the next read or flush. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_string(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *str); |
| |
| /** Write a cstring over the net. |
| * |
| * Writes will be buffered until the next read or flush. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cstring(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *s); |
| |
| /** Write a word over the net. |
| * |
| * Writes will be buffered until the next read or flush. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_word(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *word); |
| |
| /** Write a boolean over the net. |
| * |
| * Writes will be buffered until the next read or flush. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_boolean(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_boolean_t value); |
| |
| /** Write a list of properties over the net. @a props is allowed to be NULL, |
| * in which case an empty list will be written out. |
| * |
| * @since New in 1.5. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_proplist(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| apr_hash_t *props); |
| |
| /** Begin a list. Writes will be buffered until the next read or flush. */ |
| svn_error_t * |
| svn_ra_svn__start_list(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** End a list. Writes will be buffered until the next read or flush. */ |
| svn_error_t * |
| svn_ra_svn__end_list(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Flush the write buffer. |
| * |
| * Normally this shouldn't be necessary, since the write buffer is flushed |
| * when a read is attempted. |
| */ |
| svn_error_t * |
| svn_ra_svn__flush(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Write a tuple, using a printf-like interface. |
| * |
| * The format string @a fmt may contain: |
| * |
| *@verbatim |
| Spec Argument type Item type |
| ---- -------------------- --------- |
| n apr_uint64_t Number |
| r svn_revnum_t Number |
| s const svn_string_t * String |
| c const char * String |
| w const char * Word |
| b svn_boolean_t Word ("true" or "false") |
| ( Begin tuple |
| ) End tuple |
| ? Remaining elements optional |
| ! (at beginning or end) Suppress opening or closing of tuple |
| @endverbatim |
| * |
| * Inside the optional part of a tuple, 'r' values may be @c |
| * SVN_INVALID_REVNUM, 'n' values may be |
| * SVN_RA_SVN_UNSPECIFIED_NUMBER, and 's', 'c', and 'w' values may be |
| * @c NULL; in these cases no data will be written. 'b' and '(' may |
| * not appear in the optional part of a tuple. Either all or none of |
| * the optional values should be valid. |
| * |
| * (If we ever have a need for an optional boolean value, we should |
| * invent a 'B' specifier which stores a boolean into an int, using -1 |
| * for unspecified. Right now there is no need for such a thing.) |
| * |
| * Use the '!' format specifier to write partial tuples when you have |
| * to transmit an array or other unusual data. For example, to write |
| * a tuple containing a revision, an array of words, and a boolean: |
| * @code |
| SVN_ERR(svn_ra_svn__write_tuple(conn, pool, "r(!", rev)); |
| for (i = 0; i < n; i++) |
| SVN_ERR(svn_ra_svn__write_word(conn, pool, words[i])); |
| SVN_ERR(svn_ra_svn__write_tuple(conn, pool, "!)b", flag)); @endcode |
| */ |
| svn_error_t * |
| svn_ra_svn__write_tuple(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *fmt, ...); |
| |
| /** Read an item from the network into @a *item. */ |
| svn_error_t * |
| svn_ra_svn__read_item(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_ra_svn__item_t **item); |
| |
| /** Scan data on @a conn until we find something which looks like the |
| * beginning of an svn server greeting (an open paren followed by a |
| * whitespace character). This function is appropriate for beginning |
| * a client connection opened in tunnel mode, since people's dotfiles |
| * sometimes write output to stdout. It may only be called at the |
| * beginning of a client connection. |
| */ |
| svn_error_t * |
| svn_ra_svn__skip_leading_garbage(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Parse an array of @c svn_sort__item_t structures as a tuple, using a |
| * printf-like interface. The format string @a fmt may contain: |
| * |
| *@verbatim |
| Spec Argument type Item type |
| ---- -------------------- --------- |
| n apr_uint64_t * Number |
| r svn_revnum_t * Number |
| s svn_string_t ** String |
| c const char ** String |
| w const char ** Word |
| b svn_boolean_t * Word ("true" or "false") |
| B apr_uint64_t * Word ("true" or "false") |
| 3 svn_tristate_t * Word ("true" or "false") |
| l apr_array_header_t ** List |
| ( Begin tuple |
| ) End tuple |
| ? Tuple is allowed to end here |
| @endverbatim |
| * |
| * Note that a tuple is only allowed to end precisely at a '?', or at |
| * the end of the specification. So if @a fmt is "c?cc" and @a list |
| * contains two elements, an error will result. |
| * |
| * '3' is similar to 'b', but may be used in the optional tuple specification. |
| * It returns #svn_tristate_true, #svn_tristate_false or #svn_tristate_unknown. |
| * |
| * 'B' is similar to '3', but it returns @c TRUE, @c FALSE, or |
| * #SVN_RA_SVN_UNSPECIFIED_NUMBER. 'B' is deprecated; new code should |
| * use '3' instead. |
| * |
| * If an optional part of a tuple contains no data, 'r' values will be |
| * set to @c SVN_INVALID_REVNUM; 'n' and 'B' values will be set to |
| * #SVN_RA_SVN_UNSPECIFIED_NUMBER; 's', 'c', 'w', and 'l' values will |
| * be set to @c NULL; '3' values will be set to #svn_tristate_unknown; |
| * and 'b' values will be set to @c FALSE. |
| */ |
| svn_error_t * |
| svn_ra_svn__parse_tuple(const svn_ra_svn__list_t *list, |
| const char *fmt, ...); |
| |
| /** Read a tuple from the network and parse it as a tuple, using the |
| * format string notation from svn_ra_svn_parse_tuple(). |
| */ |
| svn_error_t * |
| svn_ra_svn__read_tuple(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *fmt, ...); |
| |
| /** Parse an array of @c svn_ra_svn__item_t structures as a list of |
| * properties, storing the properties in a hash table. |
| * |
| * @since New in 1.5. |
| */ |
| svn_error_t * |
| svn_ra_svn__parse_proplist(const svn_ra_svn__list_t *list, |
| apr_pool_t *pool, |
| apr_hash_t **props); |
| |
| /** Read a command response from the network and parse it as a tuple, using |
| * the format string notation from svn_ra_svn_parse_tuple(). |
| */ |
| svn_error_t * |
| svn_ra_svn__read_cmd_response(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *fmt, ...); |
| |
| /** Check the receive buffer and socket of @a conn whether there is some |
| * unprocessed incoming data without waiting for new data to come in. |
| * If data is found, set @a *has_command to TRUE. If the connection does |
| * not contain any more data and has been closed, set @a *terminated to |
| * TRUE. |
| */ |
| svn_error_t * |
| svn_ra_svn__has_command(svn_boolean_t *has_command, |
| svn_boolean_t *terminated, |
| svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Accept a single command from @a conn and handle them according |
| * to @a cmd_hash. Command handlers will be passed @a conn, @a pool, |
| * the parameters of the command, and @a baton. @a *terminate will be |
| * set if either @a error_on_disconnect is FALSE and the connection got |
| * closed, or if the command being handled has the "terminate" flag set |
| * in the command table. |
| */ |
| svn_error_t * |
| svn_ra_svn__handle_command(svn_boolean_t *terminate, |
| apr_hash_t *cmd_hash, |
| void *baton, |
| svn_ra_svn_conn_t *conn, |
| svn_boolean_t error_on_disconnect, |
| apr_pool_t *pool); |
| |
| /** Accept commands over the network and handle them according to @a |
| * commands. Command handlers will be passed @a conn, a subpool of @a |
| * pool (cleared after each command is handled), the parameters of the |
| * command, and @a baton. Commands will be accepted until a |
| * terminating command is received (a command with "terminate" set in |
| * the command table). If a command handler returns an error wrapped |
| * in SVN_RA_SVN_CMD_ERR (see the @c SVN_CMD_ERR macro), the error |
| * will be reported to the other side of the connection and the |
| * command loop will continue; any other kind of error (typically a |
| * network or protocol error) is passed through to the caller. |
| * |
| * @since New in 1.6. |
| * |
| */ |
| svn_error_t * |
| svn_ra_svn__handle_commands2(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_ra_svn__cmd_entry_t *commands, |
| void *baton, |
| svn_boolean_t error_on_disconnect); |
| |
| /** Write a successful command response over the network, using the |
| * same format string notation as svn_ra_svn_write_tuple(). Do not use |
| * partial tuples with this function; if you need to use partial |
| * tuples, just write out the "success" and argument tuple by hand. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_response(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *fmt, ...); |
| |
| /** Write an unsuccessful command response over the network. |
| * |
| * @note This does not clear @a err. */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_failure(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_error_t *err); |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @defgroup svn_commands sending ra_svn commands |
| * @{ |
| */ |
| |
| /** Sets the target revision of connection @a conn to @a rev. Use @a pool |
| * for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_target_rev(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev); |
| |
| /** Send a "open-root" command over connection @a conn. Open the |
| * repository root at revision @a rev and associate it with @a token. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_open_root(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const svn_string_t *token); |
| |
| /** Send a "delete-entry" command over connection @a conn. Delete the |
| * @a path at optional revision @a rev below @a parent_token. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_delete_entry(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t rev, |
| const svn_string_t *parent_token); |
| |
| /** Send a "add-dir" command over connection @a conn. Add a new directory |
| * node named @a path under the directory identified by @a parent_token. |
| * Associate the new directory with the given @a token. * @a copy_path |
| * and @a copy_rev are optional and describe the copy source. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_add_dir(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token, |
| const svn_string_t *token, |
| const char *copy_path, |
| svn_revnum_t copy_rev); |
| |
| /** Send a "open-dir" command over connection @a conn. Associate to |
| * @a token the directory node named @a path under the directory |
| * identified by @a parent_token in revision @a rev. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_open_dir(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token, |
| const svn_string_t *token, |
| svn_revnum_t rev); |
| |
| /** Send a "change-dir-prop" command over connection @a conn. Set the |
| * property @a name to the optional @a value on the directory identified |
| * to @a token. Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_change_dir_prop(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token, |
| const char *name, |
| const svn_string_t *value); |
| |
| /** Send a "close-dir" command over connection @a conn. Identify the node |
| * to close with @a token. The latter will then no longer be associated |
| * with that node. Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_close_dir(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token); |
| |
| /** Send a "absent-dir" command over connection @a conn. Directory node |
| * named @a path under the directory identified by @a parent_token is |
| * absent. Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_absent_dir(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token); |
| |
| /** Send a "add-file" command over connection @a conn. Add a new file |
| * node named @a path under the directory identified by @a parent_token. |
| * Associate the new file with the given @a token. * @a copy_path and |
| * @a copy_rev are optional and describe the copy source. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_add_file(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token, |
| const svn_string_t *token, |
| const char *copy_path, |
| svn_revnum_t copy_rev); |
| |
| /** Send a "open-file" command over connection @a conn. Associate to |
| * @a token the file node named @a path under the directory identified by |
| * @a parent_token in revision @a rev. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_open_file(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token, |
| const svn_string_t *token, |
| svn_revnum_t rev); |
| |
| /** Send a "change-file-prop" command over connection @a conn. Set the |
| * property @a name to the optional @a value on the file identified to |
| * @a token. Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_change_file_prop(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token, |
| const char *name, |
| const svn_string_t *value); |
| |
| /** Send a "close-dir" command over connection @a conn. Identify the node |
| * to close with @a token and provide an optional @a check_sum. The token |
| * will then no longer be associated with that node. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_close_file(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token, |
| const char *text_checksum); |
| |
| /** Send a "absent-file" command over connection @a conn. File node |
| * named @a path in the directory identified by @a parent_token is |
| * absent. Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_absent_file(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *parent_token); |
| |
| /** Send a "apply-textdelta" command over connection @a conn. Starts a |
| * series of text deltas to be applied to the file identified by @a token. |
| * Optionally, specify the file's current checksum in @a base_checksum. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_apply_textdelta(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token, |
| const char *base_checksum); |
| |
| /** Send a "textdelta-chunk" command over connection @a conn. Apply |
| * textdelta @a chunk to the file identified by @a token. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_textdelta_chunk(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token, |
| const svn_string_t *chunk); |
| |
| /** Send a "textdelta-end" command over connection @a conn. Ends the |
| * series of text deltas to be applied to the file identified by @a token. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_textdelta_end(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *token); |
| |
| /** Send a "close-edit" command over connection @a conn. Ends the editor |
| * drive (successfully). Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_close_edit(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Send a "abort-edit" command over connection @a conn. Prematurely ends |
| * the editor drive, e.g. due to some problem on the other side. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_abort_edit(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Send a "set-path" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see set_path() in #svn_ra_reporter3_t for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_set_path(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t rev, |
| svn_boolean_t start_empty, |
| const char *lock_token, |
| svn_depth_t depth); |
| |
| /** Send a "delete-path" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see delete_path() in #svn_ra_reporter3_t for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_delete_path(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path); |
| |
| /** Send a "link-path" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see link_path() in #svn_ra_reporter3_t for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_link_path(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const char *url, |
| svn_revnum_t rev, |
| svn_boolean_t start_empty, |
| const char *lock_token, |
| svn_depth_t depth); |
| |
| /** Send a "finish-report" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see finish_report() in #svn_ra_reporter3_t for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_finish_report(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Send a "abort-report" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see abort_report() in #svn_ra_reporter3_t for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_abort_report(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Send a "reparent" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_reparent for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_reparent(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *url); |
| |
| /** Send a "get-latest-rev" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_latest_revnum for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_latest_rev(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** Send a "get-dated-rev" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_dated_revision for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_dated_rev(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| apr_time_t tm); |
| |
| /** Send a "change-rev-prop2" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * If @a dont_care is false then check that the old value matches |
| * @a old_value. If @a dont_care is true then do not check the old |
| * value; in this case @a old_value must be NULL. |
| * |
| * @see #svn_ra_change_rev_prop2 for the rest of the description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_change_rev_prop2(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *name, |
| const svn_string_t *value, |
| svn_boolean_t dont_care, |
| const svn_string_t *old_value); |
| |
| /** Send a "change-rev-prop" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_change_rev_prop for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_change_rev_prop(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *name, |
| const svn_string_t *value); |
| |
| /** Send a "rev-proplist" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_rev_proplist for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_rev_proplist(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev); |
| |
| /** Send a "rev-prop" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_rev_prop for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_rev_prop(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *name); |
| |
| /** Send a "get-file" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_file for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_file(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t rev, |
| svn_boolean_t props, |
| svn_boolean_t stream); |
| |
| /** Send a "update" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_do_update3 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_update(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *target, |
| svn_boolean_t recurse, |
| svn_depth_t depth, |
| svn_boolean_t send_copyfrom_args, |
| svn_boolean_t ignore_ancestry); |
| |
| /** Send a "switch" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_do_switch3 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_switch(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *target, |
| svn_boolean_t recurse, |
| const char *switch_url, |
| svn_depth_t depth, |
| svn_boolean_t send_copyfrom_args, |
| svn_boolean_t ignore_ancestry); |
| |
| /** Send a "status" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_do_status2 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_status(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *target, |
| svn_boolean_t recurse, |
| svn_revnum_t rev, |
| svn_depth_t depth); |
| |
| /** Send a "diff" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_do_diff3 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_diff(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| const char *target, |
| svn_boolean_t recurse, |
| svn_boolean_t ignore_ancestry, |
| const char *versus_url, |
| svn_boolean_t text_deltas, |
| svn_depth_t depth); |
| |
| /** Send a "check-path" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_check_path for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_check_path(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t rev); |
| |
| /** Send a "stat" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_stat for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_stat(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t rev); |
| |
| /** Send a "get-file-revs" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_file_revs2 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_file_revs(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t start, |
| svn_revnum_t end, |
| svn_boolean_t include_merged_revisions); |
| |
| /** Send a "lock" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_lock for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_lock(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const char *comment, |
| svn_boolean_t steal_lock, |
| svn_revnum_t revnum); |
| |
| /** Send a "unlock" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_unlock for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_unlock(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| const svn_string_t *token, |
| svn_boolean_t break_lock); |
| |
| /** Send a "get-lock" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_lock for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_lock(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path); |
| |
| /** Send a "get-locks" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_locks2 for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_locks(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_depth_t depth); |
| |
| /** Send a "replay" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_replay for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_replay(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t rev, |
| svn_revnum_t low_water_mark, |
| svn_boolean_t send_deltas); |
| |
| /** Send a "replay-range" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_replay_range for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_replay_range(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t start_revision, |
| svn_revnum_t end_revision, |
| svn_revnum_t low_water_mark, |
| svn_boolean_t send_deltas); |
| |
| /** Send a "get-deleted-rev" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_deleted_rev for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_deleted_rev(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t peg_revision, |
| svn_revnum_t end_revision); |
| |
| /** Send a "get-iprops" command over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @see #svn_ra_get_inherited_props for a description. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_get_iprops(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_revnum_t revision); |
| |
| /** Send a "finish-replay" command over connection @a conn. |
| * Use @a pool for allocations. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_cmd_finish_replay(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool); |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @defgroup svn_send_data sending data structures over ra_svn |
| * @{ |
| */ |
| |
| /** Send a changed path (as part of transmitting a log entry) over connection |
| * @a conn. Use @a pool for allocations. |
| * |
| * @see svn_log_changed_path2_t for a description of the other parameters. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_data_log_changed_path(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const svn_string_t *path, |
| char action, |
| const char *copyfrom_path, |
| svn_revnum_t copyfrom_rev, |
| svn_node_kind_t node_kind, |
| svn_boolean_t text_modified, |
| svn_boolean_t props_modified); |
| |
| /** Send a the details of a log entry (as part of transmitting a log entry |
| * and without revprops and changed paths) over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * @a author, @a date and @a message have been extracted and removed from |
| * the revprops to follow. @a has_children is taken directly from the |
| * #svn_log_entry_t struct. @a revision is too, except when it equals |
| * #SVN_INVALID_REVNUM. In that case, @a revision must be 0 and |
| * @a invalid_revnum be set to TRUE. @a revprop_count is the number of |
| * revprops that will follow in the revprops list. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_data_log_entry(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| svn_revnum_t revision, |
| const svn_string_t *author, |
| const svn_string_t *date, |
| const svn_string_t *message, |
| svn_boolean_t has_children, |
| svn_boolean_t invalid_revnum, |
| unsigned revprop_count); |
| |
| /** Send a directory entry @a dirent for @a path over connection @a conn. |
| * Use @a pool for allocations. |
| * |
| * Depending on the flags in @a dirent_fields, only selected elements will |
| * be transmitted. |
| */ |
| svn_error_t * |
| svn_ra_svn__write_dirent(svn_ra_svn_conn_t *conn, |
| apr_pool_t *pool, |
| const char *path, |
| svn_dirent_t *dirent, |
| apr_uint32_t dirent_fields); |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @defgroup svn_read_data reading data structures from ra_svn |
| * @{ |
| */ |
| |
| /** Take the data tuple ITEMS received over ra_svn and convert it to the |
| * a changed path (as part of receiving a log entry). |
| * |
| * @see svn_log_changed_path2_t for a description of the output parameters. |
| */ |
| svn_error_t * |
| svn_ra_svn__read_data_log_changed_entry(const svn_ra_svn__list_t *items, |
| svn_string_t **cpath, |
| const char **action, |
| const char **copy_path, |
| svn_revnum_t *copy_rev, |
| const char **kind_str, |
| apr_uint64_t *text_mods, |
| apr_uint64_t *prop_mods); |
| /** |
| * @} |
| */ |
| |
| #ifdef __cplusplus |
| } |
| #endif /* __cplusplus */ |
| |
| #endif /* SVN_RA_SVN_PRIVATE_H */ |