aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 26bdff69ccb0ec7a8ebc60f16cb39ab73ec05f4e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
nthash
======

**Generate NT Hash**

The NT hash is used by Microsoft and others for authentication. This
program `nthash` converts the standard input to UTF16 (little endian)
and applies the MD4 hash algorithm. This resulting 32 byte string is
printed to standard out.

Requirements
------------

To compile and run `ntash` you need:

* [nettle](https://www.lysator.liu.se/~nisse/nettle/)
* [markdown](https://daringfireball.net/projects/markdown/) (HTML documentation)

Additionally it is expected to have `make` and `pkg-config` around to
successfully compile.

Some systems may require additional development packages for the libraries.
Look for `nettle-dev` or similar.

Build and install
-----------------

Building and installing is very easy. Just run:

> make

followed by:

> make install

This will place an executable at `/usr/bin/nthash`.

Usage
-----

Just feed `nthash` with the password on standard input. Please not that
`nthash` does not strip new lines from input. You may want to use `echo`
with option `-n`:

    $ echo -n test | nthash
    0cb6948805f797bf2a82807973b89537

License and warranty
--------------------

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
[GNU General Public License](COPYING.md) for more details.

### Upstream

URL:
[GitHub.com](https://github.com/eworm-de/nthash#nthash)

Mirror:
[eworm.de](https://git.eworm.de/cgit.cgi/nthash/)
[GitLab.com](https://gitlab.com/eworm-de/nthash#nthash)