t3c-diff

command
v7.0.0+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 9, 2022 License: Apache-2.0, BSD-2-Clause, BSD-3-Clause, + 1 more Imports: 10 Imported by: 0

README

NAME

t3c-diff - Traffic Control Cache Configuration contextual diff tool

SYNOPSIS

t3c-diff -a <file-a> -b <file-b> -l <line_comment> -m <file-mode> -u <file-uid> -g <file-gid>

[--help]

[--version]

DESCRIPTION

The t3c-diff application compares configuration files with semantic context, omitting comments and other semantically irrelevant text.

This is useful over standard diff tools without context, for example, when the grammar of a generated comment changes, or a comment contains a date. This allows operators to avoid updating sematically identical files, undesirably updating file timestamps, effecting unnecessary reloads, and other unnecessary and undesirable results.

The input files may be file paths, or 'stdin' in which case that file is read from stdin.

Prints the diff to stdout, and returns the exit code 0 if there was no diff, 1 if there was a diff. If one file exists but the other doesn't, it will always be a diff.

Note this means there may be no diff text printed to stdout but still exit 1 indicating a diff if the file being created or deleted is semantically empty.

Mode is file permissions in octal format, default is 0644. Line comment is a character that signals the line is a comment, default is #

Uid is the User id the file being checked should have, default is running process's uid. Gid is the Group id the file being checked should have, default is running process's gid.`

OPTIONS

-a, --file-a

Path to first diff file, can also be stdin.

-b, --file-b Path to second diff file, can also be stdin.

-g, --file-gid Group id the file being checked should have.

-h, --help

Print usage info and exit.

-l, --line_comment Symbol used to denote the line is a comment.

-m, --file-mode Octal permissions mode for file being checked.

-u, --file-uid User id the file being checked should have.

-V, --version

Print version information and exit.

AUTHORS

The t3c application is maintained by Apache Traffic Control project. For help, bug reports, contributing, or anything else, see:

https://trafficcontrol.apache.org/

https://github.com/apache/trafficcontrol

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL