├── .gitignore
├── index.html
├── test.sh
├── Makefile
├── Dockerfile
├── README.md
├── layout.mustache
└── server.asm
/.gitignore:
--------------------------------------------------------------------------------
1 | server.o
2 | server.html
3 | server
4 | .#*
--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | servasm
6 |
7 |
8 | servasm
9 | Your other webserver.
10 |
11 |
12 |
--------------------------------------------------------------------------------
/test.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 |
3 | # Simple smoke tests
4 |
5 | set -e
6 |
7 | ./server &
8 | PID=$!
9 |
10 | at_exit(){
11 | kill -9 $PID
12 | }
13 | trap at_exit EXIT
14 |
15 | sleep 1
16 |
17 | diff -u <(curl -s localhost:8080) <(cat index.html)
18 | diff -u <(curl -s localhost:8080/server.asm) <(cat server.asm)
19 | diff -u <(curl -s localhost:8080/foobar) <(echo -ne 'HTTP/1.0 404 File not found\r\n\r')
20 |
--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | default: server
2 |
3 | server: server.html server.asm
4 | nasm -g -f elf64 -o server.o server.asm
5 | ld -o server server.o
6 |
7 | server.html:
8 | rocco -l asm -c ';;' -t layout.mustache server.asm
9 |
10 | .PHONY: build_docker
11 | build_docker:
12 | cat Dockerfile | docker build -t servasm -
13 |
14 | .PHONY: test
15 | test:
16 | bash ./test.sh
17 |
18 | .PHONY: clean
19 | clean:
20 | rm server server.o server.html
21 |
--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM debian:sid
2 | MAINTAINER Vladimir Terekhov
3 |
4 | RUN apt-get update && \
5 | apt-get install -y locales && \
6 | dpkg-reconfigure locales && \
7 | locale-gen C.UTF-8 && \
8 | /usr/sbin/update-locale LANG=C.UTF-8
9 |
10 | ENV LC_ALL C.UTF-8
11 |
12 | # Installing ruby
13 |
14 | RUN apt-get install -y build-essential nasm ruby ruby-dev python-pygments && gem install rocco curl
15 |
16 | CMD /bin/bash
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # SERVASM: Your other webserver.
2 |
3 | Minimal x86_64 Linux-only file webserver, written in assembly language.
4 | It doesn't allocate any memory, using only stack to serve files.
5 |
6 | *Not intended for production use.*
7 |
8 | ## How it works:
9 |
10 | Main process setups listing socket on 8080 port with few system calls:
11 | `socket(2)` -> `bind(2)` -> `listen(2)`
12 | After main process blocks on on `accept(2)` system call until client connects.
13 | Then it `fork(2)` main process passing dealing with request in child process and `accept(2)`'ing again in main.
14 | On a child process sets `alarm(2)` to drop very slow clients, and `recv(2)` headers.
15 | We do couple checks on incoming request (only GET requests are `supported).
16 | open(2)` file and get its size with `fstat(2).
17 | write(2)` headers and let the kernel send rest with `sendfile(2)`. After we `close(2)` socket and file.
18 |
19 | In a case of error we exit process with passing system call result as exit code.
20 |
21 | ## Running
22 |
23 | Compiling server requires `nasm` assembler.
24 |
25 | `make && ./server`
26 |
27 | ## Debugging
28 |
29 | `make && strace -v -s 512 -f ./server`
30 |
31 | ## License
32 |
33 | Copyright (c) 2015 Vladimir Terekhov
34 |
35 | Permission is hereby granted, free of charge, to any person
36 | obtaining a copy of this software and associated documentation
37 | files (the "Software"), to deal in the Software without
38 | restriction, including without limitation the rights to use,
39 | copy, modify, merge, publish, distribute, sublicense, and/or sell
40 | copies of the Software, and to permit persons to whom the
41 | Software is furnished to do so, subject to the following
42 | conditions:
43 |
44 | The above copyright notice and this permission notice shall be
45 | included in all copies or substantial portions of the Software.
46 |
47 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
48 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
49 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
50 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
51 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
52 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
53 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
54 | OTHER DEALINGS IN THE SOFTWARE.
55 |
--------------------------------------------------------------------------------
/layout.mustache:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | {{ title }}
6 |
157 |
158 |
159 |
160 |
161 |
162 | {{#sections}}
163 |
164 | |
165 | {{{ docs }}}
166 | |
167 |
168 |
169 | |
170 |
171 | {{/sections}}
172 |
173 |