TapTap
ea28e25535
Add the STATUS_STATS end-of-transfer receiver report (matched/deleted counters plus a would-delete path list) behind the report_stats wire bool, and a read-only delete_extras_list walker. --stats now renders true wire byte totals and the receiver-reported deleted count; a server-contacting -n --delete prints transfer-relative '*deleting' lines matching rsync's itemize layout.
77 lines
3.3 KiB
C
77 lines
3.3 KiB
C
#ifndef FORMAT_H
|
|
#define FORMAT_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <time.h>
|
|
|
|
/* Low-level output-formatting primitives shared by the change-event model
|
|
* (change_list.c) and the transfer driver (client_send.c).
|
|
*
|
|
* The functions here are pure/string-level except for the STATUS_DEST_INFO
|
|
* codec, which lets the receiver report the pre-transfer destination entry so
|
|
* the sender can render rsync-accurate --itemize-changes / --out-format
|
|
* columns (see protocol.h). */
|
|
|
|
/* Pre-transfer destination snapshot, reported by the receiver when the wire
|
|
* config carries report_dest_info. `known` distinguishes "no report was
|
|
* requested/received" from "the destination did not exist" (`existed == false`
|
|
* with `known == true`). */
|
|
typedef struct {
|
|
bool known;
|
|
bool existed;
|
|
unsigned long long size;
|
|
long long mtime_sec;
|
|
long long mtime_nsec;
|
|
uint32_t mode;
|
|
int32_t uid;
|
|
int32_t gid;
|
|
} OutputDestState;
|
|
|
|
/* rsync's -h/--human-readable size (decimal, base 1000): integers below 1000
|
|
* print verbatim; larger values use the largest unit that keeps the value
|
|
* below 1000 (K/M/G/T/P/E) with exactly two decimals, so 1500000 -> "1.50M"
|
|
* and 999999 -> "1000.00K" (matching rsync's human_num). Returns false when
|
|
* the buffer is too small (nothing is written). */
|
|
bool format_human_size_decimal(unsigned long long bytes, char* buffer, size_t buffer_size);
|
|
|
|
/* rsync's general number formatting (big_num). When `human_readable` is true
|
|
* this is format_human_size_decimal; otherwise the integer is rendered with a
|
|
* ',' thousands separator every three digits (rsync's separator in the C
|
|
* locale). Returns false on an undersized buffer. */
|
|
bool format_big_num(unsigned long long value, bool human_readable, char* buffer,
|
|
size_t buffer_size);
|
|
|
|
/* rsync's %M/%t timestamp. When `dash` is true the separator between the date
|
|
* and the time is '-' (the %M form: "YYYY/MM/DD-HH:MM:SS"); otherwise it is a
|
|
* space (the %t form: "YYYY/MM/DD HH:MM:SS"). Local time. Returns false on a
|
|
* bad time or an undersized buffer. */
|
|
bool format_rsync_datetime(time_t when, bool dash, char* buffer, size_t buffer_size);
|
|
|
|
/* Fixed-width STATUS_DEST_INFO record codec (int32 has_old, uint64 size,
|
|
* int64 mtime, int64 mtime_nsec, uint32 mode, int32 uid, int32 gid). The
|
|
* status frame itself is sent/received by the caller. Returns false on I/O
|
|
* failure. */
|
|
bool format_dest_state_send(int fd, const OutputDestState* state);
|
|
bool format_dest_state_receive(int fd, OutputDestState* state);
|
|
|
|
/* End-of-transfer receiver counters reported through STATUS_STATS (protocol
|
|
* 2.25.0) when the wire config carries report_stats. `would_delete_count` is
|
|
* the number of destination-relative paths the receiver would have deleted in a
|
|
* -n/--dry-run --delete run; that many wire strings immediately follow the
|
|
* fixed record (sent/read by the caller). */
|
|
typedef struct {
|
|
unsigned long long matched_data;
|
|
unsigned long long deleted_files;
|
|
unsigned long long would_delete_count;
|
|
} ReceiverStats;
|
|
|
|
/* Fixed-width STATUS_STATS counter record. The status frame and the optional
|
|
* would-delete path list are sent/received by the caller. Returns false on I/O
|
|
* failure. */
|
|
bool format_stats_send(int fd, const ReceiverStats* stats);
|
|
bool format_stats_receive(int fd, ReceiverStats* stats);
|
|
|
|
#endif
|