SVN二次开发——让SVN、TSVN(TortoiseSVN)支持windows的访问控制模型、NTFS ADS(可选数据流、NTFS的安全属性)

typedef struct _SECURITY_DESCRIPTOR {
    UCHAR Revision;
    UCHAR Sbz1;
    SECURITY_DESCRIPTOR_CONTROL Control;
    PSID Owner;
    PSID Group;
    PACL Sacl;
    PACL Dacl;
} SECURITY_DESCRIPTOR, *PISECURITY_DESCRIPTOR;

libsvn_ra_svnstreams.c
svn_ra_svn__stream_t * svn_ra_svn__stream_from_files(
apr_file_t *in_file, 
apr_file_t *out_file, 
apr_pool_t *pool)

svn_ra_svn__stream_t * svn_ra_svn__stream_from_sock(apr_socket_t *sock, 
apr_pool_t *pool)

sock_read_cb            libsvn_ra_svnstreams.c
　　↓
apr_socket_recv        APR
etwork_iowin32sendrecv.c。
　　↓                　　注：APR
etwork_io内有beos、os2、unix、win32四种os
WSARecv or recv        win socket接口

服务端                 　　　　客户端
svnservemain.c        libsvn_ra_svnclient.c
  ↓                     　↓
  +--->---－----/---－---<---+
              ↓
svn_ra_svn_create_conn                        libsvn_ra_svnmarshal.c
　　　　　　↓
svn_ra_svn__stream_from_sock                　libsvn_ra_svnstreams.c
　　　　　　↓
svn_ra_svn__stream_create(b,                 libsvn_ra_svnstreams.c
<----    sock_read_cb,                        创建svn_ra_svn__stream_t并
↓<---    sock_write_cb,                       使用这里的参数初始化他，并返
↓       sock_timeout_cb,                     回他的句柄。
↓       sock_pending_cb, pool)
↓
↓---->----
　　　　　↓
apr_socket_recv                       　　　　apr
etwork_iowin32sendrecv.c
apr_socket_send
　　　　　↓
recv or WSARecv                        　　　win socket
send or WSASend

main()主流程
　　↓
serve(conn, &params, connection_pool)        svnserveserve.c
　　↓
svn_ra_svn_handle_commands2(......)        libsvn_ra_svnmarshal.c
循环处理客户端发过来的各个命令，命令及其处理函数在svnserveserve.c文件中定义在report_commands[]、main_commands[]数组。见上面。
对于svn import处理的命令有：check_path、commit
　　↓
 (*command->handler)(conn, iterpool, params, baton) 
　　↓          下面以处理commit为例，即command->cmdname==“commit”
commit()                                        svnserveserve.c
　　↓
svn_repos_get_commit_editor5                libsvn_reposcommit.c
　　↓           设置：e->add_file=add_file，处理add_file编辑命令使用该函数
svn_ra_svn_drive_editor                        libsvn_ra_svneditorp.c
　　↓
svn_ra_svn_drive_editor2                        libsvn_ra_svneditorp.c
循环处理客户端发过来的各个editor命令，如：open-root、add-file、apply-textdelta、textdelta-chunk、textdelta-end、close-file、close-dir、close-edit
ra_svn_edit_cmds[]赋值初始化定义在editorp.c的后半部分
　　↓
 (*ra_svn_edit_cmds[i].handler)(conn, subpool, params, &state)
　　↓　对于"add-file"命令
ra_svn_handle_add_file                        libsvn_ra_svneditorp.c
通过客户端传过来的令牌token在ra_svn_driver_state_t *ds中找到操作的版本库。
　　↓
ds->editor->add_file(path, entry->baton, copy_path, copy_rev, ds->file_pool, &file_entry->baton))
在(libsvn_reposcommit.c的) svn_repos_get_commit_editor5函数中设置：e->add_file=add_file，见上面对svn_repos_get_commit_editor的调用
　　↓
add_file                                         libsvn_reposcommit.c
(const char *path, void *parent_baton, const char *copy_path,
         svn_revnum_t copy_revision, apr_pool_t *pool, void **file_baton)
　　↓
svn_fs_make_file(eb->txn_root, full_path, subpool) libsvn_fsfs-loader.c
　　↓
fs_make_file(svn_fs_root_t *root,            libsvn_fs_fs	ree.c
             const char *path,
             apr_pool_t *pool)
该函数将完成在版本中增加一个文件，但这个文件只有在执行close-edit命令后才会真正出现在版本仓库中。

main()                                              svnmain.c
　　↓
(*subcommand->cmd_func)(os, &command_baton, pool);
　　↓该调用在main()函数的最后。各子命令设置在子命令表svn_cl__cmd_table[]
svn_cl__import                                    svnimport-cmd.c
　　↓在svn_cl__import函数内用命令行参数设置到处路径path，path= ""为当前目录。
svn_client_import3(...,path,...)                libsvn_clientcommit.c
　　↓
get_ra_editor                                        libsvn_clientcommit.c
　　↓------------------ 建立网络连接 --------------------------
svn_client__open_ra_session_internal            libsvn_client
a.c
　　↓            ↓
　　　　　　svn_ra_open3                                 libsvn_ra
a_loader.c
　　↓            ↓
　　　　　　vtable->open_session(......)     在svn_ra_open3()函数内
　　↓           　↓     虚函数表vtable定义在libsvn_ra_svnclient.c内
　　　　　　ra_svn_open                                libsvn_ra_svnclient.c
　　↓            ↓
　　　　　　open_session                                libsvn_ra_svnclient.c
　　↓            ↓
　　　　　　make_connection-->apr_socket_connect-->win Socket的conn()建立连接
　　↓            ↓                                    libsvn_ra_svnclient.c
　　　　　svn_ra_svn_create_conn                    libsvn_ra_svnmarshal.c
　　↓----------------------- 网络连接已建立 -------------------
svn_ra_check_path                                    libsvn_ra
a_loader.c
　　↓  给服务端发送“check_path”命令。用于确认版本库URL存在。
　　↓            ↓
　　　　　vtable->check_path
　　↓            ↓ 虚函数表vtable定义在libsvn_ra_svnclient.c内
　　　　　ra_svn_check_path                            libsvn_ra_svnclient.c
　　↓            ↓
　　　　　svn_ra_svn_write_cmd(conn, pool, "check-path",...)
　　↓
svn_ra_get_commit_editor3                        　　libsvn_ra
a_loader.c
　　↓  给服务端发送“commit”命令。告诉服务端开始提交。
　　↓            ↓
　　　　　session->vtable->get_commit_editor
　　↓            ↓ 虚函数表vtable定义在libsvn_ra_svnclient.c内
　　　　　ra_svn_commit                                libsvn_ra_svnclient.c
　　↓            ↓
　　　　　svn_ra_svn_write_tuple(conn,..., "commit",...);
　　↓            ↓●
　　　　　svn_ra_svn_get_editor                    　　libsvn_ra_svneditorp.c
　　↓    设置编辑器使用的各个函数
　　↓
import    递归的向版本仓库导入文件或目录            　　　　libsvn_clientcommit.c
　　↓
import_dir-->import_file or 递归调用import_dir
　　or                                                libsvn_clientcommit.c
import_file 
　　↓        ↓
　　　　editor->add_file
　　↓        ↓        ↓
              　在(libsvn_ra_svneditorp.c的)svn_ra_svn_get_editor
　　↓        ↓  函数中设置：ra_svn_editor->add_file = ra_svn_add_file
　　　　　　　　　ra_svn_add_file                    libsvn_ra_svneditorp.c
　　↓        ↓    　　↓
　　　　　　　　　svn_ra_svn_write_cmd(b->conn, pool, "add-file", ...)
　　↓     　　↓                                        libsvn_ra_svneditorp.c
　　↓     　　↓
　　　　send_file_contents(path, file_baton, ...)    libsvn_clientcommit.c
　　　　该函数中使用的svn_stream_t 结构定义在libsvn_subrstream.c 
　　↓        ↓        ↓
　　　　　　　　　　editor->apply_textdelta
　　↓        ↓        ↓    该函数指针在上面的●处设置
　　　　　　　　　　ra_svn_apply_textdelta            libsvn_ra_svneditorp.c
　　↓        ↓        ↓        ↓★
　　　　　　　　　　　　　　svn_stream_set_write(diff_stream, ra_svn_svndiff_handler)
　　↓        ↓        ↓        ↓        ↓
                            　　　　svn_stream_set_write(..., svn_write_fn_t write_fn)
　　↓        ↓        ↓        ↓    stream->write_fn = write_fn        libsvn_ra_svneditorp.c
　　　　　　　　　　　　　　　　　　　　即：stream->write_fn = ra_svn_svndiff_handler 
　　↓        ↓        ↓        ↓
                        svn_txdelta_to_svndiff2    libsvn_deltasvndiff.c
　　↓        ↓        ↓    设置：*handler = window_handler
　　↓        ↓        ↓
        　　　　　svn_stream_open_readonly            libsvn_subrstream.c
　　↓        ↓       　↓ 打开要发送的文件
　　　　　　　　　　svn_txdelta_send_stream            libsvn_delta	ext_delta.c
　　↓        ↓                ↓
　　　　　　　　　　　　　　svn_txdelta_send_txstream    　　　libsvn_delta	ext_delta.c
　　↓        ↓                ↓
                        (*handler)(window, handler_baton)
　　↓     　　↓              　↓    该函数指针在上面的★处设置
　　　　　　　　　　　　　　window_handler            　　　　　libsvn_delta	ext_delta.c
　　↓        ↓                ↓
                        svn_stream_write            　　　　libsvn_subrstream.c
　　↓        ↓                ↓
　　　　　　　　　　　　　　stream->write_fn(stream->baton, data, len)
　　↓     　　↓                ↓ 该函数指针在上面的★处设置
                        　　ra_svn_svndiff_handler    　　　　　libsvn_ra_svneditorp.c
　　↓        ↓                ↓
　　　　　　　　　　　　　　svn_ra_svn_write_cmd(...,"textdelta-chunk","cs", b->token, &str)
　　↓        ↓
        editor->close_file
　　↓                ↓
　　↓            在(libsvn_ra_svneditorp.c的)svn_ra_svn_get_editor函数中设置：
　　　　　　　　　　ra_svn_editor->close_file = ra_svn_close_file
　　↓                ↓
                ra_svn_close_file                    libsvn_ra_svneditorp.c
　　↓                ↓
                svn_ra_svn_write_cmd(b->conn, pool, "close-file", "c(?c)", b->token, text_checksum);
　　↓            祥见“命令的发送”
　　↓
editor->close_edit(edit_baton, pool)
　　↓
ra_svn_close_edit                                    libsvn_ra_svneditorp.c
　　↓
svn_ra_svn_write_cmd                                libsvn_ra_svnmarshal.c
　　↓     见“发送一个命令”
svn_ra_svn_read_cmd_response                    　　　libsvn_ra_svnmarshal.c
　　↓                ↓读命令的回应
　　　　　　　　　svn_ra_svn_read_tuple               　libsvn_ra_svnmarshal.c
　　↓                ↓
　　　　　　　　　svn_ra_svn_read_item                 libsvn_ra_svnmarshal.c
　　↓
eb->callback(eb->callback_baton)
(svn_error_t *ra_svn_end_commit)                　　libsvn_ra_svnclient.c
　　↓
import函数结束