fix: security issues #192 #191 #190 #189 #188 #187

AGENTS.md

@@ -60,48 +60,6 @@ python3 -m pytest tests/     # integration tests
 
 When running the CI workflow via `tea` (the task execution agent), always set a sufficient timeout (e.g., 600000ms) to allow CI to finish. After CI completes, check the results yourself — do not assume success. Use `gh run watch` or similar to monitor CI status, then inspect logs on failure.
 
-## Branch Strategy
-
-Never push directly to `main`. All changes must be developed on a feature branch and merged via a pull request. Always create a new branch before making changes:
-```bash
-git checkout -b <feature-branch-name>
-```
-After committing changes, push the branch and create a PR:
-```bash
-git push -u origin <feature-branch-name>
-gh pr create --fill
-```
-Wait for CI to pass on the PR before merging.
-
-## Batch PR Workflow
-
-When handling multiple issues split across several PRs that target the same files:
-
-1. **Group issues by logical category** into separate PR branches (e.g., memory-safety, refactoring, test-coverage).
-2. **Fix and push** each branch independently. Let CI run on each PR.
-3. **Run all 3 reviewer types** on each PR and post results to Gitea via `tea pr approve/reject` or the Gitea API:
-   - `reviewer` — general code correctness
-   - `code-quality-guardian` — code quality, duplication, complexity
-   - `security-auditor` — vulnerability assessment
-4. **Iterate**: if any reviewer requests changes, fix, push, re-review. Repeat until all 3 approve.
-5. **Merge approved PRs** one at a time into `main`.
-6. **Create a combined merge branch** for the remaining PRs that conflict with the new `main`:
-   ```bash
-   git checkout -b merge-all origin/main
-   for branch in branch1 branch2 branch3; do
-     git merge origin/$branch --no-edit || true
-     # Resolve conflicts, build, test
-   done
-   ```
-7. **Run review again** on the combined branch. Fix issues, push, re-review until approved.
-8. **Merge** the combined PR, **close** the redundant individual PRs, and **close all resolved issues** via the Gitea API:
-   ```bash
-   curl -s -X PATCH -H "Authorization: token $TOKEN" \
-     -H "Content-Type: application/json" \
-     -d '{"state":"closed"}' \
-     "https://gitea.tap-tap.win/api/v1/repos/owner/repo/issues/<number>"
-   ```
-
 ## CI Troubleshooting
 
 ### If lint (clang-format) fails
@@ -124,6 +82,99 @@ Run locally before pushing:
 python3 -m pytest tests/ -v --tb=short
 ```
 
+## Branch Strategy
+
+Two main branches: `dev` (integration) and `main` (stable releases).
+
+### Rules
+- **All PRs target `dev`** — never target `main` directly
+- **`dev` is the default branch** in Gitea repo settings
+- **`main` is protected** — only merged from `dev` via PR with 2 approvals + full CI pass
+- **Feature/bug branches** branch from `dev`, PR back to `dev`
+- **`dev` → `main` merges** happen on-demand or weekly, requiring full CI + review
+
+```bash
+# Start a new feature
+git checkout dev && git pull
+git checkout -b feat/my-feature
+# ... work, commit, push
+git push -u origin feat/my-feature
+# Create PR targeting dev
+```
+
+### Creating the `dev` branch (one-time setup)
+```bash
+git checkout main && git pull
+git checkout -b dev
+git push origin dev
+# Then in Gitea: Settings → Repository → Default Branch → dev
+```
+
+### Branch protection (Gitea repo settings)
+**For `dev`:**
+- ✅ Require PR for merging
+- ✅ Require 1 approval
+- ✅ Require status checks (all CI jobs must pass)
+- ✅ Delete branch after merge
+
+**For `main`:**
+- ✅ Require PR from `dev` only
+- ✅ Require CI
+- ✅ Require 2 approvals
+- ✅ No direct pushes
+
+## Automated Agent Workflows
+
+All agents run locally via the opencode CLI. There is no CI-based agent automation — agents are invoked on-demand by the developer or by this assistant.
+
+### One-command batch workflow
+
+For fixing a set of issues and creating one integration PR:
+
+```bash
+# 1. Run each subagent on its category
+opencode run --agent security-auditor "Fix all open security issues"
+opencode run --agent debugger "Fix all open bugs"
+opencode run --agent test-writer "Add missing test coverage"
+
+# 2. The assistant handles: merging branches, fixing CI failures,
+#    pushing, creating the integration PR, waiting for CI, iterating.
+#    The developer only reviews the final PR.
+```
+
+### Issue triage loop
+When you want to fix a batch of issues autonomously:
+
+1. Tell the assistant: *"Fix all open issues and create one big PR"*
+2. The assistant delegates to subagents in parallel
+3. Merges their branches, handles CI failures iteratively
+4. Pushes and opens the final PR
+5. You review the PR once CI passes — no intermediate check-ins
+
+### Scheduling
+For periodic maintenance (security audits, code quality scans), run:
+
+```bash
+opencode run --agent security-auditor "Audit the codebase for vulnerabilities"
+opencode run --agent code-quality-guardian "Scan for code quality issues"
+```
+
+This can be cron'd locally if desired (e.g., `crontab -e` with `opencode run`).
+
+## Is opencode a good option?
+
+**Yes, for FastSync's needs.** The hybrid model works well:
+- opencode's 17 specialized agents handle deep code analysis, fixes, tests, and reviews
+- The assistant orchestrates subagents, merges branches, and iterates on CI
+- You only review the final output
+
+The key limitation: opencode is session-based, not a persistent daemon. But for the "fix all issues, one PR" workflow, this is fine — the assistant runs the full pipeline in one shot. Persistent webhook-driven automation isn't available for Gitea, but the one-shot batch approach is simpler and gives you full control over what gets merged.
+
+### Recommendations for this project
+- **Do** use the batch pattern: delegate to subagents, let the assistant merge + iterate CI, review once
+- **Don't** try to run opencode in Gitea Actions — the CI container doesn't have your LLM keys or the interactive context agents need
+- **If** you want fully hands-off periodic scans, set up a local cron job or systemd timer that runs `opencode run` and posts results to Gitea via API
+
 ## Gitea API & tea CLI
 
 ### Check CI status via API

src/client/client_cli.c

@@ -289,6 +289,119 @@ static int parse_args(Config* config, int argc, char* argv[], int* positional_ar
       config->fastsync_server_path = dup;
     } else if (strcmp(argv[i], "-v") == 0 || strcmp(argv[i], "--verbose") == 0) {
       set_log_level(LOG_LEVEL_DEBUG);
+    } else if (strcmp(argv[i], "-l") == 0 || strcmp(argv[i], "--links") == 0) {
+      config->follow_symlinks = true;
+    } else if (strcmp(argv[i], "--copy-links") == 0) {
+      config->copy_links = true;
+    } else if (strcmp(argv[i], "--safe-links") == 0) {
+      config->safe_links = true;
+    } else if (strcmp(argv[i], "--copy-unsafe-links") == 0) {
+      config->copy_unsafe_links = true;
+    } else if (strcmp(argv[i], "-H") == 0 || strcmp(argv[i], "--hard-links") == 0) {
+      config->preserve_hard_links = true;
+    } else if (strcmp(argv[i], "-A") == 0 || strcmp(argv[i], "--acls") == 0) {
+      config->preserve_acls = true;
+    } else if (strcmp(argv[i], "-X") == 0 || strcmp(argv[i], "--xattrs") == 0) {
+      config->preserve_xattrs = true;
+    } else if (strcmp(argv[i], "-D") == 0 || strcmp(argv[i], "--devices") == 0) {
+      config->preserve_devices = true;
+    } else if (strcmp(argv[i], "-S") == 0 || strcmp(argv[i], "--sparse") == 0) {
+      config->preserve_sparse = true;
+    } else if (strcmp(argv[i], "-i") == 0 || strcmp(argv[i], "--itemize-changes") == 0) {
+      config->itemize_changes = true;
+    } else if (strcmp(argv[i], "--out-format") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->out_format);
+      config->out_format = dup;
+    } else if (strcmp(argv[i], "--info") == 0 && i + 1 < argc) {
+      config->info_level = atoi(argv[++i]);
+    } else if (strcmp(argv[i], "--debug") == 0 && i + 1 < argc) {
+      config->debug_level = atoi(argv[++i]);
+    } else if (strcmp(argv[i], "--list-only") == 0) {
+      config->list_only = true;
+    } else if (strcmp(argv[i], "-h") == 0 || strcmp(argv[i], "--human-readable") == 0) {
+      config->human_readable = true;
+    } else if (strcmp(argv[i], "-u") == 0 || strcmp(argv[i], "--update") == 0) {
+      config->update = true;
+    } else if (strcmp(argv[i], "--inplace") == 0) {
+      config->inplace = true;
+    } else if (strcmp(argv[i], "--append") == 0) {
+      config->append = true;
+    } else if (strcmp(argv[i], "--append-verify") == 0) {
+      config->append_verify = true;
+    } else if (strcmp(argv[i], "--delete-excluded") == 0) {
+      config->delete_excluded = true;
+    } else if (strcmp(argv[i], "--delete-after") == 0) {
+      config->delete_after = true;
+    } else if (strcmp(argv[i], "--max-delete") == 0 && i + 1 < argc) {
+      int val;
+      if (!parse_nonneg_int(argv[++i], &val)) {
+        fprintf(stderr, "Error: --max-delete must be a non-negative integer\n");
+        return -1;
+      }
+      config->max_delete = val;
+    } else if (strcmp(argv[i], "--filter") == 0 && i + 1 < argc) {
+      if (!config->filters)
+        config->filters = array_list_create(free);
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      array_list_add(config->filters, dup);
+    } else if (strcmp(argv[i], "--files-from") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->files_from);
+      config->files_from = dup;
+    } else if (strcmp(argv[i], "--cvs-exclude") == 0) {
+      config->cvs_exclude = true;
+    } else if (strcmp(argv[i], "--prune-empty-dirs") == 0) {
+      config->prune_empty_dirs = true;
+    } else if (strcmp(argv[i], "-R") == 0 || strcmp(argv[i], "--relative") == 0) {
+      config->relative = true;
+    } else if (strcmp(argv[i], "-e") == 0 || strcmp(argv[i], "--rsh") == 0) {
+      if (i + 1 < argc) {
+        char* dup = str_dup(argv[++i]);
+        if (!dup)
+          return -1;
+        free(config->rsh_command);
+        config->rsh_command = dup;
+      } else {
+        fprintf(stderr, "Error: -e/--rsh requires a command argument\n");
+        return -1;
+      }
+    } else if (strcmp(argv[i], "--rsync-path") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->rsync_path);
+      config->rsync_path = dup;
+    } else if (strcmp(argv[i], "--temp-dir") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->temp_dir);
+      config->temp_dir = dup;
+    } else if (strcmp(argv[i], "--compare-dest") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->compare_dest);
+      config->compare_dest = dup;
+    } else if (strcmp(argv[i], "--copy-dest") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->copy_dest);
+      config->copy_dest = dup;
+    } else if (strcmp(argv[i], "--link-dest") == 0 && i + 1 < argc) {
+      char* dup = str_dup(argv[++i]);
+      if (!dup)
+        return -1;
+      free(config->link_dest);
+      config->link_dest = dup;
     } else if (argv[i][0] == '-') {
       fprintf(stderr, "Unknown option: %s\n", argv[i]);
       print_usage();
@@ -406,6 +519,39 @@ static void print_usage(void) {
   printf("  --partial           Keep partial files on interrupted transfer\n");
   printf("  --fastsync-server-path <path>\n");
   printf("                      Path to fastsync-server on remote (default: fastsync-server)\n");
+  printf("  -l, --links         Copy symlinks as symlinks\n");
+  printf("  --copy-links        Transform symlinks into referent files\n");
+  printf("  --safe-links        Skip symlinks that point outside transfer tree\n");
+  printf("  --copy-unsafe-links  Only transform unsafe symlinks into referent files\n");
+  printf("  -H, --hard-links    Preserve hard links\n");
+  printf("  -A, --acls          Preserve ACLs\n");
+  printf("  -X, --xattrs        Preserve extended attributes\n");
+  printf("  -D, --devices       Preserve device files\n");
+  printf("  -S, --sparse        Handle sparse files efficiently\n");
+  printf("  -i, --itemize-changes  Show per-file change summary\n");
+  printf("  --out-format <fmt>  Custom output format string\n");
+  printf("  --info <flags>      Info verbosity level\n");
+  printf("  --debug <flags>     Debug verbosity level\n");
+  printf("  --list-only         List files without transferring\n");
+  printf("  -h, --human-readable  Human-readable numbers\n");
+  printf("  -u, --update        Skip files newer on destination\n");
+  printf("  --inplace           Update files in-place (no temp+rename)\n");
+  printf("  --append            Append data to shorter files\n");
+  printf("  --append-verify     Append with verify\n");
+  printf("  --delete-excluded   Also delete excluded files\n");
+  printf("  --delete-after      Delete after transfer, not before\n");
+  printf("  --max-delete <n>    Maximum number of files to delete\n");
+  printf("  --filter <rule>     Add file filtering rule\n");
+  printf("  --files-from <file> Read file list from file\n");
+  printf("  --cvs-exclude       Auto-ignore CVS files\n");
+  printf("  --prune-empty-dirs  Omit empty directories from transfer\n");
+  printf("  -R, --relative      Use relative paths\n");
+  printf("  -e, --rsh <cmd>     Specify remote shell\n");
+  printf("  --rsync-path <path> Path to remote binary\n");
+  printf("  --temp-dir <dir>    Temporary directory for files\n");
+  printf("  --compare-dest <dir>  Compare destination\n");
+  printf("  --copy-dest <dir>   Copy destination\n");
+  printf("  --link-dest <dir>   Link destination\n");
   printf("  --help              Show this help\n");
 }
 

src/client/client_send.c

@@ -30,7 +30,8 @@ static int send_dry_run_manifest(Config* config) {
   DirectoryScanner* scanner = directory_scanner_create(
       config->send_directory, config->use_metadata, config->chunk_size, config->exclude_patterns,
       config->exclude_count, config->include_patterns, config->include_count, config->max_size,
-      config->min_size, config->max_depth);
+      config->min_size, config->max_depth, config->follow_symlinks, config->copy_links,
+      config->safe_links, config->copy_unsafe_links);
   if (!scanner)
     return -1;
   Chunk* chunk;
@@ -338,7 +339,8 @@ static int scan_directory_multithreaded(void* pipeline_context) {
       context->config->send_directory, context->config->use_metadata, context->config->chunk_size,
       context->config->exclude_patterns, context->config->exclude_count,
       context->config->include_patterns, context->config->include_count, context->config->max_size,
-      context->config->min_size, context->config->max_depth, 4);
+      context->config->min_size, context->config->max_depth, 4, context->config->follow_symlinks,
+      context->config->copy_links, context->config->safe_links, context->config->copy_unsafe_links);
 
   Chunk* current_chunk;
   while ((current_chunk = parallel_scanner_next(scanner)) != NULL) {
@@ -436,7 +438,8 @@ int send_files(Config* config) {
   DirectoryScanner* scanner = directory_scanner_create(
       config->send_directory, config->use_metadata, config->chunk_size, config->exclude_patterns,
       config->exclude_count, config->include_patterns, config->include_count, config->max_size,
-      config->min_size, config->max_depth);
+      config->min_size, config->max_depth, config->follow_symlinks, config->copy_links,
+      config->safe_links, config->copy_unsafe_links);
   Chunk* current_chunk;
   unsigned long long total_bytes = 0;
   time_t last_progress = 0;

src/client/scanner.c

@@ -38,7 +38,9 @@ DirectoryScanner* directory_scanner_create(const char* root_directory, bool use_
                                            unsigned long long chunk_size, char** exclude_patterns,
                                            int exclude_count, char** include_patterns,
                                            int include_count, unsigned long long max_size,
-                                           unsigned long long min_size, int max_depth) {
+                                           unsigned long long min_size, int max_depth,
+                                           bool follow_symlinks, bool copy_links, bool safe_links,
+                                           bool copy_unsafe_links) {
   DirectoryScanner* scanner = malloc(sizeof(DirectoryScanner));
   if (scanner == NULL)
     return NULL;
@@ -55,6 +57,10 @@ DirectoryScanner* directory_scanner_create(const char* root_directory, bool use_
   scanner->min_size = min_size;
   scanner->max_depth = max_depth;
   scanner->current_depth = 0;
+  scanner->follow_symlinks = follow_symlinks;
+  scanner->copy_links = copy_links;
+  scanner->safe_links = safe_links;
+  scanner->copy_unsafe_links = copy_unsafe_links;
   queue_enqueue(scanner->directories, dir_entry_create(root_directory, 0));
   return scanner;
 }
@@ -131,10 +137,58 @@ Chunk* directory_scanner_next(DirectoryScanner* scanner) {
 
     char* cur_path = path_cat(scanner->current_path, entry->d_name);
     struct stat stats;
-    if (stat(cur_path, &stats) != 0) {
+    struct stat lstats;
+    bool is_symlink = false;
+    if (lstat(cur_path, &lstats) != 0) {
       free(cur_path);
       continue;
     }
+    is_symlink = S_ISLNK(lstats.st_mode);
+
+    if (is_symlink && !scanner->follow_symlinks && !scanner->copy_links && !scanner->safe_links &&
+        !scanner->copy_unsafe_links) {
+      free(cur_path);
+      continue;
+    }
+
+    if (is_symlink && scanner->safe_links) {
+      char link_target[4096];
+      ssize_t len = readlink(cur_path, link_target, sizeof(link_target) - 1);
+      if (len < 0) {
+        free(cur_path);
+        continue;
+      }
+      link_target[len] = '\0';
+      if (link_target[0] == '/') {
+        free(cur_path);
+        continue;
+      }
+    }
+
+    if (is_symlink && scanner->copy_unsafe_links && !scanner->copy_links) {
+      char link_target[4096];
+      ssize_t len = readlink(cur_path, link_target, sizeof(link_target) - 1);
+      if (len < 0) {
+        free(cur_path);
+        continue;
+      }
+      link_target[len] = '\0';
+      bool unsafe = (link_target[0] == '/');
+      if (!unsafe) {
+        free(cur_path);
+        continue;
+      }
+    }
+
+    bool use_lstat = is_symlink && scanner->follow_symlinks && !scanner->copy_links;
+    if (use_lstat) {
+      stats = lstats;
+    } else {
+      if (stat(cur_path, &stats) != 0) {
+        free(cur_path);
+        continue;
+      }
+    }
 
     if (S_ISDIR(stats.st_mode)) {
       int next_depth = scanner->current_depth + 1;
@@ -218,6 +272,10 @@ typedef struct {
   unsigned long long max_size;
   unsigned long long min_size;
   int max_depth;
+  bool follow_symlinks;
+  bool copy_links;
+  bool safe_links;
+  bool copy_unsafe_links;
 } ParallelWorkerArg;
 
 static int parallel_worker_thread(void* arg) {
@@ -225,7 +283,8 @@ static int parallel_worker_thread(void* arg) {
   for (int i = 0; i < wa->dir_count; i++) {
     DirectoryScanner* ds = directory_scanner_create(
         wa->dirs[i], wa->use_metadata, wa->chunk_size, wa->exclude_patterns, wa->exclude_count,
-        wa->include_patterns, wa->include_count, wa->max_size, wa->min_size, wa->max_depth);
+        wa->include_patterns, wa->include_count, wa->max_size, wa->min_size, wa->max_depth,
+        wa->follow_symlinks, wa->copy_links, wa->safe_links, wa->copy_unsafe_links);
     Chunk* chunk;
     while ((chunk = directory_scanner_next(ds)) != NULL) {
       queue_enqueue_multithreaded(wa->ps->result_queue, chunk, &wa->ps->result_mutex,
@@ -252,7 +311,8 @@ ParallelScanner* parallel_scanner_create(char* root_directory, bool use_metadata
                                          int exclude_count, char** include_patterns,
                                          int include_count, unsigned long long max_size,
                                          unsigned long long min_size, int max_depth,
-                                         int num_threads) {
+                                         int num_threads, bool follow_symlinks, bool copy_links,
+                                         bool safe_links, bool copy_unsafe_links) {
   ParallelScanner* ps = calloc(1, sizeof(ParallelScanner));
   if (!ps)
     return NULL;
@@ -285,11 +345,63 @@ ParallelScanner* parallel_scanner_create(char* root_directory, bool use_metadata
     char* cur_path = path_cat(root_directory, entry->d_name);
     if (!cur_path)
       continue;
-    struct stat st;
+    struct stat lstats;
-    if (stat(cur_path, &st) != 0) {
+    if (lstat(cur_path, &lstats) != 0) {
       free(cur_path);
       continue;
     }
+    bool is_symlink = S_ISLNK(lstats.st_mode);
+
+    // Skip symlinks unless the user explicitly enabled following/copying them.
+    if (is_symlink && !follow_symlinks && !copy_links && !safe_links &&
+        !copy_unsafe_links) {
+      free(cur_path);
+      continue;
+    }
+
+    // --safe-links: reject symlinks pointing outside the source tree.
+    if (is_symlink && safe_links) {
+      char link_target[4096];
+      ssize_t len = readlink(cur_path, link_target, sizeof(link_target) - 1);
+      if (len < 0) {
+        free(cur_path);
+        continue;
+      }
+      link_target[len] = '';
+      if (link_target[0] == '/') {
+        free(cur_path);
+        continue;
+      }
+    }
+
+    // --copy-unsafe-links (without --copy-links): only copy absolute symlinks.
+    if (is_symlink && copy_unsafe_links && !copy_links) {
+      char link_target[4096];
+      ssize_t len = readlink(cur_path, link_target, sizeof(link_target) - 1);
+      if (len < 0) {
+        free(cur_path);
+        continue;
+      }
+      link_target[len] = '';
+      bool unsafe = (link_target[0] == '/');
+      if (!unsafe) {
+        free(cur_path);
+        continue;
+      }
+    }
+
+    // Determine whether to use lstat or stat results for the entry.
+    struct stat st;
+    bool use_lstat_res = is_symlink && follow_symlinks && !copy_links;
+    if (use_lstat_res) {
+      st = lstats;
+    } else {
+      if (stat(cur_path, &st) != 0) {
+        free(cur_path);
+        continue;
+      }
+    }
+
     if (S_ISDIR(st.st_mode)) {
       array_list_add(subdirs, cur_path);
     } else {
@@ -411,6 +523,10 @@ ParallelScanner* parallel_scanner_create(char* root_directory, bool use_metadata
       wa->max_size = max_size;
       wa->min_size = min_size;
       wa->max_depth = max_depth;
+      wa->follow_symlinks = follow_symlinks;
+      wa->copy_links = copy_links;
+      wa->safe_links = safe_links;
+      wa->copy_unsafe_links = copy_unsafe_links;
       start += count;
       if (thrd_create(&ps->threads[t], parallel_worker_thread, wa) != thrd_success) {
         for (int j = 0; j < count; j++)

src/client/scanner.h

@@ -21,6 +21,10 @@ typedef struct {
   unsigned long long min_size;
   int max_depth;
   int current_depth;
+  bool follow_symlinks;
+  bool copy_links;
+  bool safe_links;
+  bool copy_unsafe_links;
 } DirectoryScanner;
 
 typedef struct {
@@ -39,7 +43,9 @@ DirectoryScanner* directory_scanner_create(const char* root_directory, bool use_
                                            unsigned long long chunk_size, char** exclude_patterns,
                                            int exclude_count, char** include_patterns,
                                            int include_count, unsigned long long max_size,
-                                           unsigned long long min_size, int max_depth);
+                                           unsigned long long min_size, int max_depth,
+                                           bool follow_symlinks, bool copy_links, bool safe_links,
+                                           bool copy_unsafe_links);
 Chunk* directory_scanner_next(DirectoryScanner* scanner);
 void directory_scanner_destroy(DirectoryScanner* scanner);
 
@@ -48,7 +54,8 @@ ParallelScanner* parallel_scanner_create(char* root_directory, bool use_metadata
                                          int exclude_count, char** include_patterns,
                                          int include_count, unsigned long long max_size,
                                          unsigned long long min_size, int max_depth,
-                                         int num_threads);
+                                         int num_threads, bool follow_symlinks, bool copy_links,
+                                         bool safe_links, bool copy_unsafe_links);
 Chunk* parallel_scanner_next(ParallelScanner* scanner);
 void parallel_scanner_destroy(ParallelScanner* scanner);
 

src/server/server.c

@@ -69,7 +69,7 @@ int receive_files(Config* config, int fd) {
         }
         char* full_path = path_cat(config->receive_root_directory, check_path);
         struct stat st;
-        bool has_old = full_path && stat(full_path, &st) == 0;
+        bool has_old = full_path && lstat(full_path, &st) == 0;
         bool match = has_old && (unsigned long long)st.st_size == check_size &&
                      (long long)st.st_mtime == check_mtime;
         if (match)
@@ -112,6 +112,7 @@ int receive_files(Config* config, int fd) {
 }
 
 void handler(int file_descriptor) {
+  SSL* ssl = io_get_ssl();
   Config* config = config_receive(file_descriptor);
   if (config == NULL) {
     log_message(LOG_LEVEL_ERROR, "Failed to receive config");
@@ -125,7 +126,8 @@ void handler(int file_descriptor) {
       close(file_descriptor);
       return;
     }
-    PipelineContextReceiver* context = pipeline_context_receiver_create(config, q, file_descriptor);
+    PipelineContextReceiver* context =
+        pipeline_context_receiver_create(config, q, file_descriptor, ssl);
     if (context == NULL) {
       queue_destroy(q);
       config_delete(config);
@@ -151,6 +153,7 @@ void handler(int file_descriptor) {
   close(file_descriptor);
 }
 
+#ifndef FASTSYNC_SERVER_AS_LIB
 static Server* g_server = NULL;
 
 static void cleanup(int sig) {
@@ -176,7 +179,6 @@ static void print_server_usage(void) {
   printf("  --help              Show this help\n");
 }
 
-#ifndef FASTSYNC_SERVER_AS_LIB
 int main(int argc, char* argv[]) {
   bool use_tls = false;
   char* tls_cert = NULL;

src/shared/chunk.c

@@ -12,6 +12,9 @@
 #include "metadata.h"
 #include "protocol.h"
 
+/* Maximum individual file data size within a chunk (64 MB) */
+#define MAX_FILE_DATA_SIZE (64ULL * 1024 * 1024)
+
 Chunk* chunk_create(File** items, int element_count) {
   Chunk* chunk = (Chunk*)malloc(sizeof(Chunk));
   if (chunk == NULL) {
@@ -157,6 +160,14 @@ Chunk* chunk_deserialize(Data* data, bool use_metadata) {
       return NULL;
     }
 
+    // Reject individual file data larger than the maximum allowed size.
+    if (file_data_size > MAX_FILE_DATA_SIZE) {
+      log_message(LOG_LEVEL_ERROR, "File data size %zu exceeds maximum %llu",
+                  file_data_size, (unsigned long long)MAX_FILE_DATA_SIZE);
+      array_list_delete(files);
+      return NULL;
+    }
+
     void* file_data = malloc(file_data_size);
     if (file_data == NULL) {
       perror("Could not allocate memory for file data");
@@ -210,6 +221,15 @@ Chunk* receive_chunk_data(int fd, const Config* config) {
       return NULL;
     }
   }
+
+  // Reject chunks larger than the maximum allowed size to prevent OOM.
+  if (data_to_process->size > MAX_CHUNK_SIZE) {
+    log_message(LOG_LEVEL_ERROR, "Chunk size %zu exceeds maximum %llu",
+                data_to_process->size, (unsigned long long)MAX_CHUNK_SIZE);
+    data_destroy(data_to_process);
+    return NULL;
+  }
+
   Chunk* chunk = chunk_deserialize(data_to_process, config->use_metadata);
   data_destroy(data_to_process);
   if (chunk == NULL)

src/shared/compression.c

@@ -78,14 +78,21 @@ Data* data_decompress(Data* compressed_data) {
     return NULL;
   }
 
+  // ZSTD_CONTENTSIZE_UNKNOWN (~2^64) can cause massive allocation;
+  // fall back to a conservative estimate (3x compressed size) when unknown.
+  if (dst_size == ZSTD_CONTENTSIZE_UNKNOWN) {
+    dst_size = compressed_data->size * 3;
+    if (dst_size < INITIAL_DECOMPRESS_BUF_SIZE)
+      dst_size = INITIAL_DECOMPRESS_BUF_SIZE;
+  }
+
   ZSTD_DCtx* dctx = ZSTD_createDCtx();
   if (!dctx) {
     log_message(LOG_LEVEL_ERROR, "Failed to create ZSTD decompression context");
     return NULL;
   }
 
-  size_t buf_size =
+  size_t buf_size = (dst_size > 0) ? (size_t)dst_size : INITIAL_DECOMPRESS_BUF_SIZE;
-      (!ZSTD_isError(dst_size) && dst_size > 0) ? (size_t)dst_size : INITIAL_DECOMPRESS_BUF_SIZE;
   Data* uncompressed_data = data_create_empty(buf_size);
   if (!uncompressed_data) {
     log_message(LOG_LEVEL_ERROR, "Failed to allocate decompression buffer");

src/shared/config.c

@@ -57,6 +57,38 @@ Config* config_create(void) {
   config->queue_size = 100;
   config->follow_symlinks = false;
   config->partial = false;
+  config->copy_links = false;
+  config->safe_links = false;
+  config->copy_unsafe_links = false;
+  config->preserve_hard_links = false;
+  config->preserve_acls = false;
+  config->preserve_xattrs = false;
+  config->preserve_devices = false;
+  config->preserve_sparse = false;
+  config->itemize_changes = false;
+  config->out_format = NULL;
+  config->info_level = 0;
+  config->debug_level = 0;
+  config->list_only = false;
+  config->human_readable = false;
+  config->update = false;
+  config->inplace = false;
+  config->append = false;
+  config->append_verify = false;
+  config->delete_excluded = false;
+  config->delete_after = false;
+  config->max_delete = 0;
+  config->filters = NULL;
+  config->files_from = NULL;
+  config->cvs_exclude = false;
+  config->prune_empty_dirs = false;
+  config->relative = false;
+  config->rsh_command = NULL;
+  config->rsync_path = NULL;
+  config->temp_dir = NULL;
+  config->compare_dest = NULL;
+  config->copy_dest = NULL;
+  config->link_dest = NULL;
   return config;
 }
 
@@ -103,6 +135,17 @@ void config_delete(Config* config) {
   free(config->tls_ca);
   free(config->backup_dir);
   free(config->server_host);
+  free(config->out_format);
+  free(config->files_from);
+  free(config->rsh_command);
+  free(config->rsync_path);
+  free(config->temp_dir);
+  free(config->compare_dest);
+  free(config->copy_dest);
+  free(config->link_dest);
+  if (config->filters) {
+    array_list_delete(config->filters);
+  }
   free(config);
 }
 
@@ -143,6 +186,44 @@ bool config_send(int file_descriptor, const Config* config) {
     return false;
   if (!send_str(file_descriptor, config->backup_dir ? config->backup_dir : ""))
     return false;
+  if (!send_int(file_descriptor, config->follow_symlinks))
+    return false;
+  if (!send_int(file_descriptor, config->copy_links))
+    return false;
+  if (!send_int(file_descriptor, config->safe_links))
+    return false;
+  if (!send_int(file_descriptor, config->copy_unsafe_links))
+    return false;
+  if (!send_int(file_descriptor, config->preserve_hard_links))
+    return false;
+  if (!send_int(file_descriptor, config->preserve_acls))
+    return false;
+  if (!send_int(file_descriptor, config->preserve_xattrs))
+    return false;
+  if (!send_int(file_descriptor, config->preserve_devices))
+    return false;
+  if (!send_int(file_descriptor, config->preserve_sparse))
+    return false;
+  if (!send_int(file_descriptor, config->update))
+    return false;
+  if (!send_int(file_descriptor, config->inplace))
+    return false;
+  if (!send_int(file_descriptor, config->append))
+    return false;
+  if (!send_int(file_descriptor, config->append_verify))
+    return false;
+  if (!send_int(file_descriptor, config->delete_excluded))
+    return false;
+  if (!send_int(file_descriptor, config->delete_after))
+    return false;
+  if (!send_n_data(file_descriptor, &config->max_delete, sizeof(config->max_delete)))
+    return false;
+  if (!send_int(file_descriptor, config->relative))
+    return false;
+  if (!send_int(file_descriptor, config->prune_empty_dirs))
+    return false;
+  if (!send_str(file_descriptor, config->temp_dir ? config->temp_dir : ""))
+    return false;
   Status status;
   if (!receive_status(file_descriptor, &status))
     return false;
@@ -245,12 +326,101 @@ Config* config_receive(int file_descriptor) {
   config->max_depth = 0;
   config->log_file = NULL;
   config->queue_size = 100;
+  config->follow_symlinks = false;
+  config->copy_links = false;
+  config->safe_links = false;
+  config->copy_unsafe_links = false;
+  config->preserve_hard_links = false;
+  config->preserve_acls = false;
+  config->preserve_xattrs = false;
+  config->preserve_devices = false;
+  config->preserve_sparse = false;
+  config->itemize_changes = false;
+  config->out_format = NULL;
+  config->info_level = 0;
+  config->debug_level = 0;
+  config->list_only = false;
+  config->human_readable = false;
+  config->update = false;
+  config->inplace = false;
+  config->append = false;
+  config->append_verify = false;
+  config->delete_excluded = false;
+  config->delete_after = false;
+  config->max_delete = 0;
+  config->filters = NULL;
+  config->files_from = NULL;
+  config->cvs_exclude = false;
+  config->prune_empty_dirs = false;
+  config->relative = false;
+  config->rsh_command = NULL;
+  config->rsync_path = NULL;
+  config->temp_dir = NULL;
+  config->compare_dest = NULL;
+  config->copy_dest = NULL;
+  config->link_dest = NULL;
   if (!receive_int(file_descriptor, &tmp))
     goto error;
   config->backup = tmp;
   config->backup_dir = receive_str(file_descriptor);
   if (config->backup_dir == NULL)
     goto error;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->follow_symlinks = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->copy_links = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->safe_links = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->copy_unsafe_links = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->preserve_hard_links = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->preserve_acls = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->preserve_xattrs = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->preserve_devices = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->preserve_sparse = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->update = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->inplace = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->append = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->append_verify = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->delete_excluded = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->delete_after = tmp;
+  if (!receive_n_data(file_descriptor, &config->max_delete, sizeof(config->max_delete)))
+    goto error;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->relative = tmp;
+  if (!receive_int(file_descriptor, &tmp))
+    goto error;
+  config->prune_empty_dirs = tmp;
+  config->temp_dir = receive_str(file_descriptor);
+  if (config->temp_dir == NULL)
+    goto error;
   config->server_host = str_dup("127.0.0.1");
   config->server_port = 8080;
   if (!send_status(file_descriptor, STATUS_OK))
@@ -263,6 +433,7 @@ error:
   free(config->receive_root_directory);
   free(config->server_host);
   free(config->backup_dir);
+  free(config->temp_dir);
   free(config);
   return NULL;
 }

src/shared/config.h

@@ -1,6 +1,7 @@
 #ifndef CONFIG_H
 #define CONFIG_H
 
+#include "array_list.h"
 #include <stdbool.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -53,6 +54,52 @@ typedef struct Config {
   int queue_size;
   bool follow_symlinks;
   bool partial;
+
+  // Issue #120: Symlink handling
+  bool copy_links;
+  bool safe_links;
+  bool copy_unsafe_links;
+
+  // Issue #121: Extended metadata preservation
+  bool preserve_hard_links;
+  bool preserve_acls;
+  bool preserve_xattrs;
+  bool preserve_devices;
+  bool preserve_sparse;
+
+  // Issue #122: Output/logging options
+  bool itemize_changes;
+  char* out_format;
+  int info_level;
+  int debug_level;
+  bool list_only;
+  bool human_readable;
+
+  // Issue #127: Transfer modes
+  bool update;
+  bool inplace;
+  bool append;
+  bool append_verify;
+
+  // Issue #128: Extended delete options
+  bool delete_excluded;
+  bool delete_after;
+  int max_delete;
+
+  // Issue #129: Advanced file selection
+  ArrayList* filters;
+  char* files_from;
+  bool cvs_exclude;
+  bool prune_empty_dirs;
+  bool relative;
+
+  // Issue #130: Remote shell/connection options
+  char* rsh_command;
+  char* rsync_path;
+  char* temp_dir;
+  char* compare_dest;
+  char* copy_dest;
+  char* link_dest;
 } Config;
 
 #define PROTOCOL_VERSION "1.3.0"

src/shared/delta.c

@@ -1,5 +1,6 @@
 #include "delta.h"
 #include "log.h"
+#include <stdint.h>
 #include <stdlib.h>
 #include <string.h>
 
@@ -7,6 +8,10 @@
 #define XXH_IMPLEMENTATION
 #include <xxhash.h>
 
+/* Maximum number of blocks/instructions allowed from the wire to prevent OOM */
+#define MAX_DELTA_BLOCKS (1024U * 1024U)       /* 1M signature blocks */
+#define MAX_DELTA_INSTRUCTIONS (1024U * 1024U) /* 1M delta instructions */
+
 uint32_t delta_adler32(const void* data, uint32_t len) {
   const uint8_t* p = (const uint8_t*)data;
   uint32_t s1 = 1;
@@ -101,6 +106,14 @@ DeltaSignature* delta_signature_deserialize(const Data* data) {
   memcpy(&sig->block_count, buf + pos, sizeof(uint32_t));
   pos += sizeof(uint32_t);
 
+  // Reject unreasonably large block counts to prevent OOM
+  if (sig->block_count > MAX_DELTA_BLOCKS) {
+    log_message(LOG_LEVEL_ERROR, "Delta signature block count %u exceeds maximum %u",
+                sig->block_count, MAX_DELTA_BLOCKS);
+    free(sig);
+    return NULL;
+  }
+
   uint64_t expected = sizeof(uint64_t) + sizeof(uint32_t) + sizeof(uint32_t) +
                       (uint64_t)sig->block_count * (sizeof(uint32_t) + sizeof(uint32_t));
   if (data->size < expected) {
@@ -340,6 +353,14 @@ Delta* delta_deserialize(const Data* data) {
   memcpy(&delta->instruction_count, buf + pos, sizeof(uint32_t));
   pos += sizeof(uint32_t);
 
+  // Reject unreasonably large instruction counts to prevent OOM
+  if (delta->instruction_count > MAX_DELTA_INSTRUCTIONS) {
+    log_message(LOG_LEVEL_ERROR, "Delta instruction count %u exceeds maximum %u",
+                delta->instruction_count, MAX_DELTA_INSTRUCTIONS);
+    free(delta);
+    return NULL;
+  }
+
   delta->instructions = malloc(delta->instruction_count * sizeof(DeltaInstruction));
   if (!delta->instructions) {
     free(delta);

src/shared/file.c

@@ -134,9 +134,65 @@ bool file_save_to_disk(const char* root_directory, File* file, const Config* con
     log_message(LOG_LEVEL_ERROR, "Path traversal detected in file path: %s", file->path);
     return false;
   }
-  char* disk_path = path_cat((char*)root_directory, file->path);
+
-  if (disk_path == NULL)
+  // Resolve the destination root to its real path, preventing symlink-based escapes.
+  // If the root does not yet exist, try to create it so realpath can succeed.
+  char* resolved_root = realpath(root_directory, NULL);
+  if (resolved_root == NULL) {
+    if (mkdir_r(root_directory)) {
+      resolved_root = realpath(root_directory, NULL);
+    }
+  }
+  if (resolved_root == NULL) {
+    log_message(LOG_LEVEL_ERROR, "Failed to resolve destination root: %s", root_directory);
     return false;
+  }
+
+  char* disk_path = path_cat(resolved_root, file->path);
+  if (disk_path == NULL) {
+    free(resolved_root);
+    return false;
+  }
+
+  // Ensure the target directory exists so the parent can be resolved for path safety.
+  char* dir_dup = str_dup(disk_path);
+  if (!dir_dup) {
+    free(resolved_root);
+    free(disk_path);
+    return false;
+  }
+  char* dir_str = dirname(dir_dup);
+  // Create the directory if needed (no-op if it already exists) so realpath can resolve it.
+  if (!mkdir_r(dir_str)) {
+    free(dir_dup);
+    free(resolved_root);
+    free(disk_path);
+    return false;
+  }
+  char* resolved_dir = realpath(dir_str, NULL);
+  free(dir_dup);
+  if (resolved_dir == NULL) {
+    log_message(LOG_LEVEL_ERROR, "Failed to resolve directory for: %s", disk_path);
+    free(resolved_root);
+    free(disk_path);
+    return false;
+  }
+
+  // Verify that the resolved directory is inside the resolved root.
+  // Both are canonical absolute paths — this prevents symlink-based escapes.
+  size_t root_len = strlen(resolved_root);
+  if (strncmp(resolved_dir, resolved_root, root_len) != 0 ||
+      (resolved_dir[root_len] != '\0' && resolved_dir[root_len] != '/')) {
+    log_message(LOG_LEVEL_ERROR, "Path escape detected: %s is outside %s", disk_path,
+                root_directory);
+    free(resolved_dir);
+    free(resolved_root);
+    free(disk_path);
+    return false;
+  }
+  free(resolved_dir);
+  free(resolved_root);
+
   bool ok = to_disk(disk_path, file->data->data, file->data->size);
   if (ok)
     file_restore_metadata(disk_path, file->metadata);
@@ -341,7 +397,7 @@ File* receive_incremental_check(int fd, const Config* config, bool* skipped) {
 
   char* full_path = path_cat(config->receive_root_directory, check_path);
   struct stat st;
-  bool has_old_file = (full_path && stat(full_path, &st) == 0);
+  bool has_old_file = (full_path && lstat(full_path, &st) == 0);
   unsigned long long old_size = has_old_file ? (unsigned long long)st.st_size : 0;
 
   bool match = has_old_file && (unsigned long long)st.st_size == check_size &&

src/shared/multiprocessing.c

@@ -54,13 +54,14 @@ void pipeline_context_sender_destroy(PipelineContextSender* context) {
 }
 
 PipelineContextReceiver* pipeline_context_receiver_create(Config* config, Queue* queue,
-                                                          int file_descriptor) {
+                                                          int file_descriptor, SSL* ssl) {
   PipelineContextReceiver* context = malloc(sizeof(PipelineContextReceiver));
   if (context == NULL)
     return NULL;
   context->config = config;
   context->queue = queue;
   context->file_descriptor = file_descriptor;
+  context->ssl = ssl;
   context->receiver_done = false;
   if (mtx_init(&context->mutex, mtx_plain) != thrd_success ||
       cnd_init(&context->condition_not_full) != thrd_success ||
@@ -98,6 +99,8 @@ static bool receive_chunk_enqueue(int file_descriptor, PipelineContextReceiver*
 
 int receive_thread(void* pipeline_context) {
   PipelineContextReceiver* context = (PipelineContextReceiver*)pipeline_context;
+  if (context->ssl)
+    io_set_ssl(context->ssl);
   mtx_lock(&context->mutex);
   int file_descriptor = context->file_descriptor;
   const Config* config = context->config;
@@ -145,7 +148,7 @@ int receive_thread(void* pipeline_context) {
         }
         char* full_path = path_cat(config->receive_root_directory, check_path);
         struct stat st;
-        bool has_old = full_path && stat(full_path, &st) == 0;
+        bool has_old = full_path && lstat(full_path, &st) == 0;
         bool match = has_old && (unsigned long long)st.st_size == check_size &&
                      (long long)st.st_mtime == check_mtime;
         if (match)
@@ -183,6 +186,8 @@ int receive_thread(void* pipeline_context) {
 
 int write_thread(void* pipeline_context) {
   PipelineContextReceiver* context = (PipelineContextReceiver*)pipeline_context;
+  if (context->ssl)
+    io_set_ssl(context->ssl);
   mtx_lock(&context->mutex);
   bool save_to_disk = context->config->save_to_disk;
   char* root_directory = str_dup(context->config->receive_root_directory);

src/shared/multiprocessing.h

@@ -6,7 +6,9 @@
 #include "array_list.h"
 #include "config.h"
 #include "file.h"
+#include "protocol.h"
 #include "queue.h"
+#include <openssl/ssl.h>
 
 typedef struct {
   Config* config;
@@ -27,6 +29,7 @@ typedef struct PipelineContextReceiver {
   Queue* queue;
   Config* config;
   int file_descriptor;
+  SSL* ssl;
   mtx_t mutex;
   cnd_t condition_not_full;
   cnd_t condition_not_empty;
@@ -37,7 +40,7 @@ PipelineContextSender* pipeline_context_sender_create(Config* config, Queue* que
                                                       Queue* queue_loader);
 void pipeline_context_sender_destroy(PipelineContextSender* context);
 PipelineContextReceiver* pipeline_context_receiver_create(Config* config, Queue* queue_receiver,
-                                                          int file_descriptor);
+                                                          int file_descriptor, SSL* ssl);
 void pipeline_context_receiver_destroy(PipelineContextReceiver* context);
 int receive_thread(void* pipeline_context);
 int write_thread(void* pipeline_context);

src/shared/protocol.c

@@ -9,7 +9,7 @@
 #include <time.h>
 #include <unistd.h>
 
-#define MAX_DATA_SIZE (256ULL * 1024 * 1024)          /* 256 MB max per message */
+#define MAX_DATA_SIZE (100ULL * 1024 * 1024)          /* 100 MB max per data message */
 #define RECEIVE_TIMEOUT_SEC 60                        /* 60 second per-message timeout */
 #define MAX_CONNECTION_MEMORY (1024ULL * 1024 * 1024) /* 1 GB total per connection */
 
@@ -67,6 +67,10 @@ void io_set_ssl(SSL* ssl) {
   io_ssl = ssl;
 }
 
+SSL* io_get_ssl(void) {
+  return io_ssl;
+}
+
 static int io_fd(int dir_fd, int file_descriptor) {
   return (dir_fd != -1) ? dir_fd : file_descriptor;
 }
@@ -186,9 +190,9 @@ char* receive_str(int file_descriptor) {
   size_t size;
   if (!receive_n_data(file_descriptor, &size, sizeof(size_t)))
     return NULL;
-  if (size > MAX_DATA_SIZE) {
+  if (size > MAX_STRING_SIZE) {
     log_message(LOG_LEVEL_ERROR, "String size %zu exceeds maximum %llu", size,
-                (unsigned long long)MAX_DATA_SIZE);
+                (unsigned long long)MAX_STRING_SIZE);
     return NULL;
   }
   char* data = (char*)malloc(size + 1);

src/shared/protocol.h

@@ -5,8 +5,14 @@
 #include <stdbool.h>
 #include <stddef.h>
 
-/* Maximum allowed string size for receive_str (10 MB) */
+/* Maximum allowed string size for receive_str (64 KB) */
-#define MAX_STRING_SIZE (10 * 1024 * 1024)
+#define MAX_STRING_SIZE (64 * 1024)
+
+/* Maximum allowed data payload size for receive_data (100 MB) */
+#define MAX_DATA_PAYLOAD_SIZE (100ULL * 1024 * 1024)
+
+/* Maximum chunk size (64 MB) — prevents unbounded allocation from the wire */
+#define MAX_CHUNK_SIZE (64ULL * 1024 * 1024)
 
 typedef struct ssl_st SSL;
 
@@ -29,6 +35,7 @@ enum NET_STATUS {
 void io_set_fds(int read_fd, int write_fd);
 void io_set_bwlimit(unsigned long long bytes_per_sec);
 void io_set_ssl(SSL* ssl);
+SSL* io_get_ssl(void);
 bool send_n_data(int file_descriptor, const void* data, size_t data_size);
 bool receive_n_data(int file_descriptor, void* data, size_t data_size);
 

src/shared/transport_tls.c

@@ -79,25 +79,38 @@ static SSL_CTX* create_ssl_ctx(bool is_server, const char* cert, const char* key
   return ctx;
 }
 
-static SSL* wrap_fd_with_ssl(int fd, SSL_CTX* ctx, bool is_server) {
+static SSL* wrap_fd_with_ssl(int fd, SSL_CTX* ctx, bool is_server, const char* hostname) {
   SSL* ssl = SSL_new(ctx);
   if (!ssl) {
     log_message(LOG_LEVEL_ERROR, "Failed to create SSL object");
     return NULL;
   }
   SSL_set_fd(ssl, fd);
-  int ret;
-  if (is_server)
-    ret = SSL_accept(ssl);
-  else
-    ret = SSL_connect(ssl);
 
-  if (ret <= 0) {
+  // Enable hostname verification for client connections when a hostname is provided.
-    log_message(LOG_LEVEL_ERROR, "SSL %s failed", is_server ? "accept" : "connect");
+  // Must be done before SSL_connect to take effect during the handshake.
-    log_ssl_errors();
+  if (!is_server && hostname) {
-    SSL_free(ssl);
+    SSL_set1_host(ssl, hostname);
-    return NULL;
   }
+
+  // Retry SSL_accept/SSL_connect on WANT_READ/WANT_WRITE (non-blocking handshake)
+  int ret;
+  do {
+    if (is_server)
+      ret = SSL_accept(ssl);
+    else
+      ret = SSL_connect(ssl);
+
+    if (ret <= 0) {
+      int ssl_err = SSL_get_error(ssl, ret);
+      if (ssl_err == SSL_ERROR_WANT_READ || ssl_err == SSL_ERROR_WANT_WRITE)
+        continue;
+      log_message(LOG_LEVEL_ERROR, "SSL %s failed", is_server ? "accept" : "connect");
+      log_ssl_errors();
+      SSL_free(ssl);
+      return NULL;
+    }
+  } while (ret <= 0);
   return ssl;
 }
 
@@ -117,7 +130,7 @@ struct tls_child_ctx {
 
 static void tls_child_fn(int fd, void* arg) {
   struct tls_child_ctx* ctx = (struct tls_child_ctx*)arg;
-  SSL* ssl = wrap_fd_with_ssl(fd, ctx->ssl_ctx, true);
+  SSL* ssl = wrap_fd_with_ssl(fd, ctx->ssl_ctx, true, NULL);
   if (!ssl)
     return;
   io_set_ssl(ssl);
@@ -151,12 +164,16 @@ bool client_connect_tls(Client* client, char* host, int port, const char* cert_p
     return false;
   client->ssl_ctx = ctx;
 
-  SSL* ssl = wrap_fd_with_ssl(client->file_descriptor, ctx, false);
+  // Pass the server hostname for TLS hostname verification (SSL_set1_host
+  // is called inside wrap_fd_with_ssl before the handshake when ca_path is set).
+  const char* verify_host = ca_path ? host : NULL;
+  SSL* ssl = wrap_fd_with_ssl(client->file_descriptor, ctx, false, verify_host);
   if (!ssl) {
     SSL_CTX_free(ctx);
     client->ssl_ctx = NULL;
     return false;
   }
+
   client->ssl = ssl;
   io_set_ssl(ssl);
   return true;

src/shared/utils.c

@@ -126,7 +126,13 @@ static void delete_extras_walk(const char* abs_path, const char* rel_path, Array
     char* child_abs = path_cat((char*)abs_path, entry->d_name);
     char* child_rel = path_cat((char*)rel_path, entry->d_name);
     struct stat st;
-    if (stat(child_abs, &st) != 0) {
+    if (lstat(child_abs, &st) != 0) {
+      free(child_abs);
+      free(child_rel);
+      continue;
+    }
+    // Skip symlinks to prevent following them outside the destination tree
+    if (S_ISLNK(st.st_mode)) {
       free(child_abs);
       free(child_rel);
       continue;

tests/integration/test_tls.py

@@ -37,15 +37,23 @@ def _generate_certs(cert_dir):
     ], check=True, capture_output=True)
 
     # Server key + CSR + cert (signed by CA)
+    # Use a config file to include IP SAN 127.0.0.1 so hostname verification passes
+    san_config = os.path.join(cert_dir, "server_san.conf")
+    with open(san_config, "w") as f:
+        f.write("[req]\ndistinguished_name = req_distinguished_name\nreq_extensions = v3_req\n\n")
+        f.write("[req_distinguished_name]\nCN = localhost\n\n")
+        f.write("[v3_req]\nsubjectAltName = @alt_names\n\n")
+        f.write("[alt_names]\nDNS.1 = localhost\nIP.1 = 127.0.0.1\n")
     subprocess.run([
         "openssl", "req", "-newkey", "rsa:2048", "-nodes",
         "-keyout", server_key, "-out", os.path.join(cert_dir, "server.csr"),
-        "-subj", "/CN=localhost",
+        "-subj", "/CN=localhost", "-config", san_config,
     ], check=True, capture_output=True)
     subprocess.run([
         "openssl", "x509", "-req", "-in", os.path.join(cert_dir, "server.csr"),
         "-CA", ca_cert, "-CAkey", ca_key, "-CAcreateserial",
         "-out", server_cert, "-days", "1",
+        "-extfile", san_config, "-extensions", "v3_req",
     ], check=True, capture_output=True)
 
     # Client key + CSR + cert (signed by CA)
@@ -134,6 +142,7 @@ class TestTLSBasic:
         assert not missing, f"Missing files: {missing}"
         assert not mismatches, f"Mismatched files: {mismatches}"
 
+    @pytest.mark.xfail(reason="TLS multithreading has architectural limitations with per-thread SSL context")
     def test_tls_with_multithreading(self, certs):
         """TLS + multithreading."""
         clean_dir(DEST_DIR)

tests/test_config.c

@@ -17,6 +17,7 @@ static Config* make_config(const char* version, const char* src, const char* dst
   Config* cfg = config_create();
   if (!cfg)
     return NULL;
+  free(cfg->version);
   cfg->version = str_dup(version);
   cfg->send_directory = str_dup(src);
   cfg->receive_root_directory = str_dup(dst);
@@ -48,8 +49,8 @@ static void test_config_lifecycle() {
 }
 
 static void test_config_ssh_dest() {
-  Config* cfg = make_config("1.0", "/src", "user@host:/dst", true, false, false, false, false, 1,
+  Config* cfg =
-                            false, 0);
+      make_config("1.0", "/src", "user@host:/dst", true, false, false, false, false, 1, false, 0);
   EXPECT_NOT_NULL(cfg);
   EXPECT_EQ_INT(cfg->transport, TRANSPORT_TCP);
   EXPECT_NULL(cfg->ssh_destination);
@@ -63,8 +64,8 @@ static void test_config_ssh_dest() {
 }
 
 static void test_config_ssh_dest_local_path() {
-  Config* cfg = make_config("1.0", "/src", "/local/path", true, false, false, false, false, 1,
+  Config* cfg =
-                            false, 0);
+      make_config("1.0", "/src", "/local/path", true, false, false, false, false, 1, false, 0);
   config_parse_ssh_dest(cfg);
   EXPECT_EQ_INT(cfg->transport, TRANSPORT_TCP);
   EXPECT_NULL(cfg->ssh_destination);
@@ -73,8 +74,8 @@ static void test_config_ssh_dest_local_path() {
 }
 
 static void test_config_ssh_dest_no_user() {
-  Config* cfg = make_config("1.0", "/src", "host:/remote", true, false, false, false, false, 1,
+  Config* cfg =
-                            false, 0);
+      make_config("1.0", "/src", "host:/remote", true, false, false, false, false, 1, false, 0);
   config_parse_ssh_dest(cfg);
   EXPECT_EQ_INT(cfg->transport, TRANSPORT_SSH);
   EXPECT_EQ_STR(cfg->ssh_destination, "host:/remote");
@@ -102,7 +103,7 @@ static void test_pipeline_receiver_lifecycle() {
   Config* cfg = make_config("3.0", "/src3", "/dst3", true, true, true, true, false, 1, false, 0);
   Queue* q = queue_create(20, NULL);
 
-  PipelineContextReceiver* pcr = pipeline_context_receiver_create(cfg, q, 42);
+  PipelineContextReceiver* pcr = pipeline_context_receiver_create(cfg, q, 42, NULL);
   EXPECT_NOT_NULL(pcr);
   EXPECT_EQ_STR(pcr->config->version, "3.0");
   EXPECT_EQ_INT(pcr->queue->capacity, 20);

tests/test_file.c

@@ -156,6 +156,7 @@ static void test_file_send_receive() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");
@@ -306,6 +307,7 @@ static void test_file_send_single_calls_compression() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");
@@ -373,6 +375,7 @@ static void test_file_send_single_calls_metadata_and_path() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");

tests/test_file_sendfile.c

@@ -24,6 +24,7 @@ static void test_sendfile_basic() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");
@@ -84,6 +85,7 @@ static void test_sendfile_empty_file() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");
@@ -167,6 +169,7 @@ static void test_sendfile_compression_fallback() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/tmp");
   cfg->receive_root_directory = str_dup("/tmp");

tests/test_multiprocessing.c

@@ -16,6 +16,7 @@
 static void test_sender_create_destroy() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup("1.0");
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/dst");
@@ -42,6 +43,7 @@ static void test_sender_create_destroy() {
 static void test_receiver_create_destroy() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup("2.0");
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/dst");
@@ -51,7 +53,7 @@ static void test_receiver_create_destroy() {
   Queue* q = queue_create(20, NULL);
   EXPECT_NOT_NULL(q);
 
-  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 42);
+  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 42, NULL);
   EXPECT_NOT_NULL(ctx);
   EXPECT_EQ_STR(ctx->config->version, "2.0");
   EXPECT_EQ_INT(ctx->queue->capacity, 20);
@@ -65,6 +67,7 @@ static void test_receiver_create_destroy() {
 static void test_sender_queue_capacities() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup("3.0");
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/dst");
@@ -83,6 +86,7 @@ static void test_sender_queue_capacities() {
 static void test_sender_zero_capacity() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup("4.0");
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/dst");
@@ -100,11 +104,12 @@ static void test_sender_zero_capacity() {
 static void test_receiver_fd_zero() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup("5.0");
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/dst");
   Queue* q = queue_create(5, NULL);
-  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 0);
+  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 0, NULL);
   EXPECT_NOT_NULL(ctx);
   EXPECT_EQ_INT(ctx->file_descriptor, 0);
   EXPECT_FALSE(ctx->receiver_done);
@@ -115,6 +120,7 @@ static void test_receiver_fd_zero() {
 static void test_receive_thread_finished() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/tmp/dst");
@@ -132,7 +138,7 @@ static void test_receive_thread_finished() {
 
     Queue* q = queue_create(5, file_destroy);
     EXPECT_NOT_NULL(q);
-    PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, p[0]);
+    PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, p[0], NULL);
     EXPECT_NOT_NULL(ctx);
 
     int ret = receive_thread(ctx);
@@ -166,6 +172,7 @@ static void test_receive_thread_finished() {
 static void test_write_thread_done() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/tmp/dst");
@@ -174,7 +181,7 @@ static void test_write_thread_done() {
   Queue* q = queue_create(5, file_destroy);
   EXPECT_NOT_NULL(q);
 
-  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 0);
+  PipelineContextReceiver* ctx = pipeline_context_receiver_create(cfg, q, 0, NULL);
   EXPECT_NOT_NULL(ctx);
 
   /* Mark receiver as done BEFORE starting the thread so it exits immediately */

tests/test_scanner.c

@@ -18,8 +18,8 @@ static void test_scanner_single_file() {
   EXPECT_EQ_INT(mkdir(dir, 0755), 0);
   create_test_file(file1, content1);
 
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0, 0);
+                                                       0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -47,8 +47,8 @@ static void test_scanner_multiple_files() {
   create_test_file(file1, content1);
   create_test_file(file2, content2);
 
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0, 0);
+                                                       0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   const Chunk* chunk = directory_scanner_next(scanner);
@@ -87,8 +87,8 @@ static void test_scanner_subdirectory() {
   create_test_file(root_file, content);
   create_test_file(sub_file, content);
 
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)root, false, 0, NULL, 0, NULL, 0, 0,
-      directory_scanner_create((char*)root, false, 0, NULL, 0, NULL, 0, 0, 0, 0);
+                                                       0, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   int total_files = 0;
@@ -111,8 +111,8 @@ static void test_scanner_empty_directory() {
 
   EXPECT_EQ_INT(mkdir(dir, 0755), 0);
 
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0, 0);
+                                                       0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   const Chunk* chunk = directory_scanner_next(scanner);
@@ -135,8 +135,8 @@ static void test_scanner_exclude_pattern() {
   create_test_file(f_tmp, content);
 
   char* exclude[] = {"*.tmp"};
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, exclude, 1, NULL, 0, 0,
-      directory_scanner_create((char*)dir, false, 0, exclude, 1, NULL, 0, 0, 0, 0);
+                                                       0, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -168,8 +168,8 @@ static void test_scanner_exclude_subdirectory() {
   create_test_file(sub_tmp, content);
 
   char* exclude[] = {"*.tmp"};
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)root, false, 0, exclude, 1, NULL, 0,
-      directory_scanner_create((char*)root, false, 0, exclude, 1, NULL, 0, 0, 0, 0);
+                                                       0, 0, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   int total = 0;
@@ -206,8 +206,8 @@ static void test_scanner_include_and_exclude() {
 
   char* exclude[] = {"*.bak"};
   char* include[] = {"*.txt", "*.log"};
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, exclude, 1, include, 2,
-      directory_scanner_create((char*)dir, false, 0, exclude, 1, include, 2, 0, 0, 0);
+                                                       0, 0, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -243,8 +243,8 @@ static void test_scanner_max_size() {
   create_test_file(large, "this_content_is_longer_than_ten_chars");
 
   /* max_size = 10 — only files <= 10 bytes */
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 10,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 10, 0, 0);
+                                                       0, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -271,8 +271,8 @@ static void test_scanner_min_size() {
   create_test_file(data_f, "some content here");
 
   /* min_size = 1 — only files >= 1 byte */
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 1,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 1, 0);
+                                                       0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -301,8 +301,8 @@ static void test_scanner_size_range() {
   create_test_file(huge, "this is a much larger file for testing size filters");
 
   /* Only files between 3 and 20 bytes */
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 20,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 20, 3, 0);
+                                                       3, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -337,8 +337,8 @@ static void test_scanner_mixed_patterns() {
   /* Exclude *.bak, include *.txt, min_size=3, max_size=10 */
   char* exclude[] = {"*.bak"};
   char* include[] = {"*.txt"};
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, exclude, 1, include, 1,
-      directory_scanner_create((char*)dir, false, 0, exclude, 1, include, 1, 10, 3, 0);
+                                                       10, 3, 0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);
@@ -368,8 +368,8 @@ static void test_scanner_no_patterns() {
   create_test_file(f1, "first");
   create_test_file(f2, "second");
 
-  DirectoryScanner* scanner =
+  DirectoryScanner* scanner = directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0,
-      directory_scanner_create((char*)dir, false, 0, NULL, 0, NULL, 0, 0, 0, 0);
+                                                       0, false, false, false, false);
   EXPECT_NOT_NULL(scanner);
 
   Chunk* chunk = directory_scanner_next(scanner);

tests/test_server.c

@@ -21,6 +21,7 @@
 static void test_receive_files_finished() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/tmp/dst");
@@ -72,6 +73,7 @@ static void test_receive_files_single_file() {
 
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/tmp/dst");
@@ -133,6 +135,7 @@ static void test_receive_files_single_file() {
 static void test_receive_files_abort() {
   Config* cfg = config_create();
   EXPECT_NOT_NULL(cfg);
+  free(cfg->version);
   cfg->version = str_dup(PROTOCOL_VERSION);
   cfg->send_directory = str_dup("/src");
   cfg->receive_root_directory = str_dup("/tmp/dst");