4 Parametri a riga di comando di FreePOPs

La vera configurazione di FreePOPs viene impostata tramite argomenti a riga di comando. Questi sono descritti in dettaglio nelle pagine del man in ambienti Unix e qui di seguito. Tenete presente che in condizioni d' uso normali non serve specificare niente per usare FreePOPs, ma in caso di esigenze specifiche è bene fare riferimento a questo elenco:

-p <port>, - -port <port>

Per default FreePOPs fa bind sulla porta 2000. Per modificare questo comportamento basta usare questo switch.

-t <num>, - -threads <num>

FreePOPs può gestire connessioni multiple, fino a num. Il default è 5.

-b addr, - -bind addr

Per fare bind su addr invece che INADDR_ANY (0.0.0.0). addr deve essere una stringa contenente un indirizzo IPv4 nel formato ``ddd.ddd.ddd.ddd'', o un nome host.

-l logfacility, - -logmode logfacility

Può essere usato per specificare il tipo di logging. logfacility può essere ``stdout'' per standard output (il default), ``syslog'' per usare un demone di logging o un nome di file valido per avere un log su file.

-d, - -daemonize

Sposta il processo in background rilasciando la tty

-n, - -no-pid-file

Non crea il file contenente il pid del processo in /var/run/.

-P <host>:<port>, - -proxy <host>:<port>

Per dire a FreePOPs quale è il vostro proxy HTTP. Se port non è impostato viene usata la porta 8080 di default.

-A <username>:<password>, - -auth <username>:<password>

Si usa per proxy con autenticazione, per specificare nome utente e password. Va usato con -P o la sua forma estesa.

-u name, - -useragent name

Imposta lo useragent da usare nelle connessioni HTTP. Il default è ``Firefox/0.8''.

-s user.group, - -suid user.group

Lascia i privilegi di root dopo il bind. Se lanciato da utente normale non serve questa opzione. (Non usato in Windows)

-k, - -kill

Termina il programma FreePOPs in esecuzione. (Non usato in Windows)

-x pluginfile, - -toxml file

Stampa la descrizione in XML del plugin o del modulo sullo standard output.

-e scriptfile args..., - -execute scriptfile args...

Esegue lo script in un interprete LUA dotato di tutte le librerie che usa FreePOPs. Lo script deve definire una funzione main che prende in input una table di stringhe (i parametri passati a freepopd dopo il nome dello script) e deve ritornare un intero (che verrà poi ritornato dall'interprete.

-c, - -conffile file

Users the specified configuration file instead of looking in default paths like /etc/freepops/config.lua, ./config.lua and /usr/share/frepops/lua/config.lua

- -statistics-all

Enable all statistics. Results can be viewed with the monitor plugin, either with an account like foo@monitor?command=stats or with freepopsd -e monitor host port password command.

- -statistics-session-created

Enables statistics regarding threads created to run a plugin. See the documentation of - -statistics-all for an explanation of how to read that statistics.

- -statistics-session-ok

Enables statistics regarding sessions ended successfully. See the documentation of - -statistics-all for an explanation of how to read that statistics.

- -statistics-session-err

Enables statistics regarding sessions ended with an error. See the documentation of - -statistics-all for an explanation of how to read that statistics.

- -statistics-connection-established

Enables statistics regarding connections accepted. See the documentation of - -statistics-all for an explanation of how to read that statistics.

- -statistics-cookies

Enables statistics regarding persistently stored data (usually cookies). See the documentation of - -statistics-all for an explanation of how to read that statistics.

- -statistics-pwd-file file

Data collected by the statistics mechanism can be read using the monitor plugin. If a password file is not specified, no password is set and everybody connection to the freepops daemon can read such data. Write your password in a text file with no additional end-of-line to restrict access to that data. The password file is read before dropping privileges (on unix).

- -fpat authtype, - -force-proxy-auth-type authtype

Per forzare l'utilizzo di un determinato metodo di autenticazione per il proxy. I valori accettati sono: ntlm, basic, digest e gss.

- -no-icon

Per disattivare l'icona nella try bar di windows (solo per windows).

-h, - -help

Stampa un messaggio di aiuto.

-v, - -verbose, -w, - -veryverbose

Questo dice a FreePOPs di loggare alcune informazioni utili per riportare bug.

In ambienti posix come Debian GNU/Linux potete avviare FreePOPs al boot come servizio standard. In questo caso gli switch a riga di comando sono memorizzati in /etc/default/freepops, in alcuni sistemi basati su rpm dovreste trovare lo stesso file con nome /etc/sysconfig/freepops.