Csync: 实时文件同步守护进程的启动和配置教程

项目目录结构及介绍

clsync 是一个基于 inotify/kqueue/bsm (Linux, FreeBSD) 实现的文件实时同步守护进程，采用 GNU C 语言编写。其项目目录结构如下：

• doc: 存放项目文档。
• examples: 存放使用示例。
• freebsd/: FreeBSD 系统相关文件。
• m4: autoconf 相关宏定义。
• man/: man 手册页面。
• pkgconfig: pkgconfig 文件。
• rpm: RPM 打包相关文件。
• .doxygen: doxygen 配置文件。
• .gitignore: git 忽略文件。
• .travis.sh: Travis CI 脚本。
• .travis.yml: Travis CI 配置文件。
• CONTRIB: 贡献者列表。
• DEVELOPING: 开发者指南。
• GPL-3: GNU GPL-3 协议全文。
• LICENSE: 项目许可证文件。
• Makefile.am: autoconf 生成 Makefile 文件。
• NOTES: 项目笔记。
• PROTOCOL: 集群通信协议。
• README.md: 项目介绍。
• SHORTHANDS: 项目缩写说明。
• TODO: 待办事项。
• calc.c: 计算相关代码。
• calc.h: 计算相关头文件。
• cgroup.c: cgroup 相关代码。
• cgroup.h: cgroup 相关头文件。
• clsync.h: 项目核心头文件。
• cluster.c: 集群相关代码。
• cluster.h: 集群相关头文件。
• common.h: 公共头文件。
• configuration.h: 配置相关头文件。
• configure.ac: autoconf 配置文件。
• control.c: 控制相关代码。
• control.h: 控制相关头文件。
• ctx.h: 上下文相关头文件。
• error.c: 错误处理相关代码。
• error.h: 错误处理相关头文件。
• fileutils.c: 文件操作相关代码。
• fileutils.h: 文件操作相关头文件。
• gencompilerflags.c: 生成编译器标志相关代码。
• glibex.c: glib 扩展相关代码。
• glibex.h: glib 扩展相关头文件。
• indexes.c: 索引相关代码。
• indexes.h: 索引相关头文件。
• libclsync.c: 项目核心库代码。
• libclsync.h: 项目核心库头文件。
• macros.h: 宏定义头文件。
• main.c: 主程序代码。
• main.h: 主程序头文件。
• malloc.c: 内存分配相关代码。
• malloc.h: 内存分配相关头文件。
• mon_bsm.c: FreeBSD bsm 监控相关代码。
• mon_bsm.h: FreeBSD bsm 监控相关头文件。
• mon_dtracepipe.c: dtracepipe 监控相关代码。
• mon_dtracepipe.h: dtracepipe 监控相关头文件。
• mon_fanotify.c: fanotify 监控相关代码。
• mon_fanotify.h: fanotify 监控相关头文件。
• mon_gio.c: gio 监控相关代码。
• mon_gio.h: gio 监控相关头文件。
• mon_inotify.c: inotify 监控相关代码。
• mon_inotify.h: inotify 监控相关头文件。
• mon_kqueue.c: kqueue 监控相关代码。
• mon_kqueue.h: kqueue 监控相关头文件。
• port-hacks.h: 端口相关宏定义头文件。
• posix-hacks.c: POSIX 相关宏定义代码。
• posix-hacks.h: POSIX 相关宏定义头文件。
• privileged.c: 权限相关代码。
• privileged.h: 权限相关头文件。
• program.h.in: 程序配置头文件模板。
• pthreadex.c: pthread 扩展相关代码。
• pthreadex.h: pthread 扩展相关头文件。
• rules.c: 规则相关代码。
• rules.h: 规则相关头文件。
• socket.c: 套接字相关代码。
• socket.h: 套接字相关头文件。
• stringex.c: 字符串处理相关代码。
• stringex.h: 字符串处理相关头文件。
• sync.c: 同步相关代码。
• sync.h: 同步相关头文件。
• syscalls.c: 系统调用相关代码。
• syscalls.h: 系统调用相关头文件。

项目的启动文件介绍

clsync 的启动文件是 main.c，它是整个项目的入口点。该文件包含了主程序的主要逻辑，负责解析命令行参数、初始化配置、启动监控线程、执行文件同步操作等。主要功能如下：

1. 解析命令行参数，包括同步目录、监控模式、日志级别等。
2. 读取配置文件，设置项目运行参数。
3. 根据配置创建监控线程，对指定目录进行监控。
4. 监听监控事件，对文件进行同步操作。
5. 输出运行日志，方便调试和监控项目运行状态。

项目的配置文件介绍

clsync 的配置文件是 configuration.h，它定义了项目运行的各种参数。该文件主要包含以下配置项：

1. 监控目录：指定需要监控的目录，以便于实时同步文件。
2. 监控模式：选择 inotify、fanotify、kqueue 或 bsm 等监控方式。
3. 日志级别：设置日志输出级别，如 ERROR、WARN、INFO、DEBUG 等。
4. 同步间隔：设置文件同步的间隔时间，单位为秒。
5. 排除文件：指定不需要同步的文件类型或名称。
6. 同步权限：设置同步时是否保留文件权限。
7. 同步属性：设置同步时是否保留文件属性。
8. 同步所有权：设置同步时是否保留文件所有权。

通过修改配置文件中的参数，可以满足不同场景下的文件同步需求。在运行项目前，请确保配置文件参数设置正确，以达到最佳同步效果。