Skip to content

Commit 115613b

Browse files
Update README.md
1 parent 3826c46 commit 115613b

File tree

1 file changed

+21
-14
lines changed

1 file changed

+21
-14
lines changed

README.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
<strong>A next generation version of enum4linux</strong>
44
</p>
55
<p align="center">
6-
<img src="https://img.shields.io/badge/python-3.6-blue.svg"/>
6+
<img src="https://img.shields.io/badge/python-%3E=_3.6-blue"/>
7+
<img src="https://img.shields.io/badge/License-GPLv3-green.svg"/>
78
</p>
89

910
enum4linux-ng.py is a rewrite of Mark Lowe's (former Portcullis Labs now Cisco CX Security Labs) enum4linux.pl, a tool for enumerating information from Windows and Samba systems, aimed for security professionals and CTF players. The tool is mainly a wrapper around the Samba tools `nmblookup`, `net`, `rpcclient` and `smbclient`.
@@ -48,7 +49,7 @@ enum4linux-ng.py -As <target> -oY out
4849
```
4950

5051
### Demo
51-
### Windows Server 2012 R2
52+
#### Windows Server 2012 R2
5253
This demonstrates a run against Windows Server 2012 R2 standard installation. The following command is being used:
5354

5455
```console
@@ -59,7 +60,7 @@ A user 'Tester' with password 'Start123!' was created. Firewall access was allow
5960

6061
![Demo](https://github.com/cddmp/misc/blob/master/screencasts/enum4linux-ng/demo1.gif)
6162

62-
### Metasploitable 2
63+
#### Metasploitable 2
6364
The second demo shows a run against Metasploitable 2. The following command is being used:
6465

6566
```console
@@ -124,19 +125,25 @@ options:
124125
## Installation
125126
There are multiple ways to install the tool. Either the tool comes as a package with your Linux distribution or you need to do a manual install.
126127

127-
### Archstrike
128+
### Kali Linux
129+
```console
130+
apt install enum4linux-ng
131+
```
128132

133+
### Archstrike
129134
```console
130135
pacman -S enum4linux-ng
131136
```
132137

133138
### NixOS
134139
(tested on NixOS 20.9)
135-
136140
```console
137141
nix-env -iA nixos.enum4linux-ng
138142
```
139-
### Manual Installation
143+
144+
## Manual Installation
145+
If your Linux distribution does not offer a package, the following manual installation methods can be used instead.
146+
140147
### Dependencies
141148
The tool uses the samba clients tools, namely:
142149
- nmblookup
@@ -158,27 +165,27 @@ Some examples for specific Linux distributions installations are listed below. A
158165

159166
### Linux distribution specific
160167
For all distribution examples below, LibYAML is already a dependency of the corresponding PyYaml package and will be therefore installed automatically.
161-
### ArchLinux
168+
#### ArchLinux
162169

163170
```console
164171
pacman -S smbclient python-ldap3 python-yaml impacket
165172
```
166-
### Fedora/CentOS/RHEL
173+
#### Fedora/CentOS/RHEL
167174
(tested on Fedora Workstation 31)
168175

169176
```console
170177
dnf install samba-common-tools samba-client python3-ldap3 python3-pyyaml python3-impacket
171178
```
172179

173-
### Kali Linux/Debian/Ubuntu/Linux Mint
174-
(tested on Kali Linux 2020.1, recent Debian (e.g. Buster) or Ubuntu versions should work, for Ubuntu 18.04 or below use the Docker or Python virtual environment variant)
180+
#### Debian/Ubuntu/Linux Mint
181+
(For Ubuntu 18.04 or below use the Docker or Python virtual environment variant)
175182

176183
```console
177184
apt install smbclient python3-ldap3 python3-yaml python3-impacket
178185
```
179186

180187
### Linux distribution-agnostic
181-
### Python pip
188+
#### Python pip
182189
Depending on the Linux distribution either `pip3` or `pip` is needed:
183190

184191
```console
@@ -193,7 +200,7 @@ pip install -r requirements.txt
193200

194201
Remember you need to still install the samba tools as mentioned above.
195202

196-
### Python virtual environment
203+
#### Python virtual environment
197204
```console
198205
git clone https://github.com/cddmp/enum4linux-ng
199206
cd enum4linux-ng
@@ -210,11 +217,11 @@ python3 enum4linux-ng.py -As <target>
210217

211218
Remember you need to still install the samba tools as mentioned above. In addition, make sure you run ```source venv/bin/activate``` everytime you spawn a new shell. Otherwise the wrong Python interpreter with the wrong libraries will be used (your system one rather than the virtual environment one).
212219

213-
### Docker
220+
#### Docker
214221
```console
215222
git clone https://github.com/cddmp/enum4linux-ng
216223
cd enum4linux-ng
217-
docker build enum4linux-ng --tag enum4linux-ng
224+
docker build . --tag enum4linux-ng
218225
```
219226
Once finished an example run could look like this:
220227
```console

0 commit comments

Comments
 (0)