Skip to main content

diag

PLAKAR-DIAG(1) - General Commands Manual

NAME
#

plakar diag - Display detailed information about Plakar internal structures

SYNOPSIS
#

plakar diag [errors | object | packfile | snapshot | state | vfs]

DESCRIPTION
#

The plakar diag command provides detailed information about various internal data structures. The type of information displayed depends on the specified argument. Without any arguents, display information about the repository.

The sub-commands are as follows:

errors snapshotID

Display the list of errors in the given snapshot.

object objectID

Display information about a specific object, including its mac, type, tags, and associated data chunks.

packfile packfileID

Show details of packfiles, including entries and macs, which store object data within the repository.

snapshot snapshotID

Show detailed information about a specific snapshot, including its metadata, directory and file count, and size.

state

List or describe the states in the repository.

vfs snapshotID:path

Show filesystem (VFS) details for a specific path within a snapshot, listing directory or file attributes, including permissions, ownership, and custom metadata.

EXAMPLES
#

Show repository information:

$ plakar diag

Show detailed information for a snapshot:

$ plakar diag snapshot abc123

List all states in the repository:

$ plakar diag state

Display a specific object within a snapshot:

$ plakar diag object 1234567890abcdef

Display filesystem details for a path within a snapshot:

$ plakar diag vfs abc123:/etc/passwd

DIAGNOSTICS
#

The plakar diag utility exits 0 on success, and >0 if an error occurs.

0

Command completed successfully.

>0

An error occurred, such as an invalid snapshot or object ID, or a failure to retrieve the requested data.

SEE ALSO
#

plakar(1), plakar-snapshot(1)

Plakar - February 3, 2025