▄▄ ▄▄ ▄▄▄▄▄▄ ▄▄
██ ██ ██▀▀▀▀██ ██
████▄██▄ ██ ██ ██ ██ ██
██ ██ ██ ██ ██ ███████ ██
██ ██ ██ ██ ██ ██ ▀██▄ ██
██ ██ ██ ▀██▄▄██▀ ██ ██ ██▄▄▄▄▄▄
▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀▀ ▀▀▀▀▀▀▀▀ ｍｙ ｃＵＲＬ
This program is written in c and it's just to test my C Language knowlege
as you might guess this is just a very simple tool like curl that wrote by me (so it's called mURL) that only supports HTTP protocol
CAUTION: this program has lot of vulnerabilities like binary explotations
there is a Makefile here, so just run make build to build the ELF (executable) file
$ make build
building...
done!
and the executable file has build as murl
Check out that it was build correct
$ ./murl --verion
0.0.1
Ok, to get a help of the arguments and CLI
$ ./murl --help
Usage: murl [options...] <url>
Arguments:
-H, --header Headers of the request, e.g: 'Accept: plain/text'
-X, --method HTTP method for the request. default: GET
-d, --data Data or body of the request, e.g: 'username=admin'
-p, --params Query parameters of the request, e.g: 'param1=value'
-h, --help Show this text
-v, --version Version number of the murl
-r, --show-records Show all avaiables records. [ a: all | d: ata | h: headers | p: params ], default: a
-f, --format Specify output format, [json|csv]. default json
--preview Display the preview of http request
--http-version Change the HTTP version, allowed ['HTTP/1.1', 'HTTP/2', 'HTTP/3']
NOTE: Right now the main logic did not wrote :/
for a quick review of options, let's take a look
$ ./murl https://somesite.com --method POST --data "username=admin" --date "password=1234" -H "Content-type: application/json" --params "action=login" --show-records --format json
[
{
"key": "username",
"value": "admin",
"type": "data"
},
{
"key": "password",
"value": "1234",
"type": "data"
},
{
"key": "Content-type",
"value": "application/json",
"type": "header"
},
{
"key": "action",
"value": "login",
"type": "parameter"
},
]
note that the records are the given {data,headers,params}. check out the source code
It's possible filter records:
to get only headers use --show-records h which h stand for headers
It's possible to add params to url:
./murl 'http://localhost:8080/api/posts?id=1' --params "page=1" --show-records p
[
{
"key": "id",
"value": "1",
"type": "parameter"
},
{
"key": "page",
"value": "1",
"type": "parameter"
}
]
Headers
./murl 'http://localhost:8080' -H 'User-Agent: Mozilla/5.0' -H 'Accept: */*' -H 'Accept-Language: en-US,en;q=0.5' -H 'Accept-Encoding: gzip, deflate' -H 'Referer: http://localhost:8080' -H 'Content-Type: application/json' -H 'Origin: http://localhost:8080' -H 'Connection: keep-alive' -H 'Cookie: session=SESSION' -r h
[
...
{
"key": "Accept-Encoding",
"value": "gzip, deflate",
"type": "header"
},
{
"key": "Referer",
"value": "http",
"type": "header"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "header"
},
...
]
Preview of request
& ./murl 'http://192.168.1.10:1337/api/posts' -X POST -H 'User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/115.0' -H 'Accept: */*' -H 'Accept-Language: en-US,en;q=0.5' -H 'Accept-Encoding: gzip, deflate' -H 'Referer: http://192.168.1.10:1337/posts/create' -H 'Content-Type: application/json' -H 'Origin: http://192.168.1.10:1337' -H 'Connection: keep-alive' -H 'Cookie: session=eyJoZWxwIjoicGxlYXNzc3NlIHJlcG9ydCBidWdzLCBidXQgYW55d2F5IGRvZXMgbm90IG1hdHRlciA6KSJ9' --data 'username=admin&password=123' --preview
POST /api/posts HTTP/1.1
Host 192.168.1.10
User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv
Accept: */*
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Referer: http
Content-Type: application/json
Origin: http
Connection: keep-alive
Cookie: session=eyJoZWxwIjoicGxlYXNzc3NlIHJlcG9ydCBidWdzLCBidXQgYW55d2F5IGRvZXMgbm90IG1hdHRlciA6KSJ9%
username=admin&password=123
I know there are some bugs there so it would help me you to report it in issue :)