Command-line interface

swh identify

Compute the Software Heritage persistent identifier (SWHID) for the given source code object(s).

For more details about SWHIDs see:

https://docs.softwareheritage.org/devel/swh-model/persistent-identifiers.html

Tip: you can pass “-” to identify the content of standard input.

Examples:

$ swh identify fork.c kmod.c sched/deadline.c
swh:1:cnt:2e391c754ae730bd2d8520c2ab497c403220c6e3    fork.c
swh:1:cnt:0277d1216f80ae1adeed84a686ed34c9b2931fc2    kmod.c
swh:1:cnt:57b939c81bce5d06fa587df8915f05affbe22b82    sched/deadline.c

$ swh identify --no-filename /usr/src/linux/kernel/
swh:1:dir:f9f858a48d663b3809c9e2f336412717496202ab

$ git clone --mirror https://forge.softwareheritage.org/source/helloworld.git

$ swh identify --type snapshot helloworld.git/
swh:1:snp:510aa88bdc517345d258c1fc2babcd0e1f905e93    helloworld.git

swh identify [OPTIONS] OBJECTS...

Options

--dereference, --no-dereference

follow (or not) symlinks for OBJECTS passed as arguments (default: follow)

--filename, --no-filename

show/hide file name (default: show)

-t, --type <obj_type>

type of object to identify (default: auto)

Options

auto | content | directory | origin | snapshot

-x, --exclude <PATTERN>

Exclude directories using glob patterns (e.g., *.git to exclude all .git directories)

-v, --verify <SWHID>

reference identifier to be compared with computed one

-r, --recursive

compute SWHID recursively

Arguments

OBJECTS

Required argument(s)