Compare commits
8 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
68635bd0f5 | ||
|
|
8e6cf66b3d | ||
|
|
1a7d443843 | ||
|
|
9b2f73678d | ||
|
|
95f1cacfbe | ||
|
|
39aa6a7a53 | ||
|
|
6743d0e6b7 | ||
|
|
b6d1c91f71 |
@@ -1,2 +1,2 @@
|
||||
language: c
|
||||
script: make
|
||||
script: ./configure && make
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
# -----------------------------------
|
||||
|
||||
CFLAGS+=-pthread -O2
|
||||
CFLAGS+=@LIBS@
|
||||
|
||||
all: fiche
|
||||
|
||||
261
README.md
261
README.md
@@ -1,260 +1,9 @@
|
||||
fiche [](https://travis-ci.org/solusipse/fiche)
|
||||
=====
|
||||
# fiche
|
||||
|
||||
Command line pastebin for sharing terminal output.
|
||||
## Warning
|
||||
|
||||
## Installation ##
|
||||
Do not use code from this branch. Please use code from [master](https://github.com/solusipse/fiche) instead.
|
||||
|
||||
1. Clone into repository:
|
||||
|
||||
```
|
||||
https://github.com/solusipse/fiche.git
|
||||
```
|
||||
|
||||
2. Build program:
|
||||
|
||||
```
|
||||
make
|
||||
```
|
||||
|
||||
3. Install:
|
||||
|
||||
```
|
||||
sudo make install
|
||||
```
|
||||
|
||||
## Client-side usage ##
|
||||
|
||||
Self explanatory live examples:
|
||||
|
||||
```
|
||||
ls -la | nc localhost 9999
|
||||
```
|
||||
|
||||
```
|
||||
cat file.txt | nc solusipse.net 9999
|
||||
```
|
||||
|
||||
```
|
||||
echo just testing! | nc code.solusipse.net 9999
|
||||
```
|
||||
|
||||
If you haven't already set up your server on localhost, try second or third command. My personal server is
|
||||
providing fiche-based service all the time on this address `solusipse.net` and this port `9999`.
|
||||
|
||||
- To upload text you need to have netcat installed (to check if netcat is installed, simply type ```nc``` in terminal).
|
||||
|
||||
## Server-side usage ##
|
||||
|
||||
```
|
||||
usage: fiche [-DepbsdolBuw].
|
||||
[-d domain] [-p port] [-s slug size]
|
||||
[-o output directory] [-B buffer size] [-u user name]
|
||||
[-l log file] [-b banlist] [-w whitelist]
|
||||
```
|
||||
|
||||
These are command line arguments. You don't have to provide any, but providing basic is recommended. Without them, program
|
||||
will use these default settings:
|
||||
|
||||
```
|
||||
domain = "http://localhost/";
|
||||
basedir= "~/code/";
|
||||
port = 9999;
|
||||
slug_size = 4;
|
||||
buffer_size = 8192;
|
||||
```
|
||||
|
||||
### Arguments ###
|
||||
|
||||
Most important is providing **basedir** and **domain**.
|
||||
|
||||
-----------------
|
||||
|
||||
#### Basedir ####
|
||||
|
||||
Basedir should be **absolute** path to directory where you would like to store text files.
|
||||
|
||||
|
||||
```
|
||||
fiche -o /absolute/path/to/directory/
|
||||
```
|
||||
|
||||
```
|
||||
fiche -o /home/www/code/
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### Domain ####
|
||||
|
||||
Domain should be provided in such format ```domain.com```.
|
||||
|
||||
```
|
||||
fiche -d domain.com
|
||||
```
|
||||
|
||||
```
|
||||
fiche -d subdomain.domain.com
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### Slug size ####
|
||||
|
||||
This will force fiche to create random slugs with given length, example:
|
||||
|
||||
```
|
||||
fiche -s 6
|
||||
```
|
||||
|
||||
```
|
||||
http://domain.com/abcdef/
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### User name ####
|
||||
|
||||
Set the user that fiche runs as using the `-u` option, example:
|
||||
|
||||
```
|
||||
fiche -u _fiche
|
||||
```
|
||||
|
||||
This option has effect only if fiche was started by root, otherwise it is ignored and fiche runs under the
|
||||
current user id.
|
||||
|
||||
-----------------
|
||||
|
||||
#### Buffersize ####
|
||||
|
||||
This parameter defines max file size uploaded by user, by default it is set to `32768`.
|
||||
Use `-B` parameter to change it:
|
||||
|
||||
```
|
||||
fiche -B 2048
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### Log file ###
|
||||
|
||||
Path to file where all logs will be stored:
|
||||
|
||||
```
|
||||
fiche -l /home/www/fiche-log.txt
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### Ban list ###
|
||||
|
||||
Path to file where you provided all banned IP adresses:
|
||||
|
||||
```
|
||||
fiche -b /home/www/fiche-bans.txt
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### White list ####
|
||||
|
||||
If whitelist mode is enabled, only addresses from list will be able to upload files. There's example:
|
||||
|
||||
```
|
||||
fiche -w /home/www/fiche-whitelist.txt
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
#### Whitelist and banlist syntax ####
|
||||
|
||||
There is no specific syntax, there files may contain not only addresses.
|
||||
|
||||
-----------------
|
||||
|
||||
#### Daemonize ####
|
||||
|
||||
Fork fiche to the background:
|
||||
|
||||
fiche -D
|
||||
|
||||
-----------------
|
||||
|
||||
#### Extended character set for the URL ####
|
||||
|
||||
Fork can extend the charcter set for the URL:
|
||||
|
||||
fiche -e
|
||||
|
||||
-----------------
|
||||
|
||||
#### Examples ####
|
||||
|
||||
Logging connections with banlist:
|
||||
|
||||
```
|
||||
fiche -d domain.com -l /home/www/log.txt -b /home/www/bans.txt
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
Only for personal use with whitelist
|
||||
|
||||
```
|
||||
fiche -d domain.com -w /home/www/whitelist.txt
|
||||
```
|
||||
|
||||
-----------------
|
||||
|
||||
Custom output directory, bigger slug size, reduced buffer, custom port:
|
||||
|
||||
```
|
||||
fiche -d domain.com -o /media/disk/fiche/ -s 8 -B 2048 -p 6666
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Running as service ##
|
||||
You can run fiche as service, there is simple systemd example:
|
||||
|
||||
```
|
||||
[Unit]
|
||||
Description=FICHE-SERVER
|
||||
|
||||
[Service]
|
||||
ExecStart=/usr/local/bin/fiche -d code.solusipse.net -o /home/www/code/ -l /home/www/log.txt -u _fiche
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
In service mode you have to set output directory with `-o` parameter, there's example:
|
||||
|
||||
```
|
||||
fiche -o /home/www/code/
|
||||
```
|
||||
|
||||
## Webserver ##
|
||||
|
||||
To make files available for users, you need to host them somehow. Http server is easiest option. Just set root
|
||||
directory to ```BASEDIR```.
|
||||
|
||||
There is sample configuration for nginx:
|
||||
|
||||
```
|
||||
server {
|
||||
listen 80;
|
||||
server_name mysite.com www.mysite.com;
|
||||
charset utf-8;
|
||||
|
||||
location / {
|
||||
root /home/www/code/;
|
||||
index index.txt index.html;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## License ##
|
||||
|
||||
Fiche is MIT licensed.
|
||||
## Secure branch (legacy note)
|
||||
This branch is the result of merging two pull requests: [#16](https://github.com/solusipse/fiche/pull/16) by [Adam Schwalm](https://github.com/ALSchwalm) and [#17](https://github.com/solusipse/fiche/pull/17) by [Renaud Allard](https://github.com/renaudallard), which contained some security-related improvements. It is recommended for `BSD` users or for those who would like to `arc4random`.
|
||||
|
||||
2
config.h.in
Normal file
2
config.h.in
Normal file
@@ -0,0 +1,2 @@
|
||||
#undef HAVE_ARC4RANDOM
|
||||
|
||||
20
configure.in
Normal file
20
configure.in
Normal file
@@ -0,0 +1,20 @@
|
||||
AC_INIT([fiche], [0.99])
|
||||
AC_CONFIG_SRCDIR([fiche.c])
|
||||
AC_CONFIG_HEADERS([config.h])
|
||||
|
||||
# Checks for programs.
|
||||
AC_PROG_CC
|
||||
|
||||
# Function arc4random() is in BSD standard C or GNU systems -lbsd
|
||||
AC_SEARCH_LIBS([arc4random], [bsd], [HAVE_ARC4RANDOM="yes"])
|
||||
|
||||
# Checks for library functions.
|
||||
AC_CHECK_FUNCS([bzero arc4random])
|
||||
|
||||
AC_SUBST(HAVE_ARC4RANDOM)
|
||||
|
||||
AC_CONFIG_FILES([Makefile])
|
||||
AC_OUTPUT
|
||||
|
||||
|
||||
|
||||
26
fiche.c
26
fiche.c
@@ -29,12 +29,12 @@ $ cat fiche.c | nc localhost 9999
|
||||
*/
|
||||
|
||||
#include <sys/param.h>
|
||||
#include <stdio.h>
|
||||
#include "config.h"
|
||||
#include "fiche.h"
|
||||
|
||||
int main(int argc, char **argv)
|
||||
{
|
||||
time_seed = time(0);
|
||||
|
||||
parse_parameters(argc, argv);
|
||||
|
||||
if (getuid() == 0)
|
||||
@@ -284,7 +284,7 @@ struct sockaddr_in set_address(struct sockaddr_in server_address)
|
||||
|
||||
void bind_to_port(int listen_socket, struct sockaddr_in server_address)
|
||||
{
|
||||
if (bind(listen_socket, (struct sockaddr *) &server_address, sizeof(server_address)) < 0)
|
||||
if (bind(listen_socket, (struct sockaddr *) &server_address, sizeof(server_address)) < 0)
|
||||
error("ERROR while binding to port");
|
||||
if (listen(listen_socket, QUEUE_SIZE) < 0)
|
||||
error("ERROR while starting listening");
|
||||
@@ -294,28 +294,36 @@ void generate_url(char *buffer, char *slug, size_t slug_length, struct client_da
|
||||
{
|
||||
int i;
|
||||
memset(slug, '\0', slug_length);
|
||||
#if !defined(BSD)
|
||||
FILE* frandom = fopen("/dev/urandom", "r");
|
||||
#endif
|
||||
int symbol_id;
|
||||
|
||||
for (i = 0; i <= SLUG_SIZE - 1; i++)
|
||||
{
|
||||
#if defined(BSD)
|
||||
#if defined(HAVE_ARC4RANDOM)
|
||||
int symbol_id = arc4random() % strlen(symbols);
|
||||
#else
|
||||
int symbol_id = rand_r(&time_seed) % strlen(symbols);
|
||||
fread(&symbol_id, sizeof(symbol_id), 1, frandom);
|
||||
#endif
|
||||
slug[i] = symbols[symbol_id];
|
||||
slug[i] = symbols[symbol_id % strlen(symbols)];
|
||||
}
|
||||
|
||||
while (create_directory(slug) == -1)
|
||||
{
|
||||
#if defined(BSD)
|
||||
#if defined(HAVE_ARC4RANDOM)
|
||||
int symbol_id = arc4random() % strlen(symbols);
|
||||
#else
|
||||
int symbol_id = rand_r(&time_seed) % strlen(symbols);
|
||||
fread(&symbol_id, sizeof(symbol_id), 1, frandom);
|
||||
#endif
|
||||
slug[strlen(slug)] = symbols[symbol_id];
|
||||
slug[strlen(slug)] = symbols[symbol_id % strlen(symbols)];
|
||||
}
|
||||
|
||||
save_to_file(slug, buffer, data);
|
||||
|
||||
#if !defined(BSD)
|
||||
fclose(frandom);
|
||||
#endif
|
||||
}
|
||||
|
||||
int create_directory(char *slug)
|
||||
|
||||
Reference in New Issue
Block a user