Forkear, simplificar y modernizar
This commit is contained in:
parent
28c9170958
commit
00d7fe7747
6
.gitmodules
vendored
6
.gitmodules
vendored
@ -1,6 +0,0 @@
|
|||||||
[submodule "etc/libnatpmp"]
|
|
||||||
path = etc/libnatpmp
|
|
||||||
url = git://github.com/miniupnp/libnatpmp.git
|
|
||||||
[submodule "etc/miniupnp"]
|
|
||||||
path = etc/miniupnp
|
|
||||||
url = git://github.com/miniupnp/miniupnp.git
|
|
6
AUTHORS
6
AUTHORS
@ -1,6 +0,0 @@
|
|||||||
fauno <fauno@endefensadelsl.org>
|
|
||||||
Ernesto Bazzano <bazza@riseup.net>
|
|
||||||
Mauricio Pasquier Juan <mauricio@pasquierjuan.com.ar>
|
|
||||||
Matías Lang <shareman1204@gmail.com>
|
|
||||||
aza <rata0071@gmail.com>
|
|
||||||
hellekin <hellekin@cepheide.org>
|
|
@ -1,12 +0,0 @@
|
|||||||
# Proceso de consenso
|
|
||||||
|
|
||||||
* Tenés una idea para mejorar LibreVPN
|
|
||||||
* Abrís un issue detallándola
|
|
||||||
* Se consensúa la idea
|
|
||||||
* Mandás un PR con una implementación de tu idea
|
|
||||||
* Se consensúa el PR
|
|
||||||
* Se mergea
|
|
||||||
|
|
||||||
# Herramientas
|
|
||||||
|
|
||||||
Se prefiere gitflow.
|
|
207
Makefile
207
Makefile
@ -1,214 +1,17 @@
|
|||||||
# The default target is the first target listed. We declare 'default' first
|
.DEFAULT_GOAL := all
|
||||||
# thing, so we don't have to worry about the order later
|
|
||||||
default: all
|
|
||||||
|
|
||||||
# Configuration ################################################################
|
|
||||||
|
|
||||||
# Where to install to.
|
|
||||||
# PREFIX is the install prefix, most programs on a system are "/" or "/usr"
|
|
||||||
# TARGET is a staging directory to install to, a sort of 'root' directory
|
|
||||||
TARGET ?=
|
|
||||||
PREFIX ?= /usr/local
|
|
||||||
# If this were a GNU package, 'TARGET' would be called 'DESTDIR', and 'PREFIX'
|
|
||||||
# would be 'prefix'
|
|
||||||
|
|
||||||
# Supplemental/derived install directories. Again, if we wanted to be
|
|
||||||
# consistent with GNU, they would have different names.
|
|
||||||
LIBDIR ?= $(PREFIX)/lib/$(NETWORK)
|
|
||||||
DOC ?= $(PREFIX)/share/$(NETWORK)/doc
|
|
||||||
CONTRIB ?= $(PREFIX)/share/$(NETWORK)/contrib
|
|
||||||
HOSTS ?= $(PREFIX)/share/$(NETWORK)/hosts
|
|
||||||
BEADLE ?= $(PREFIX)/share/$(NETWORK)/beadle
|
|
||||||
|
|
||||||
# Gettext
|
|
||||||
TEXTDOMAINDIR ?= $(PREFIX)/share/locale
|
|
||||||
TEXTDOMAIN ?= $(NETWORK)
|
|
||||||
|
|
||||||
# Nombre de la red
|
|
||||||
NETWORK ?= lvpn
|
|
||||||
# La configuración de tinc
|
|
||||||
TINC ?= /etc/tinc/$(NETWORK)
|
|
||||||
# `lvpn`
|
|
||||||
LVPN ?= $(PREFIX)/bin/$(NETWORK)
|
|
||||||
|
|
||||||
# Flags por defecto para el daemon
|
|
||||||
FLAGS ?= --logfile -U nobody
|
|
||||||
# Tamaño de las llaves
|
|
||||||
KEYSIZE ?= 4096
|
|
||||||
# Puerto por defecto
|
|
||||||
PORT ?= 655
|
|
||||||
|
|
||||||
# Las subredes
|
|
||||||
SUBNET ?= 192.168.9.0/24
|
|
||||||
SUBNET6 ?= 2001:1291:200:83ab::/64
|
|
||||||
|
|
||||||
# Sub-projects to optionally build
|
|
||||||
#BUILD_UPNPC = true
|
|
||||||
#BUILD_LIBNATPMP = true
|
|
||||||
BUILD_GEN_IPV6 = true
|
|
||||||
BUILD_CONTRIB = true
|
|
||||||
|
|
||||||
# Set up some runtime variables ################################################
|
|
||||||
|
|
||||||
# The language that the messages in the source are.
|
|
||||||
native_lang = es
|
|
||||||
# Detect available translations
|
|
||||||
langs = $(sort $(native_lang) $(notdir $(wildcard doc/* locale/*)))
|
|
||||||
|
|
||||||
arch := $(shell uname -m)
|
|
||||||
|
|
||||||
# The source and output files of our 'compile' routines
|
|
||||||
src_sh = lvpn.in
|
|
||||||
out_sh = $(patsubst %.in,%.out,$(src_sh))
|
|
||||||
src_po = $(wildcard locale/*/LC_MESSAGES/*.po)
|
|
||||||
out_po = $(patsubst %.po,%.mo,$(src_po))
|
|
||||||
src_man = $(wildcard doc/*/*.markdown)
|
src_man = $(wildcard doc/*/*.markdown)
|
||||||
out_man = $(patsubst %.markdown,%.1,$(src_man))
|
out_man = $(patsubst %.markdown,%.1,$(src_man))
|
||||||
|
|
||||||
# List of host names that we have files for
|
all: man
|
||||||
hosts = $(notdir $(wildcard hosts/*))
|
clean: man-clean
|
||||||
# List of man pages to install, structured like relative directories to /usr/share/man
|
|
||||||
mans = $(patsubst en/%,./%,$(subst /,/man1/,$(patsubst doc/%,%,$(out_man))))
|
|
||||||
# The list of programs to install to $(PREFIX)/bin
|
|
||||||
bins = lvpn
|
|
||||||
|
|
||||||
# List of subdirectories to recurse into
|
man: $(out_man)
|
||||||
SUBDIRS =
|
man-clean:
|
||||||
|
|
||||||
# Add the hooks for optionally compiled sub-projects ###########################
|
|
||||||
|
|
||||||
ifdef BUILD_UPNPC
|
|
||||||
bins += upnpc
|
|
||||||
SUBDIRS += etc/miniupnpc
|
|
||||||
$(TARGET)$(PREFIX)/bin/%: etc/miniupnpc/%-shared
|
|
||||||
install -Dm755 '$<' '$@'
|
|
||||||
endif
|
|
||||||
|
|
||||||
ifdef BUILD_LIBNATPMP
|
|
||||||
bins += natpmpc
|
|
||||||
SUBDIRS += etc/libnatpmp
|
|
||||||
$(TARGET)$(PREFIX)/bin/%: etc/libnatpmp/%-shared
|
|
||||||
install -Dm755 '$<' '$@'
|
|
||||||
endif
|
|
||||||
|
|
||||||
ifdef BUILD_GEN_IPV6
|
|
||||||
bins += $(arch)-generate-ipv6-address
|
|
||||||
SUBDIRS += etc/generate-ipv6-address-0.1
|
|
||||||
$(TARGET)$(PREFIX)/bin/%: etc/generate-ipv6-address-0.1/%
|
|
||||||
install -Dm755 '$<' '$@'
|
|
||||||
endif
|
|
||||||
|
|
||||||
ifdef BUILD_CONTRIB
|
|
||||||
bins += collectd-lvpn
|
|
||||||
$(TARGET)$(PREFIX)/bin/%: contrib/collectd/%
|
|
||||||
install -Dm755 '$<' '$@'
|
|
||||||
endif
|
|
||||||
|
|
||||||
# All the high-level 'phony' targets ###########################################
|
|
||||||
|
|
||||||
all: PHONY build man locale
|
|
||||||
clean-all: PHONY clean man-clean locale-clean
|
|
||||||
|
|
||||||
build: PHONY $(out_sh) $(addsuffix /all,$(SUBDIRS))
|
|
||||||
clean: PHONY $(addsuffix /clean,$(SUBDIRS))
|
|
||||||
rm -rf $(out_sh)
|
|
||||||
|
|
||||||
man: PHONY $(out_man)
|
|
||||||
man-clean: PHONY
|
|
||||||
rm -rf $(out_man)
|
rm -rf $(out_man)
|
||||||
|
|
||||||
locale: PHONY $(out_po)
|
|
||||||
locale-clean: PHONY
|
|
||||||
rm -rf $(out_po)
|
|
||||||
|
|
||||||
# This loops over the configured sub-projects to proxy targets to them.
|
|
||||||
# '${subdirectory}/${target}' runs 'make ${target}' in that subdirectory.
|
|
||||||
$(foreach subdir,$(SUBDIRS),$(eval \
|
|
||||||
$(subdir)/%: ; \
|
|
||||||
$$(MAKE) -C '$(subdir)' '$$*' \
|
|
||||||
))
|
|
||||||
|
|
||||||
# If we wanted to run 'make install' in each of the sub-projects, we would have
|
|
||||||
# 'install' depend on this:
|
|
||||||
# $(addsuffix /install,$(SUBDIRS))
|
|
||||||
# However, instead we've added rules to know how to find programs named in
|
|
||||||
# $(bin) from the relevent sub-directories, so 'install-bin' installs them, and
|
|
||||||
# we don't have to recurse. This is a questionable move, but it works for now.
|
|
||||||
|
|
||||||
# List of all the files to be created during install, as absolute paths
|
|
||||||
inst_progs = $(addprefix $(TARGET)$(PREFIX)/bin/,$(bins))
|
|
||||||
inst_hosts = $(addprefix $(TARGET)$(HOSTS)/,$(hosts))
|
|
||||||
inst_man = $(addprefix $(TARGET)$(PREFIX)/share/man/,$(mans))
|
|
||||||
inst_trans = $(patsubst locale/%,$(TARGET)$(TEXTDOMAINDIR)/%,$(out_po))
|
|
||||||
# And now, the 'install' target, depending on all of those files
|
|
||||||
install: PHONY all $(inst_progs) $(inst_hosts) $(inst_man) $(inst_trans)
|
|
||||||
# Except that listing all the files in lib would be a pain, so just cp -r it
|
|
||||||
install -dm755 $(TARGET)$(LIBDIR)/
|
|
||||||
cp -rfv lib/* $(TARGET)$(LIBDIR)/
|
|
||||||
install -dm755 $(TARGET)$(CONTRIB)/
|
|
||||||
cp -rfv contrib/* $(TARGET)$(CONTRIB)/
|
|
||||||
# Correctly set the permissions
|
|
||||||
find $(TARGET)$(LIBDIR)/ $(TARGET)$(CONTRIB)/ | while read _f; do \
|
|
||||||
chmod u+w "$${_f}"; \
|
|
||||||
chmod g-w "$${_f}"; \
|
|
||||||
chmod o=g "$${_f}" ; \
|
|
||||||
done
|
|
||||||
|
|
||||||
# Actual make rules ############################################################
|
|
||||||
|
|
||||||
# Reemplazar todas las variables en los .in y pasarlas a los .out
|
|
||||||
%.out: %.in
|
|
||||||
sed -e "s/@NETWORK@/$(NETWORK)/g" \
|
|
||||||
-e "s,@LIBDIR@,$(LIBDIR),g" \
|
|
||||||
-e "s,@DOC@,$(DOC),g" \
|
|
||||||
-e "s,@CONTRIB@,$(CONTRIB),g" \
|
|
||||||
-e "s,@HOSTS@,$(HOSTS),g" \
|
|
||||||
-e "s,@BEADLE@,$(BEADLE),g" \
|
|
||||||
-e "s,@TINC@,$(TINC),g" \
|
|
||||||
-e "s,@LVPN@,$(LVPN),g" \
|
|
||||||
-e "s/@FLAGS@/$(FLAGS)/g" \
|
|
||||||
-e "s/@KEYSIZE@/$(KEYSIZE)/g" \
|
|
||||||
-e "s/@PORT@/$(PORT)/g" \
|
|
||||||
-e "s,@SUBNET@,$(SUBNET),g" \
|
|
||||||
-e "s,@SUBNET6@,$(SUBNET6),g" \
|
|
||||||
-e "s,@TEXTDOMAINDIR@,$(TEXTDOMAINDIR),g" \
|
|
||||||
-e "s/@TEXTDOMAIN@/$(TEXTDOMAIN)/g" \
|
|
||||||
'$<' > '$@'
|
|
||||||
$(TARGET)$(PREFIX)/bin/%: %.out
|
|
||||||
install -Dm755 '$<' '$@'
|
|
||||||
|
|
||||||
# How to generate man pages
|
|
||||||
%.1: %.markdown
|
%.1: %.markdown
|
||||||
pandoc --standalone \
|
pandoc --standalone \
|
||||||
--output='$@' \
|
--output='$@' \
|
||||||
--to=man \
|
--to=man \
|
||||||
'$<'
|
'$<'
|
||||||
# How to install man pages. We have to loop over the supported languages to
|
|
||||||
# create a rule for each language.
|
|
||||||
$(foreach lang,$(langs),$(eval \
|
|
||||||
$$(TARGET)$$(PREFIX)/share/man/$(patsubst en,.,$(lang))/man1/%.1: doc/$(lang)/%.1; \
|
|
||||||
install -Dm644 '$$<' '$$@' \
|
|
||||||
))
|
|
||||||
|
|
||||||
# Gettext translation files
|
|
||||||
%.mo: %.po
|
|
||||||
msgfmt -o '$@' '$<'
|
|
||||||
$(TARGET)$(TEXTDOMAINDIR)/%/LC_MESSAGES/$(TEXTDOMAIN).mo: locale/%/LC_MESSAGES/$(TEXTDOMAIN).mo
|
|
||||||
install -Dm644 '$<' '$@'
|
|
||||||
|
|
||||||
# Host configuration files
|
|
||||||
$(TARGET)$(HOSTS)/%: hosts/%
|
|
||||||
install -Dm644 '$<' '$@'
|
|
||||||
|
|
||||||
# Boilerplate ##################################################################
|
|
||||||
|
|
||||||
# You might have noticed that all of the targets that aren't actually files
|
|
||||||
# depend on 'PHONY'. This declares them as phony targets to make; it says
|
|
||||||
# "don't look at the filesystem for this on, it's a high-level rule, not a file"
|
|
||||||
# GNU Make does this by having a special target, '.PHONY' which you set to
|
|
||||||
# depend on all of your phony targets. I don't think that's very elegant.
|
|
||||||
# Because anything depending on a phony target becomes a phony target itself,
|
|
||||||
# I like to declare one phony target to make, 'PHONY', and have the rest of my
|
|
||||||
# phony targets depend on it.
|
|
||||||
PHONY:
|
|
||||||
.PHONY: PHONY
|
|
||||||
|
53
README.md
53
README.md
@ -1,70 +1,55 @@
|
|||||||
# LibreVPN
|
# Red Autónoma Pirata (RAP)
|
||||||
|
|
||||||
> http://librevpn.org.ar
|
> Un fork de LibreVPN, una red libre virtual.
|
||||||
|
|
||||||
LibreVPN es una red libre virtual.
|
Estos son los scripts de configuración y administración de la RAP
|
||||||
|
y aplican muchas de las acciones comunes sobre tinc.
|
||||||
|
|
||||||
Estos son los scripts de configuración y administración de la VPN y aplican
|
Para obtener ayuda, ejecutar `./rap -h`. Cada comando tiene su -h
|
||||||
muchas de las acciones comunes sobre tinc.
|
también.
|
||||||
|
|
||||||
Para obtener ayuda, ejecutar `lvpn -h`. Cada comando tiene su -h tambien.
|
|
||||||
|
|
||||||
## Crear un nodo
|
## Crear un nodo
|
||||||
|
|
||||||
lvpn init -h
|
rap init -h
|
||||||
|
|
||||||
## Dónde está la configuración de mi nodo?
|
## Dónde está la configuración de mi nodo?
|
||||||
|
|
||||||
En el directorio `nodos/`, esto permite mantener la configuración de
|
En el directorio `nodes/`, esto permite mantener la configuración de
|
||||||
varios nodos en una sola máquina, intercambiarlos o copiarlos a otras
|
varios nodos en una sola máquina, intercambiarlos o copiarlos a otras
|
||||||
máquinas.
|
máquinas.
|
||||||
|
|
||||||
Por cada cambio en la configuración tenés que usar `lvpn install` o
|
Por cada cambio en la configuración tenés que usar `rap install` o
|
||||||
`lvpn push` (dependiendo si es un nodo local o remoto).
|
`rap push` (dependiendo si es un nodo local o remoto).
|
||||||
|
|
||||||
## El nombre de mi nodo está lleno de guiones bajos y/o es feo
|
## El nombre de mi nodo está lleno de guiones bajos / no me gusta
|
||||||
|
|
||||||
Si no le diste un nombre a tu nodo, `lvpn` va a usar el nombre de tu
|
Si no le diste un nombre a tu nodo, `rap` va a usar el nombre de tu
|
||||||
máquina. Si cuando instalaste tu distro dejaste que el instalador elija
|
máquina. Si cuando instalaste tu distro dejaste que el instalador elija
|
||||||
por su cuenta, vas a tener un nombre de nodo lleno de guiones bajos en
|
por su cuenta, vas a tener un nombre de nodo lleno de guiones bajos en
|
||||||
lugar de los caracteres que tinc no acepta (por ejemplo, "-" se
|
lugar de los caracteres que tinc no acepta (por ejemplo, "-" se
|
||||||
convierte en "\_") y además el modelo de tu computadora.
|
convierte en "\_") y además el modelo de tu computadora.
|
||||||
|
|
||||||
Si querés cambiar esto lo mejor es cambiando el hostname de tu
|
Si querés cambiar esto lo mejor es cambiando el "hostname" de tu
|
||||||
computadora, siguiendo los pasos que indique tu distro. Sino, agregá un
|
computadora, siguiendo los pasos que indique tu distro. Sino, agregá un
|
||||||
nombre al comando `lvpn init un_nombre_lindo`.
|
nombre al comando `./rap init un_nombre_lindo`.
|
||||||
|
|
||||||
## Cómo me conecto con otro nodo?
|
## Cómo me conecto a la red?
|
||||||
|
|
||||||
Enviá tu archivo de nodo a la lista vpn@hackcoop.com.ar o dáselo a
|
Esta es una red de confianza, podés crear e intercambiar nodos con tu
|
||||||
alguien que ya esté dentro de la red.
|
grupx de afinidad ;)
|
||||||
|
|
||||||
Luego, conectate a ese nodo con:
|
|
||||||
|
|
||||||
lvpn connectto tu_nodo el_otro_nodo
|
|
||||||
lvpn install tu_nodo
|
|
||||||
|
|
||||||
## Lo puedo usar en Android?
|
## Lo puedo usar en Android?
|
||||||
|
|
||||||
Sí! Instalá Tinc for Android desde [F-Droid](https://f-droid.org) y
|
Sí! Instalá Tinc for Android desde [F-Droid](https://f-droid.org) y
|
||||||
crea un nodo con `lvpn init -A`.
|
crea un nodo con `./rap init -A`.
|
||||||
|
|
||||||
## Requisitos
|
## Requisitos
|
||||||
|
|
||||||
tinc (1 o 1.1), avahi-daemon, bash.
|
`tinc`, `bash`.
|
||||||
|
|
||||||
Además los scripts informan sobre otros comandos que pueden llegar a
|
Además los scripts informan sobre otros comandos que pueden llegar a
|
||||||
necesitar.
|
necesitar.
|
||||||
|
|
||||||
## Instalación en el sistema
|
|
||||||
|
|
||||||
sudo make install PREFIX=/usr
|
|
||||||
|
|
||||||
|
|
||||||
## Desarrolladoras
|
## Desarrolladoras
|
||||||
|
|
||||||
Ver _doc/CONVENCIONES.markdown_.
|
Ver _doc/CONVENCIONES.markdown_.
|
||||||
|
|
||||||
## Wiki
|
|
||||||
|
|
||||||
http://wiki.hackcoop.com.ar/Categoría:LibreVPN
|
|
||||||
|
Binary file not shown.
@ -1,53 +0,0 @@
|
|||||||
#!/usr/bin/env python2
|
|
||||||
# avahi-alias.py
|
|
||||||
|
|
||||||
import avahi, dbus
|
|
||||||
from encodings.idna import ToASCII
|
|
||||||
|
|
||||||
# Got these from /usr/include/avahi-common/defs.h
|
|
||||||
CLASS_IN = 0x01
|
|
||||||
TYPE_CNAME = 0x05
|
|
||||||
|
|
||||||
TTL = 60
|
|
||||||
|
|
||||||
def publish_cname(cname):
|
|
||||||
bus = dbus.SystemBus()
|
|
||||||
server = dbus.Interface(bus.get_object(avahi.DBUS_NAME, avahi.DBUS_PATH_SERVER),
|
|
||||||
avahi.DBUS_INTERFACE_SERVER)
|
|
||||||
group = dbus.Interface(bus.get_object(avahi.DBUS_NAME, server.EntryGroupNew()),
|
|
||||||
avahi.DBUS_INTERFACE_ENTRY_GROUP)
|
|
||||||
|
|
||||||
rdata = createRR(server.GetHostNameFqdn())
|
|
||||||
cname = encode_dns(cname)
|
|
||||||
|
|
||||||
group.AddRecord(avahi.IF_UNSPEC, avahi.PROTO_UNSPEC, dbus.UInt32(0),
|
|
||||||
cname, CLASS_IN, TYPE_CNAME, TTL, rdata)
|
|
||||||
group.Commit()
|
|
||||||
|
|
||||||
|
|
||||||
def encode_dns(name):
|
|
||||||
out = []
|
|
||||||
for part in name.split('.'):
|
|
||||||
if len(part) == 0: continue
|
|
||||||
out.append(ToASCII(part))
|
|
||||||
return '.'.join(out)
|
|
||||||
|
|
||||||
def createRR(name):
|
|
||||||
out = []
|
|
||||||
for part in name.split('.'):
|
|
||||||
if len(part) == 0: continue
|
|
||||||
out.append(chr(len(part)))
|
|
||||||
out.append(ToASCII(part))
|
|
||||||
out.append('\0')
|
|
||||||
return ''.join(out)
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
|
||||||
import time, sys, locale
|
|
||||||
for each in sys.argv[1:]:
|
|
||||||
name = unicode(each, locale.getpreferredencoding())
|
|
||||||
publish_cname(name)
|
|
||||||
try:
|
|
||||||
# Just loop forever
|
|
||||||
while 1: time.sleep(60)
|
|
||||||
except KeyboardInterrupt:
|
|
||||||
print "Exiting"
|
|
12
bin/cronjob
12
bin/cronjob
@ -1,12 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
|
|
||||||
DIR="/home/fauno/projects/graph/"
|
|
||||||
GRAPHWEB="/srv/http/hack.lab/graph/current.png"
|
|
||||||
|
|
||||||
pushd $DIR
|
|
||||||
|
|
||||||
$DIR/bin/graph | \
|
|
||||||
tee graph.dot | \
|
|
||||||
circo -Tpng > $GRAPHWEB
|
|
||||||
|
|
||||||
git commit -m "Actualización $(date +"%Y.%m.%d %Hhs")" graph.dot
|
|
49
bin/graph
49
bin/graph
@ -1,49 +0,0 @@
|
|||||||
#!/usr/bin/env ruby
|
|
||||||
|
|
||||||
begin
|
|
||||||
require 'graphviz'
|
|
||||||
rescue
|
|
||||||
puts 'Este script necesita ruby-graphviz para funcionar'
|
|
||||||
exit 1
|
|
||||||
end
|
|
||||||
|
|
||||||
# Encontrar los nodos y sus uniones
|
|
||||||
re_nodes = /(\w+) to (\w+)/
|
|
||||||
|
|
||||||
# Encontrar las conexiones en la red
|
|
||||||
re_log = /([0-9\-: ]+).*Edges:(.*)End of edges./m
|
|
||||||
|
|
||||||
# Pedirle a tincd que imprima toda la red
|
|
||||||
# Necesita iniciarse con los flags --logfile -U nobody
|
|
||||||
`sudo -u nobody killall -SIGUSR2 tincd`
|
|
||||||
|
|
||||||
# Salir si no se pudo enviar la señal
|
|
||||||
exit 1 if $?.to_i > 0
|
|
||||||
|
|
||||||
# Leer el log buscando la lista de edges
|
|
||||||
log = IO::read('/var/log/tinc.lab.log').scan(re_log).to_s
|
|
||||||
|
|
||||||
# Crear el grafico
|
|
||||||
g = GraphViz::new('lab', 'type' => 'graph')
|
|
||||||
|
|
||||||
# Estilo
|
|
||||||
g.node[:fontname] = 'DejaVu Sans'
|
|
||||||
g.node[:fontsize] = '12'
|
|
||||||
g.node[:style] = 'filled'
|
|
||||||
g.node[:fillcolor] = '#b3e86a'
|
|
||||||
|
|
||||||
# Buscar todas las uniones
|
|
||||||
log.scan(re_nodes) do |n|
|
|
||||||
|
|
||||||
# Agregar el nodo
|
|
||||||
g.add_node(n[0])
|
|
||||||
|
|
||||||
# Agregar la conexión
|
|
||||||
g.add_edge(n[0], n[1])
|
|
||||||
|
|
||||||
end
|
|
||||||
|
|
||||||
# Salida
|
|
||||||
#g.output(:png => '/tmp/graph.png')
|
|
||||||
g.output(:dot => nil)
|
|
||||||
#puts '// El grafico se guardo en /tmp/graph.png'
|
|
Binary file not shown.
Binary file not shown.
BIN
bin/natpmpc
BIN
bin/natpmpc
Binary file not shown.
83
bin/tinc2dot
83
bin/tinc2dot
@ -1,83 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
#
|
|
||||||
# grafico tinc2dot version 0.2.1
|
|
||||||
# Ernesto bazzano (c) Liberado bajo licencia AGPL
|
|
||||||
#
|
|
||||||
# Basado en los ejemplos de graphviz
|
|
||||||
# http://graphviz.org/content/psg
|
|
||||||
# http://graphviz.org/content/fsm
|
|
||||||
#
|
|
||||||
# Documentación: http://lab.hackcoop.com.ar/projects/librevpn/wiki/Tinc2dot
|
|
||||||
#
|
|
||||||
# requiere: graphviz
|
|
||||||
# optativo avahi-browse
|
|
||||||
|
|
||||||
DOT="/tmp/lvpn.dot"
|
|
||||||
|
|
||||||
DIA=$(date)
|
|
||||||
NODOS=$( cat $DOT | grep ">" )
|
|
||||||
SERVICIOS=$(avahi-browse --all -t -p | sort -u | sed 's/\ /-/g' )
|
|
||||||
|
|
||||||
echo "digraph Lab {
|
|
||||||
graph [fontsize=30 labelloc=\"b\" splines=true overlap=false rankdir=\"LR\"];
|
|
||||||
layout=circo;
|
|
||||||
size=\"10, 7.5\" ;
|
|
||||||
pad=\"0.5\";
|
|
||||||
stylesheet=\"style.css\";
|
|
||||||
mindist=0.05;
|
|
||||||
node [style = \"filled\", shape=\"circle\", margin=\".5,.5\", fixedsize=true, width=1.5, style=\"filled\"];
|
|
||||||
edge [penwidth=2, arrowsize=\"1.5\", margin=\"1,1\", pencolor=\"1 1 1\"];
|
|
||||||
|
|
||||||
${NODOS}
|
|
||||||
|
|
||||||
label=\"\nLibreVPN - ${DIA} - http://anastasia.local/tinc2dot\"
|
|
||||||
"
|
|
||||||
|
|
||||||
for NODO in $(echo $NODOS | sed 's/->/\n/g; s/;/\n/g; s/\ //g' | sort -u); do
|
|
||||||
|
|
||||||
ENLACES=$(echo $NODOS | sed 's/;/\n/g' | grep $NODO | wc -l)
|
|
||||||
GRUESO=$(echo $ENLACES/2 | bc -l | sed 's/\..*//g')
|
|
||||||
COLOR=$(echo \(1/10*0$GRUESO\)+0.3 | bc -l)
|
|
||||||
SATURACION="0.$(echo $((-11+$ENLACES)) | sed 's/-//g')"
|
|
||||||
|
|
||||||
#IP=$( ping -c 1 $NODO.local | grep from | sed 's/.*(\(.*\..*\..*\..*\)).*/\1/g')
|
|
||||||
if [ "$ENLACES" == "1" ]; then
|
|
||||||
ESTILO="style=\"dotted\""
|
|
||||||
GRUESO=1
|
|
||||||
else
|
|
||||||
ESTILO=""
|
|
||||||
fi
|
|
||||||
|
|
||||||
echo "$NODO [ $ESTILO \"
|
|
||||||
fillcolor=\"$COLOR $SATURACION .85\", \
|
|
||||||
penwidth=\"$(echo 14/10*$GRUESO+.8 | bc -l)\", \
|
|
||||||
tooltip=\"$(echo $(echo $SERVICIOS | sed 's/ /\n/g' | grep $NODO))\", \
|
|
||||||
URL=\"/vpn/?nodo=${NODO}\",\
|
|
||||||
width=\"$(echo \(3/10*$GRUESO\)+1.2 | bc -l)\", \
|
|
||||||
|
|
||||||
label=<<table border=\"0\" cellborder=\"0\" cellpadding=\"0\" align=\"center\" colspan=\"2\" >\
|
|
||||||
<tr><td><img src=\"vpn/avatar/${NODO}.png\" /></td><td>${NODO}</td></tr>\
|
|
||||||
</table>>\
|
|
||||||
]"
|
|
||||||
|
|
||||||
done
|
|
||||||
|
|
||||||
exit
|
|
||||||
image=\"vpn/img/${NODO}.png\",\
|
|
||||||
#fillcolor=\"$(echo \(1/10*0$GRUESO\)+0.5 | bc -l) $(echo 1/8*$GRUESO | bc -l) $(echo $GRUESO/10+.7 | bc -l)\", \
|
|
||||||
|
|
||||||
Que hay de nuevo:
|
|
||||||
|
|
||||||
-Mejoras graficas
|
|
||||||
-Solo una linea con doble flecha
|
|
||||||
-colores segun enlaces
|
|
||||||
-Mas enlaces
|
|
||||||
-color rojo
|
|
||||||
-mas saturacion
|
|
||||||
-Menos enlaces
|
|
||||||
-color azul
|
|
||||||
-mas saturacion
|
|
||||||
-enlaces promedio
|
|
||||||
-menos saturacion
|
|
||||||
-Avatares pequeños
|
|
||||||
-Listas
|
|
Binary file not shown.
@ -1,31 +0,0 @@
|
|||||||
<?php
|
|
||||||
# Collectd LibreVPN plugin
|
|
||||||
#
|
|
||||||
# Plugin para Collectd Graph Panel
|
|
||||||
# http://pommi.nethuis.nl/category/cgp/
|
|
||||||
#
|
|
||||||
# Copiar al directorio plugin/
|
|
||||||
|
|
||||||
require_once 'conf/common.inc.php';
|
|
||||||
require_once 'type/Default.class.php';
|
|
||||||
require_once 'inc/collectd.inc.php';
|
|
||||||
|
|
||||||
## LAYOUT
|
|
||||||
# lvpn/gauge-nodes.rrd
|
|
||||||
|
|
||||||
$obj = new Type_Default($CONFIG);
|
|
||||||
$obj->data_sources = array('value');
|
|
||||||
$obj->ds_names = array(
|
|
||||||
'nodes' => 'Total',
|
|
||||||
'unknown-peers' => 'Desconocidos'
|
|
||||||
);
|
|
||||||
$obj->colors = array(
|
|
||||||
'nodes' => 'ff0000',
|
|
||||||
'unknown-peers' => '00ff00');
|
|
||||||
|
|
||||||
$obj->rrd_title = 'LibreVPN';
|
|
||||||
$obj->rrd_vertical = 'Nodos';
|
|
||||||
$obj->rrd_format = '%.0lf';
|
|
||||||
|
|
||||||
collectd_flush($obj->identifiers);
|
|
||||||
$obj->rrd_graph();
|
|
@ -1,59 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
#
|
|
||||||
# lvpn
|
|
||||||
#
|
|
||||||
# Copyright (c) 2011-2014 LibreVPN <vpn@hackcoop.com.ar>
|
|
||||||
#
|
|
||||||
# See AUTHORS for a list of contributors
|
|
||||||
#
|
|
||||||
# This program is free software; you can redistribute it and/or modify
|
|
||||||
# it under the terms of the GNU Affero General Public License as
|
|
||||||
# published by the Free Software Foundation; either version 3 of the
|
|
||||||
# License, or (at your option) any later version.
|
|
||||||
#
|
|
||||||
# This program is distributed in the hope that it will be useful,
|
|
||||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
||||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
||||||
# General Public License for more details.
|
|
||||||
#
|
|
||||||
# You should have received a copy of the GNU Affero General
|
|
||||||
# Public License along with this program. If not, see
|
|
||||||
# <http://www.gnu.org/licenses/>.
|
|
||||||
#
|
|
||||||
# Agregar a collectd.conf
|
|
||||||
#
|
|
||||||
# <Plugin exec>
|
|
||||||
# Exec "daemon:daemon" "/usr/bin/collectd-lvpn" "lvpn" "63"
|
|
||||||
# </Plugin>
|
|
||||||
|
|
||||||
NETWORK="${1:-lvpn}"
|
|
||||||
DOT="/tmp/${NETWORK}.dot"
|
|
||||||
INTERVAL="${2:-63}"
|
|
||||||
|
|
||||||
if test ! -r "${DOT}" ; then
|
|
||||||
echo "No existe ${DOT} o no se puede leer, agregá 'GraphDumpFile = ${DOT}' en tinc.conf"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# tipo_datos tipo_valor valor
|
|
||||||
function putval() {
|
|
||||||
stdbuf --output=L \
|
|
||||||
printf "PUTVAL \"%s/%s/%s-%s\" interval=%d N:%d\n" \
|
|
||||||
"${COLLECTD_HOSTNAME:-${HOSTNAME}}" \
|
|
||||||
"${NETWORK}" \
|
|
||||||
"${1}" "${2}" \
|
|
||||||
"${INTERVAL}" \
|
|
||||||
"${3}"
|
|
||||||
}
|
|
||||||
|
|
||||||
# El script duerme para siempre y cuando se despierta escupe comandos de
|
|
||||||
# collectd
|
|
||||||
while sleep ${INTERVAL}; do
|
|
||||||
# obtener la cantidad de nodos
|
|
||||||
nodes=$(grep label "${DOT}" | cut -d" " -f1 | tr -d "\t" | wc -l)
|
|
||||||
# y guardarlos
|
|
||||||
putval "gauge" "nodes" "${nodes}"
|
|
||||||
|
|
||||||
unknown=$(lvpn unknown-peers | wc -l)
|
|
||||||
putval "gauge" "unknown-peers" "${unknown}"
|
|
||||||
done
|
|
@ -1,4 +0,0 @@
|
|||||||
# Nodos que actuan de gateways hacia internet
|
|
||||||
|
|
||||||
* naven.local
|
|
||||||
* agregá el tuyo
|
|
@ -1,65 +0,0 @@
|
|||||||
# Correo entre nodos de LibreVPN
|
|
||||||
|
|
||||||
Copiá los archivos main.cf y transport en este directorio a
|
|
||||||
`/etc/postfix` o adaptalos a tu configuración actual.
|
|
||||||
|
|
||||||
Lo importante es cambiar el valor de `myhostname` por el nombre de tu
|
|
||||||
nodo.local, lo que va a ser el @nodo.local de tu cuenta normal. Lo
|
|
||||||
mismo para transport.
|
|
||||||
|
|
||||||
> Nota: buscá los valores para cambiar entre {{llaves}}, por ejemplo en
|
|
||||||
> transport y main.cf está la variable {{node}} que tenés que cambiar
|
|
||||||
> por el nombre de tu nodo
|
|
||||||
|
|
||||||
Por ejemplo para fauno en naven.local, la dirección de correo va a ser
|
|
||||||
`fauno@naven.local`.
|
|
||||||
|
|
||||||
Los correos recibidos se guardan en `~/Maildir` para cambiar esto,
|
|
||||||
adapta la variable `home_mailbox`.
|
|
||||||
|
|
||||||
Además, para que postfix reconozca el archivo transport, hay que
|
|
||||||
ejecutar `postmap /etc/postfix/transport` cada vez que se lo modifica.
|
|
||||||
|
|
||||||
|
|
||||||
# Email between LibreVPN nodes
|
|
||||||
|
|
||||||
Copy `main.cf` and `transport` inside `/etc/postfix` or adapt them to
|
|
||||||
your actual config.
|
|
||||||
|
|
||||||
You need to change the `myhostname` variable to the name of your
|
|
||||||
node.local, which is going to be your @node.local address. Also set
|
|
||||||
your node in transport.
|
|
||||||
|
|
||||||
> Note: Look for {{variable}} in both files, ie {{node}}
|
|
||||||
|
|
||||||
For instance, fauno on naven.local would have `fauno@naven.local` as his
|
|
||||||
address.
|
|
||||||
|
|
||||||
Email will be saved on `~/Maildir`. To change this, adapt the
|
|
||||||
`home_mailbox` var.
|
|
||||||
|
|
||||||
Remember to run `postmap /etc/postfix/transport` for postfix to
|
|
||||||
recognize this file.
|
|
||||||
|
|
||||||
|
|
||||||
# Test
|
|
||||||
|
|
||||||
## Artesanal
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
$ echo -e "From: vos@nodo.local\nTo: fauno@yap.local\nSubject: hola\n\nhola!" | sendmail -t
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
## Mail
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
$ mail fauno@yap.local<enter>
|
|
||||||
|
|
||||||
Subject: hola
|
|
||||||
|
|
||||||
hola<ctrl-d>
|
|
||||||
|
|
||||||
```
|
|
@ -1,3 +0,0 @@
|
|||||||
# convert person@node.local to person@node.librevpn.org.ar for delivery
|
|
||||||
# from the vpn to internet
|
|
||||||
/^(.*)@(.*)\.local$/ $1@$2.librevpn.org.ar
|
|
@ -1,6 +0,0 @@
|
|||||||
# add this to your postfix main.cf to convert between librevpn public
|
|
||||||
# and private addresses
|
|
||||||
|
|
||||||
sender_canonical_maps = regexp:/etc/postfix/from_lvpn
|
|
||||||
recipient_canonical_maps = regexp:/etc/postfix/to_lvpn
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
|||||||
# convert person@node.librevpn.org.ar address to person@node.local for
|
|
||||||
# delivery inside the vpn
|
|
||||||
/^(.*)@(.*)\.librevpn\.org\.ar$/ $1@$2.local
|
|
@ -1,672 +0,0 @@
|
|||||||
# Global Postfix configuration file. This file lists only a subset
|
|
||||||
# of all parameters. For the syntax, and for a complete parameter
|
|
||||||
# list, see the postconf(5) manual page (command: "man 5 postconf").
|
|
||||||
#
|
|
||||||
# For common configuration examples, see BASIC_CONFIGURATION_README
|
|
||||||
# and STANDARD_CONFIGURATION_README. To find these documents, use
|
|
||||||
# the command "postconf html_directory readme_directory", or go to
|
|
||||||
# http://www.postfix.org/BASIC_CONFIGURATION_README.html etc.
|
|
||||||
#
|
|
||||||
# For best results, change no more than 2-3 parameters at a time,
|
|
||||||
# and test if Postfix still works after every change.
|
|
||||||
|
|
||||||
# SOFT BOUNCE
|
|
||||||
#
|
|
||||||
# The soft_bounce parameter provides a limited safety net for
|
|
||||||
# testing. When soft_bounce is enabled, mail will remain queued that
|
|
||||||
# would otherwise bounce. This parameter disables locally-generated
|
|
||||||
# bounces, and prevents the SMTP server from rejecting mail permanently
|
|
||||||
# (by changing 5xx replies into 4xx replies). However, soft_bounce
|
|
||||||
# is no cure for address rewriting mistakes or mail routing mistakes.
|
|
||||||
#
|
|
||||||
soft_bounce = yes
|
|
||||||
|
|
||||||
# LOCAL PATHNAME INFORMATION
|
|
||||||
#
|
|
||||||
# The queue_directory specifies the location of the Postfix queue.
|
|
||||||
# This is also the root directory of Postfix daemons that run chrooted.
|
|
||||||
# See the files in examples/chroot-setup for setting up Postfix chroot
|
|
||||||
# environments on different UNIX systems.
|
|
||||||
#
|
|
||||||
queue_directory = /var/spool/postfix
|
|
||||||
|
|
||||||
# The command_directory parameter specifies the location of all
|
|
||||||
# postXXX commands.
|
|
||||||
#
|
|
||||||
command_directory = /usr/sbin
|
|
||||||
|
|
||||||
# The daemon_directory parameter specifies the location of all Postfix
|
|
||||||
# daemon programs (i.e. programs listed in the master.cf file). This
|
|
||||||
# directory must be owned by root.
|
|
||||||
#
|
|
||||||
daemon_directory = /usr/lib/postfix
|
|
||||||
|
|
||||||
# The data_directory parameter specifies the location of Postfix-writable
|
|
||||||
# data files (caches, random numbers). This directory must be owned
|
|
||||||
# by the mail_owner account (see below).
|
|
||||||
#
|
|
||||||
data_directory = /var/lib/postfix
|
|
||||||
|
|
||||||
# QUEUE AND PROCESS OWNERSHIP
|
|
||||||
#
|
|
||||||
# The mail_owner parameter specifies the owner of the Postfix queue
|
|
||||||
# and of most Postfix daemon processes. Specify the name of a user
|
|
||||||
# account THAT DOES NOT SHARE ITS USER OR GROUP ID WITH OTHER ACCOUNTS
|
|
||||||
# AND THAT OWNS NO OTHER FILES OR PROCESSES ON THE SYSTEM. In
|
|
||||||
# particular, don't specify nobody or daemon. PLEASE USE A DEDICATED
|
|
||||||
# USER.
|
|
||||||
#
|
|
||||||
mail_owner = postfix
|
|
||||||
|
|
||||||
# The default_privs parameter specifies the default rights used by
|
|
||||||
# the local delivery agent for delivery to external file or command.
|
|
||||||
# These rights are used in the absence of a recipient user context.
|
|
||||||
# DO NOT SPECIFY A PRIVILEGED USER OR THE POSTFIX OWNER.
|
|
||||||
#
|
|
||||||
#default_privs = nobody
|
|
||||||
|
|
||||||
# INTERNET HOST AND DOMAIN NAMES
|
|
||||||
#
|
|
||||||
# The myhostname parameter specifies the internet hostname of this
|
|
||||||
# mail system. The default is to use the fully-qualified domain name
|
|
||||||
# from gethostname(). $myhostname is used as a default value for many
|
|
||||||
# other configuration parameters.
|
|
||||||
#
|
|
||||||
#myhostname = host.domain.tld
|
|
||||||
#myhostname = virtual.domain.tld
|
|
||||||
myhostname = {{node}}.local
|
|
||||||
|
|
||||||
# The mydomain parameter specifies the local internet domain name.
|
|
||||||
# The default is to use $myhostname minus the first component.
|
|
||||||
# $mydomain is used as a default value for many other configuration
|
|
||||||
# parameters.
|
|
||||||
#
|
|
||||||
mydomain = $myhostname
|
|
||||||
|
|
||||||
# SENDING MAIL
|
|
||||||
#
|
|
||||||
# The myorigin parameter specifies the domain that locally-posted
|
|
||||||
# mail appears to come from. The default is to append $myhostname,
|
|
||||||
# which is fine for small sites. If you run a domain with multiple
|
|
||||||
# machines, you should (1) change this to $mydomain and (2) set up
|
|
||||||
# a domain-wide alias database that aliases each user to
|
|
||||||
# user@that.users.mailhost.
|
|
||||||
#
|
|
||||||
# For the sake of consistency between sender and recipient addresses,
|
|
||||||
# myorigin also specifies the default domain name that is appended
|
|
||||||
# to recipient addresses that have no @domain part.
|
|
||||||
#
|
|
||||||
#myorigin = $myhostname
|
|
||||||
myorigin = $mydomain
|
|
||||||
|
|
||||||
# RECEIVING MAIL
|
|
||||||
|
|
||||||
# The inet_interfaces parameter specifies the network interface
|
|
||||||
# addresses that this mail system receives mail on. By default,
|
|
||||||
# the software claims all active interfaces on the machine. The
|
|
||||||
# parameter also controls delivery of mail to user@[ip.address].
|
|
||||||
#
|
|
||||||
# See also the proxy_interfaces parameter, for network addresses that
|
|
||||||
# are forwarded to us via a proxy or network address translator.
|
|
||||||
#
|
|
||||||
# Note: you need to stop/start Postfix when this parameter changes.
|
|
||||||
#
|
|
||||||
inet_interfaces = all
|
|
||||||
#inet_interfaces = $myhostname
|
|
||||||
#inet_interfaces = $myhostname, localhost
|
|
||||||
|
|
||||||
# The proxy_interfaces parameter specifies the network interface
|
|
||||||
# addresses that this mail system receives mail on by way of a
|
|
||||||
# proxy or network address translation unit. This setting extends
|
|
||||||
# the address list specified with the inet_interfaces parameter.
|
|
||||||
#
|
|
||||||
# You must specify your proxy/NAT addresses when your system is a
|
|
||||||
# backup MX host for other domains, otherwise mail delivery loops
|
|
||||||
# will happen when the primary MX host is down.
|
|
||||||
#
|
|
||||||
#proxy_interfaces =
|
|
||||||
#proxy_interfaces = 1.2.3.4
|
|
||||||
|
|
||||||
# The mydestination parameter specifies the list of domains that this
|
|
||||||
# machine considers itself the final destination for.
|
|
||||||
#
|
|
||||||
# These domains are routed to the delivery agent specified with the
|
|
||||||
# local_transport parameter setting. By default, that is the UNIX
|
|
||||||
# compatible delivery agent that lookups all recipients in /etc/passwd
|
|
||||||
# and /etc/aliases or their equivalent.
|
|
||||||
#
|
|
||||||
# The default is $myhostname + localhost.$mydomain. On a mail domain
|
|
||||||
# gateway, you should also include $mydomain.
|
|
||||||
#
|
|
||||||
# Do not specify the names of virtual domains - those domains are
|
|
||||||
# specified elsewhere (see VIRTUAL_README).
|
|
||||||
#
|
|
||||||
# Do not specify the names of domains that this machine is backup MX
|
|
||||||
# host for. Specify those names via the relay_domains settings for
|
|
||||||
# the SMTP server, or use permit_mx_backup if you are lazy (see
|
|
||||||
# STANDARD_CONFIGURATION_README).
|
|
||||||
#
|
|
||||||
# The local machine is always the final destination for mail addressed
|
|
||||||
# to user@[the.net.work.address] of an interface that the mail system
|
|
||||||
# receives mail on (see the inet_interfaces parameter).
|
|
||||||
#
|
|
||||||
# Specify a list of host or domain names, /file/name or type:table
|
|
||||||
# patterns, separated by commas and/or whitespace. A /file/name
|
|
||||||
# pattern is replaced by its contents; a type:table is matched when
|
|
||||||
# a name matches a lookup key (the right-hand side is ignored).
|
|
||||||
# Continue long lines by starting the next line with whitespace.
|
|
||||||
#
|
|
||||||
# See also below, section "REJECTING MAIL FOR UNKNOWN LOCAL USERS".
|
|
||||||
#
|
|
||||||
#mydestination = $myhostname, localhost.$mydomain, localhost
|
|
||||||
#mydestination = $myhostname, localhost.$mydomain, localhost, $mydomain
|
|
||||||
#mydestination = $myhostname, localhost.$mydomain, localhost, $mydomain,
|
|
||||||
# mail.$mydomain, www.$mydomain, ftp.$mydomain
|
|
||||||
|
|
||||||
mydestination = $myhostname, {{node}}.librevpn.org.ar
|
|
||||||
|
|
||||||
# REJECTING MAIL FOR UNKNOWN LOCAL USERS
|
|
||||||
#
|
|
||||||
# The local_recipient_maps parameter specifies optional lookup tables
|
|
||||||
# with all names or addresses of users that are local with respect
|
|
||||||
# to $mydestination, $inet_interfaces or $proxy_interfaces.
|
|
||||||
#
|
|
||||||
# If this parameter is defined, then the SMTP server will reject
|
|
||||||
# mail for unknown local users. This parameter is defined by default.
|
|
||||||
#
|
|
||||||
# To turn off local recipient checking in the SMTP server, specify
|
|
||||||
# local_recipient_maps = (i.e. empty).
|
|
||||||
#
|
|
||||||
# The default setting assumes that you use the default Postfix local
|
|
||||||
# delivery agent for local delivery. You need to update the
|
|
||||||
# local_recipient_maps setting if:
|
|
||||||
#
|
|
||||||
# - You define $mydestination domain recipients in files other than
|
|
||||||
# /etc/passwd, /etc/aliases, or the $virtual_alias_maps files.
|
|
||||||
# For example, you define $mydestination domain recipients in
|
|
||||||
# the $virtual_mailbox_maps files.
|
|
||||||
#
|
|
||||||
# - You redefine the local delivery agent in master.cf.
|
|
||||||
#
|
|
||||||
# - You redefine the "local_transport" setting in main.cf.
|
|
||||||
#
|
|
||||||
# - You use the "luser_relay", "mailbox_transport", or "fallback_transport"
|
|
||||||
# feature of the Postfix local delivery agent (see local(8)).
|
|
||||||
#
|
|
||||||
# Details are described in the LOCAL_RECIPIENT_README file.
|
|
||||||
#
|
|
||||||
# Beware: if the Postfix SMTP server runs chrooted, you probably have
|
|
||||||
# to access the passwd file via the proxymap service, in order to
|
|
||||||
# overcome chroot restrictions. The alternative, having a copy of
|
|
||||||
# the system passwd file in the chroot jail is just not practical.
|
|
||||||
#
|
|
||||||
# The right-hand side of the lookup tables is conveniently ignored.
|
|
||||||
# In the left-hand side, specify a bare username, an @domain.tld
|
|
||||||
# wild-card, or specify a user@domain.tld address.
|
|
||||||
#
|
|
||||||
local_recipient_maps = unix:passwd.byname $alias_maps
|
|
||||||
#local_recipient_maps = proxy:unix:passwd.byname $alias_maps
|
|
||||||
#local_recipient_maps =
|
|
||||||
|
|
||||||
# The unknown_local_recipient_reject_code specifies the SMTP server
|
|
||||||
# response code when a recipient domain matches $mydestination or
|
|
||||||
# ${proxy,inet}_interfaces, while $local_recipient_maps is non-empty
|
|
||||||
# and the recipient address or address local-part is not found.
|
|
||||||
#
|
|
||||||
# The default setting is 550 (reject mail) but it is safer to start
|
|
||||||
# with 450 (try again later) until you are certain that your
|
|
||||||
# local_recipient_maps settings are OK.
|
|
||||||
#
|
|
||||||
unknown_local_recipient_reject_code = 550
|
|
||||||
|
|
||||||
# TRUST AND RELAY CONTROL
|
|
||||||
|
|
||||||
# The mynetworks parameter specifies the list of "trusted" SMTP
|
|
||||||
# clients that have more privileges than "strangers".
|
|
||||||
#
|
|
||||||
# In particular, "trusted" SMTP clients are allowed to relay mail
|
|
||||||
# through Postfix. See the smtpd_recipient_restrictions parameter
|
|
||||||
# in postconf(5).
|
|
||||||
#
|
|
||||||
# You can specify the list of "trusted" network addresses by hand
|
|
||||||
# or you can let Postfix do it for you (which is the default).
|
|
||||||
#
|
|
||||||
# By default (mynetworks_style = subnet), Postfix "trusts" SMTP
|
|
||||||
# clients in the same IP subnetworks as the local machine.
|
|
||||||
# On Linux, this does works correctly only with interfaces specified
|
|
||||||
# with the "ifconfig" command.
|
|
||||||
#
|
|
||||||
# Specify "mynetworks_style = class" when Postfix should "trust" SMTP
|
|
||||||
# clients in the same IP class A/B/C networks as the local machine.
|
|
||||||
# Don't do this with a dialup site - it would cause Postfix to "trust"
|
|
||||||
# your entire provider's network. Instead, specify an explicit
|
|
||||||
# mynetworks list by hand, as described below.
|
|
||||||
#
|
|
||||||
# Specify "mynetworks_style = host" when Postfix should "trust"
|
|
||||||
# only the local machine.
|
|
||||||
#
|
|
||||||
#mynetworks_style = class
|
|
||||||
#mynetworks_style = subnet
|
|
||||||
#mynetworks_style = host
|
|
||||||
|
|
||||||
# Alternatively, you can specify the mynetworks list by hand, in
|
|
||||||
# which case Postfix ignores the mynetworks_style setting.
|
|
||||||
#
|
|
||||||
# Specify an explicit list of network/netmask patterns, where the
|
|
||||||
# mask specifies the number of bits in the network part of a host
|
|
||||||
# address.
|
|
||||||
#
|
|
||||||
# You can also specify the absolute pathname of a pattern file instead
|
|
||||||
# of listing the patterns here. Specify type:table for table-based lookups
|
|
||||||
# (the value on the table right-hand side is not used).
|
|
||||||
#
|
|
||||||
#mynetworks = 168.100.189.0/28, 127.0.0.0/8
|
|
||||||
#mynetworks = $config_directory/mynetworks
|
|
||||||
#mynetworks = hash:/etc/postfix/network_table
|
|
||||||
|
|
||||||
# The relay_domains parameter restricts what destinations this system will
|
|
||||||
# relay mail to. See the smtpd_recipient_restrictions description in
|
|
||||||
# postconf(5) for detailed information.
|
|
||||||
#
|
|
||||||
# By default, Postfix relays mail
|
|
||||||
# - from "trusted" clients (IP address matches $mynetworks) to any destination,
|
|
||||||
# - from "untrusted" clients to destinations that match $relay_domains or
|
|
||||||
# subdomains thereof, except addresses with sender-specified routing.
|
|
||||||
# The default relay_domains value is $mydestination.
|
|
||||||
#
|
|
||||||
# In addition to the above, the Postfix SMTP server by default accepts mail
|
|
||||||
# that Postfix is final destination for:
|
|
||||||
# - destinations that match $inet_interfaces or $proxy_interfaces,
|
|
||||||
# - destinations that match $mydestination
|
|
||||||
# - destinations that match $virtual_alias_domains,
|
|
||||||
# - destinations that match $virtual_mailbox_domains.
|
|
||||||
# These destinations do not need to be listed in $relay_domains.
|
|
||||||
#
|
|
||||||
# Specify a list of hosts or domains, /file/name patterns or type:name
|
|
||||||
# lookup tables, separated by commas and/or whitespace. Continue
|
|
||||||
# long lines by starting the next line with whitespace. A file name
|
|
||||||
# is replaced by its contents; a type:name table is matched when a
|
|
||||||
# (parent) domain appears as lookup key.
|
|
||||||
#
|
|
||||||
# NOTE: Postfix will not automatically forward mail for domains that
|
|
||||||
# list this system as their primary or backup MX host. See the
|
|
||||||
# permit_mx_backup restriction description in postconf(5).
|
|
||||||
#
|
|
||||||
#relay_domains = $mydestination
|
|
||||||
|
|
||||||
# INTERNET OR INTRANET
|
|
||||||
|
|
||||||
# The relayhost parameter specifies the default host to send mail to
|
|
||||||
# when no entry is matched in the optional transport(5) table. When
|
|
||||||
# no relayhost is given, mail is routed directly to the destination.
|
|
||||||
#
|
|
||||||
# On an intranet, specify the organizational domain name. If your
|
|
||||||
# internal DNS uses no MX records, specify the name of the intranet
|
|
||||||
# gateway host instead.
|
|
||||||
#
|
|
||||||
# In the case of SMTP, specify a domain, host, host:port, [host]:port,
|
|
||||||
# [address] or [address]:port; the form [host] turns off MX lookups.
|
|
||||||
#
|
|
||||||
# If you're connected via UUCP, see also the default_transport parameter.
|
|
||||||
#
|
|
||||||
#relayhost = $mydomain
|
|
||||||
#relayhost = [gateway.my.domain]
|
|
||||||
#relayhost = [mailserver.isp.tld]
|
|
||||||
#relayhost = uucphost
|
|
||||||
#relayhost = [an.ip.add.ress]
|
|
||||||
|
|
||||||
# REJECTING UNKNOWN RELAY USERS
|
|
||||||
#
|
|
||||||
# The relay_recipient_maps parameter specifies optional lookup tables
|
|
||||||
# with all addresses in the domains that match $relay_domains.
|
|
||||||
#
|
|
||||||
# If this parameter is defined, then the SMTP server will reject
|
|
||||||
# mail for unknown relay users. This feature is off by default.
|
|
||||||
#
|
|
||||||
# The right-hand side of the lookup tables is conveniently ignored.
|
|
||||||
# In the left-hand side, specify an @domain.tld wild-card, or specify
|
|
||||||
# a user@domain.tld address.
|
|
||||||
#
|
|
||||||
#relay_recipient_maps = hash:/etc/postfix/relay_recipients
|
|
||||||
|
|
||||||
# INPUT RATE CONTROL
|
|
||||||
#
|
|
||||||
# The in_flow_delay configuration parameter implements mail input
|
|
||||||
# flow control. This feature is turned on by default, although it
|
|
||||||
# still needs further development (it's disabled on SCO UNIX due
|
|
||||||
# to an SCO bug).
|
|
||||||
#
|
|
||||||
# A Postfix process will pause for $in_flow_delay seconds before
|
|
||||||
# accepting a new message, when the message arrival rate exceeds the
|
|
||||||
# message delivery rate. With the default 100 SMTP server process
|
|
||||||
# limit, this limits the mail inflow to 100 messages a second more
|
|
||||||
# than the number of messages delivered per second.
|
|
||||||
#
|
|
||||||
# Specify 0 to disable the feature. Valid delays are 0..10.
|
|
||||||
#
|
|
||||||
#in_flow_delay = 1s
|
|
||||||
|
|
||||||
# ADDRESS REWRITING
|
|
||||||
#
|
|
||||||
# The ADDRESS_REWRITING_README document gives information about
|
|
||||||
# address masquerading or other forms of address rewriting including
|
|
||||||
# username->Firstname.Lastname mapping.
|
|
||||||
|
|
||||||
# ADDRESS REDIRECTION (VIRTUAL DOMAIN)
|
|
||||||
#
|
|
||||||
# The VIRTUAL_README document gives information about the many forms
|
|
||||||
# of domain hosting that Postfix supports.
|
|
||||||
|
|
||||||
# "USER HAS MOVED" BOUNCE MESSAGES
|
|
||||||
#
|
|
||||||
# See the discussion in the ADDRESS_REWRITING_README document.
|
|
||||||
|
|
||||||
# TRANSPORT MAP
|
|
||||||
#
|
|
||||||
# See the discussion in the ADDRESS_REWRITING_README document.
|
|
||||||
|
|
||||||
# ALIAS DATABASE
|
|
||||||
#
|
|
||||||
# The alias_maps parameter specifies the list of alias databases used
|
|
||||||
# by the local delivery agent. The default list is system dependent.
|
|
||||||
#
|
|
||||||
# On systems with NIS, the default is to search the local alias
|
|
||||||
# database, then the NIS alias database. See aliases(5) for syntax
|
|
||||||
# details.
|
|
||||||
#
|
|
||||||
# If you change the alias database, run "postalias /etc/aliases" (or
|
|
||||||
# wherever your system stores the mail alias file), or simply run
|
|
||||||
# "newaliases" to build the necessary DBM or DB file.
|
|
||||||
#
|
|
||||||
# It will take a minute or so before changes become visible. Use
|
|
||||||
# "postfix reload" to eliminate the delay.
|
|
||||||
#
|
|
||||||
#alias_maps = dbm:/etc/aliases
|
|
||||||
#alias_maps = hash:/etc/aliases
|
|
||||||
#alias_maps = hash:/etc/aliases, nis:mail.aliases
|
|
||||||
#alias_maps = netinfo:/aliases
|
|
||||||
alias_maps = hash:/etc/postfix/aliases
|
|
||||||
|
|
||||||
# The alias_database parameter specifies the alias database(s) that
|
|
||||||
# are built with "newaliases" or "sendmail -bi". This is a separate
|
|
||||||
# configuration parameter, because alias_maps (see above) may specify
|
|
||||||
# tables that are not necessarily all under control by Postfix.
|
|
||||||
#
|
|
||||||
#alias_database = dbm:/etc/aliases
|
|
||||||
#alias_database = dbm:/etc/mail/aliases
|
|
||||||
#alias_database = hash:/etc/aliases
|
|
||||||
#alias_database = hash:/etc/aliases, hash:/opt/majordomo/aliases
|
|
||||||
alias_database = $alias_maps
|
|
||||||
|
|
||||||
# ADDRESS EXTENSIONS (e.g., user+foo)
|
|
||||||
#
|
|
||||||
# The recipient_delimiter parameter specifies the separator between
|
|
||||||
# user names and address extensions (user+foo). See canonical(5),
|
|
||||||
# local(8), relocated(5) and virtual(5) for the effects this has on
|
|
||||||
# aliases, canonical, virtual, relocated and .forward file lookups.
|
|
||||||
# Basically, the software tries user+foo and .forward+foo before
|
|
||||||
# trying user and .forward.
|
|
||||||
#
|
|
||||||
#recipient_delimiter = +
|
|
||||||
|
|
||||||
# DELIVERY TO MAILBOX
|
|
||||||
#
|
|
||||||
# The home_mailbox parameter specifies the optional pathname of a
|
|
||||||
# mailbox file relative to a user's home directory. The default
|
|
||||||
# mailbox file is /var/spool/mail/user or /var/mail/user. Specify
|
|
||||||
# "Maildir/" for qmail-style delivery (the / is required).
|
|
||||||
#
|
|
||||||
#home_mailbox = Mailbox
|
|
||||||
# home_mailbox = Maildir/
|
|
||||||
|
|
||||||
# The mail_spool_directory parameter specifies the directory where
|
|
||||||
# UNIX-style mailboxes are kept. The default setting depends on the
|
|
||||||
# system type.
|
|
||||||
#
|
|
||||||
#mail_spool_directory = /var/mail
|
|
||||||
#mail_spool_directory = /var/spool/mail
|
|
||||||
|
|
||||||
# The mailbox_command parameter specifies the optional external
|
|
||||||
# command to use instead of mailbox delivery. The command is run as
|
|
||||||
# the recipient with proper HOME, SHELL and LOGNAME environment settings.
|
|
||||||
# Exception: delivery for root is done as $default_user.
|
|
||||||
#
|
|
||||||
# Other environment variables of interest: USER (recipient username),
|
|
||||||
# EXTENSION (address extension), DOMAIN (domain part of address),
|
|
||||||
# and LOCAL (the address localpart).
|
|
||||||
#
|
|
||||||
# Unlike other Postfix configuration parameters, the mailbox_command
|
|
||||||
# parameter is not subjected to $parameter substitutions. This is to
|
|
||||||
# make it easier to specify shell syntax (see example below).
|
|
||||||
#
|
|
||||||
# Avoid shell meta characters because they will force Postfix to run
|
|
||||||
# an expensive shell process. Procmail alone is expensive enough.
|
|
||||||
#
|
|
||||||
# IF YOU USE THIS TO DELIVER MAIL SYSTEM-WIDE, YOU MUST SET UP AN
|
|
||||||
# ALIAS THAT FORWARDS MAIL FOR ROOT TO A REAL USER.
|
|
||||||
#
|
|
||||||
#mailbox_command = /some/where/procmail
|
|
||||||
#mailbox_command = /some/where/procmail -a "$EXTENSION"
|
|
||||||
|
|
||||||
# The mailbox_transport specifies the optional transport in master.cf
|
|
||||||
# to use after processing aliases and .forward files. This parameter
|
|
||||||
# has precedence over the mailbox_command, fallback_transport and
|
|
||||||
# luser_relay parameters.
|
|
||||||
#
|
|
||||||
# Specify a string of the form transport:nexthop, where transport is
|
|
||||||
# the name of a mail delivery transport defined in master.cf. The
|
|
||||||
# :nexthop part is optional. For more details see the sample transport
|
|
||||||
# configuration file.
|
|
||||||
#
|
|
||||||
# NOTE: if you use this feature for accounts not in the UNIX password
|
|
||||||
# file, then you must update the "local_recipient_maps" setting in
|
|
||||||
# the main.cf file, otherwise the SMTP server will reject mail for
|
|
||||||
# non-UNIX accounts with "User unknown in local recipient table".
|
|
||||||
#
|
|
||||||
# Cyrus IMAP over LMTP. Specify ``lmtpunix cmd="lmtpd"
|
|
||||||
# listen="/var/imap/socket/lmtp" prefork=0'' in cyrus.conf.
|
|
||||||
#mailbox_transport = lmtp:unix:/var/imap/socket/lmtp
|
|
||||||
#
|
|
||||||
# Cyrus IMAP via command line. Uncomment the "cyrus...pipe" and
|
|
||||||
# subsequent line in master.cf.
|
|
||||||
#mailbox_transport = cyrus
|
|
||||||
|
|
||||||
# The fallback_transport specifies the optional transport in master.cf
|
|
||||||
# to use for recipients that are not found in the UNIX passwd database.
|
|
||||||
# This parameter has precedence over the luser_relay parameter.
|
|
||||||
#
|
|
||||||
# Specify a string of the form transport:nexthop, where transport is
|
|
||||||
# the name of a mail delivery transport defined in master.cf. The
|
|
||||||
# :nexthop part is optional. For more details see the sample transport
|
|
||||||
# configuration file.
|
|
||||||
#
|
|
||||||
# NOTE: if you use this feature for accounts not in the UNIX password
|
|
||||||
# file, then you must update the "local_recipient_maps" setting in
|
|
||||||
# the main.cf file, otherwise the SMTP server will reject mail for
|
|
||||||
# non-UNIX accounts with "User unknown in local recipient table".
|
|
||||||
#
|
|
||||||
#fallback_transport = lmtp:unix:/file/name
|
|
||||||
#fallback_transport = cyrus
|
|
||||||
#fallback_transport =
|
|
||||||
|
|
||||||
# The luser_relay parameter specifies an optional destination address
|
|
||||||
# for unknown recipients. By default, mail for unknown@$mydestination,
|
|
||||||
# unknown@[$inet_interfaces] or unknown@[$proxy_interfaces] is returned
|
|
||||||
# as undeliverable.
|
|
||||||
#
|
|
||||||
# The following expansions are done on luser_relay: $user (recipient
|
|
||||||
# username), $shell (recipient shell), $home (recipient home directory),
|
|
||||||
# $recipient (full recipient address), $extension (recipient address
|
|
||||||
# extension), $domain (recipient domain), $local (entire recipient
|
|
||||||
# localpart), $recipient_delimiter. Specify ${name?value} or
|
|
||||||
# ${name:value} to expand value only when $name does (does not) exist.
|
|
||||||
#
|
|
||||||
# luser_relay works only for the default Postfix local delivery agent.
|
|
||||||
#
|
|
||||||
# NOTE: if you use this feature for accounts not in the UNIX password
|
|
||||||
# file, then you must specify "local_recipient_maps =" (i.e. empty) in
|
|
||||||
# the main.cf file, otherwise the SMTP server will reject mail for
|
|
||||||
# non-UNIX accounts with "User unknown in local recipient table".
|
|
||||||
#
|
|
||||||
#luser_relay = $user@other.host
|
|
||||||
#luser_relay = $local@other.host
|
|
||||||
#luser_relay = admin+$local
|
|
||||||
|
|
||||||
# JUNK MAIL CONTROLS
|
|
||||||
#
|
|
||||||
# The controls listed here are only a very small subset. The file
|
|
||||||
# SMTPD_ACCESS_README provides an overview.
|
|
||||||
|
|
||||||
# The header_checks parameter specifies an optional table with patterns
|
|
||||||
# that each logical message header is matched against, including
|
|
||||||
# headers that span multiple physical lines.
|
|
||||||
#
|
|
||||||
# By default, these patterns also apply to MIME headers and to the
|
|
||||||
# headers of attached messages. With older Postfix versions, MIME and
|
|
||||||
# attached message headers were treated as body text.
|
|
||||||
#
|
|
||||||
# For details, see "man header_checks".
|
|
||||||
#
|
|
||||||
#header_checks = regexp:/etc/postfix/header_checks
|
|
||||||
|
|
||||||
# FAST ETRN SERVICE
|
|
||||||
#
|
|
||||||
# Postfix maintains per-destination logfiles with information about
|
|
||||||
# deferred mail, so that mail can be flushed quickly with the SMTP
|
|
||||||
# "ETRN domain.tld" command, or by executing "sendmail -qRdomain.tld".
|
|
||||||
# See the ETRN_README document for a detailed description.
|
|
||||||
#
|
|
||||||
# The fast_flush_domains parameter controls what destinations are
|
|
||||||
# eligible for this service. By default, they are all domains that
|
|
||||||
# this server is willing to relay mail to.
|
|
||||||
#
|
|
||||||
#fast_flush_domains = $relay_domains
|
|
||||||
|
|
||||||
# SHOW SOFTWARE VERSION OR NOT
|
|
||||||
#
|
|
||||||
# The smtpd_banner parameter specifies the text that follows the 220
|
|
||||||
# code in the SMTP server's greeting banner. Some people like to see
|
|
||||||
# the mail version advertised. By default, Postfix shows no version.
|
|
||||||
#
|
|
||||||
# You MUST specify $myhostname at the start of the text. That is an
|
|
||||||
# RFC requirement. Postfix itself does not care.
|
|
||||||
#
|
|
||||||
#smtpd_banner = $myhostname ESMTP $mail_name
|
|
||||||
#smtpd_banner = $myhostname ESMTP $mail_name ($mail_version)
|
|
||||||
|
|
||||||
# PARALLEL DELIVERY TO THE SAME DESTINATION
|
|
||||||
#
|
|
||||||
# How many parallel deliveries to the same user or domain? With local
|
|
||||||
# delivery, it does not make sense to do massively parallel delivery
|
|
||||||
# to the same user, because mailbox updates must happen sequentially,
|
|
||||||
# and expensive pipelines in .forward files can cause disasters when
|
|
||||||
# too many are run at the same time. With SMTP deliveries, 10
|
|
||||||
# simultaneous connections to the same domain could be sufficient to
|
|
||||||
# raise eyebrows.
|
|
||||||
#
|
|
||||||
# Each message delivery transport has its XXX_destination_concurrency_limit
|
|
||||||
# parameter. The default is $default_destination_concurrency_limit for
|
|
||||||
# most delivery transports. For the local delivery agent the default is 2.
|
|
||||||
|
|
||||||
#local_destination_concurrency_limit = 2
|
|
||||||
#default_destination_concurrency_limit = 20
|
|
||||||
|
|
||||||
# DEBUGGING CONTROL
|
|
||||||
#
|
|
||||||
# The debug_peer_level parameter specifies the increment in verbose
|
|
||||||
# logging level when an SMTP client or server host name or address
|
|
||||||
# matches a pattern in the debug_peer_list parameter.
|
|
||||||
#
|
|
||||||
debug_peer_level = 2
|
|
||||||
|
|
||||||
# The debug_peer_list parameter specifies an optional list of domain
|
|
||||||
# or network patterns, /file/name patterns or type:name tables. When
|
|
||||||
# an SMTP client or server host name or address matches a pattern,
|
|
||||||
# increase the verbose logging level by the amount specified in the
|
|
||||||
# debug_peer_level parameter.
|
|
||||||
#
|
|
||||||
#debug_peer_list = 127.0.0.1
|
|
||||||
#debug_peer_list = some.domain
|
|
||||||
|
|
||||||
# The debugger_command specifies the external command that is executed
|
|
||||||
# when a Postfix daemon program is run with the -D option.
|
|
||||||
#
|
|
||||||
# Use "command .. & sleep 5" so that the debugger can attach before
|
|
||||||
# the process marches on. If you use an X-based debugger, be sure to
|
|
||||||
# set up your XAUTHORITY environment variable before starting Postfix.
|
|
||||||
#
|
|
||||||
debugger_command =
|
|
||||||
PATH=/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin
|
|
||||||
ddd $daemon_directory/$process_name $process_id & sleep 5
|
|
||||||
|
|
||||||
# If you can't use X, use this to capture the call stack when a
|
|
||||||
# daemon crashes. The result is in a file in the configuration
|
|
||||||
# directory, and is named after the process name and the process ID.
|
|
||||||
#
|
|
||||||
# debugger_command =
|
|
||||||
# PATH=/bin:/usr/bin:/usr/local/bin; export PATH; (echo cont;
|
|
||||||
# echo where) | gdb $daemon_directory/$process_name $process_id 2>&1
|
|
||||||
# >$config_directory/$process_name.$process_id.log & sleep 5
|
|
||||||
#
|
|
||||||
# Another possibility is to run gdb under a detached screen session.
|
|
||||||
# To attach to the screen sesssion, su root and run "screen -r
|
|
||||||
# <id_string>" where <id_string> uniquely matches one of the detached
|
|
||||||
# sessions (from "screen -list").
|
|
||||||
#
|
|
||||||
# debugger_command =
|
|
||||||
# PATH=/bin:/usr/bin:/sbin:/usr/sbin; export PATH; screen
|
|
||||||
# -dmS $process_name gdb $daemon_directory/$process_name
|
|
||||||
# $process_id & sleep 1
|
|
||||||
|
|
||||||
# INSTALL-TIME CONFIGURATION INFORMATION
|
|
||||||
#
|
|
||||||
# The following parameters are used when installing a new Postfix version.
|
|
||||||
#
|
|
||||||
# sendmail_path: The full pathname of the Postfix sendmail command.
|
|
||||||
# This is the Sendmail-compatible mail posting interface.
|
|
||||||
#
|
|
||||||
sendmail_path = /usr/bin/sendmail
|
|
||||||
|
|
||||||
# newaliases_path: The full pathname of the Postfix newaliases command.
|
|
||||||
# This is the Sendmail-compatible command to build alias databases.
|
|
||||||
#
|
|
||||||
newaliases_path = /usr/bin/newaliases
|
|
||||||
|
|
||||||
# mailq_path: The full pathname of the Postfix mailq command. This
|
|
||||||
# is the Sendmail-compatible mail queue listing command.
|
|
||||||
#
|
|
||||||
mailq_path = /usr/bin/mailq
|
|
||||||
|
|
||||||
# setgid_group: The group for mail submission and queue management
|
|
||||||
# commands. This must be a group name with a numerical group ID that
|
|
||||||
# is not shared with other accounts, not even with the Postfix account.
|
|
||||||
#
|
|
||||||
setgid_group = postdrop
|
|
||||||
|
|
||||||
# html_directory: The location of the Postfix HTML documentation.
|
|
||||||
#
|
|
||||||
html_directory = no
|
|
||||||
|
|
||||||
# manpage_directory: The location of the Postfix on-line manual pages.
|
|
||||||
#
|
|
||||||
manpage_directory = /usr/share/man
|
|
||||||
|
|
||||||
# sample_directory: The location of the Postfix sample configuration files.
|
|
||||||
# This parameter is obsolete as of Postfix 2.1.
|
|
||||||
#
|
|
||||||
sample_directory = /etc/postfix/sample
|
|
||||||
|
|
||||||
# readme_directory: The location of the Postfix README files.
|
|
||||||
#
|
|
||||||
readme_directory = /usr/share/doc/postfix
|
|
||||||
#inet_protocols = ipv4
|
|
||||||
|
|
||||||
# librevpn: These options allow postfix to solve .local addresses
|
|
||||||
smtp_host_lookup = native
|
|
||||||
ignore_mx_lookup_error = yes
|
|
||||||
# this is deprecated in 2.11+
|
|
||||||
disable_dns_lookups = yes
|
|
||||||
# this is only available on 2.11+
|
|
||||||
smtp_dns_support_level = enabled
|
|
||||||
|
|
||||||
transport_maps = hash:/etc/postfix/transport
|
|
@ -1,302 +0,0 @@
|
|||||||
# TRANSPORT(5) TRANSPORT(5)
|
|
||||||
#
|
|
||||||
# NAME
|
|
||||||
# transport - Postfix transport table format
|
|
||||||
#
|
|
||||||
# SYNOPSIS
|
|
||||||
# postmap /etc/postfix/transport
|
|
||||||
#
|
|
||||||
# postmap -q "string" /etc/postfix/transport
|
|
||||||
#
|
|
||||||
# postmap -q - /etc/postfix/transport <inputfile
|
|
||||||
#
|
|
||||||
# DESCRIPTION
|
|
||||||
# The optional transport(5) table specifies a mapping from
|
|
||||||
# email addresses to message delivery transports and next-
|
|
||||||
# hop destinations. Message delivery transports such as
|
|
||||||
# local or smtp are defined in the master.cf file, and next-
|
|
||||||
# hop destinations are typically hosts or domain names. The
|
|
||||||
# table is searched by the trivial-rewrite(8) daemon.
|
|
||||||
#
|
|
||||||
# This mapping overrides the default transport:nexthop
|
|
||||||
# selection that is built into Postfix:
|
|
||||||
#
|
|
||||||
# local_transport (default: local:$myhostname)
|
|
||||||
# This is the default for final delivery to domains
|
|
||||||
# listed with mydestination, and for [ipaddress] des-
|
|
||||||
# tinations that match $inet_interfaces or
|
|
||||||
# $proxy_interfaces. The default nexthop destination
|
|
||||||
# is the MTA hostname.
|
|
||||||
#
|
|
||||||
# virtual_transport (default: virtual:)
|
|
||||||
# This is the default for final delivery to domains
|
|
||||||
# listed with virtual_mailbox_domains. The default
|
|
||||||
# nexthop destination is the recipient domain.
|
|
||||||
#
|
|
||||||
# relay_transport (default: relay:)
|
|
||||||
# This is the default for remote delivery to domains
|
|
||||||
# listed with relay_domains. In order of decreasing
|
|
||||||
# precedence, the nexthop destination is taken from
|
|
||||||
# relay_transport, sender_dependent_relayhost_maps,
|
|
||||||
# relayhost, or from the recipient domain.
|
|
||||||
#
|
|
||||||
# default_transport (default: smtp:)
|
|
||||||
# This is the default for remote delivery to other
|
|
||||||
# destinations. In order of decreasing precedence,
|
|
||||||
# the nexthop destination is taken from sender_depen-
|
|
||||||
# dent_default_transport_maps, default_transport,
|
|
||||||
# sender_dependent_relayhost_maps, relayhost, or from
|
|
||||||
# the recipient domain.
|
|
||||||
#
|
|
||||||
# Normally, the transport(5) table is specified as a text
|
|
||||||
# file that serves as input to the postmap(1) command. The
|
|
||||||
# result, an indexed file in dbm or db format, is used for
|
|
||||||
# fast searching by the mail system. Execute the command
|
|
||||||
# "postmap /etc/postfix/transport" to rebuild an indexed
|
|
||||||
# file after changing the corresponding transport table.
|
|
||||||
#
|
|
||||||
# When the table is provided via other means such as NIS,
|
|
||||||
# LDAP or SQL, the same lookups are done as for ordinary
|
|
||||||
# indexed files.
|
|
||||||
#
|
|
||||||
# Alternatively, the table can be provided as a regular-
|
|
||||||
# expression map where patterns are given as regular expres-
|
|
||||||
# sions, or lookups can be directed to TCP-based server. In
|
|
||||||
# those case, the lookups are done in a slightly different
|
|
||||||
# way as described below under "REGULAR EXPRESSION TABLES"
|
|
||||||
# or "TCP-BASED TABLES".
|
|
||||||
#
|
|
||||||
# CASE FOLDING
|
|
||||||
# The search string is folded to lowercase before database
|
|
||||||
# lookup. As of Postfix 2.3, the search string is not case
|
|
||||||
# folded with database types such as regexp: or pcre: whose
|
|
||||||
# lookup fields can match both upper and lower case.
|
|
||||||
#
|
|
||||||
# TABLE FORMAT
|
|
||||||
# The input format for the postmap(1) command is as follows:
|
|
||||||
#
|
|
||||||
# pattern result
|
|
||||||
# When pattern matches the recipient address or
|
|
||||||
# domain, use the corresponding result.
|
|
||||||
#
|
|
||||||
# blank lines and comments
|
|
||||||
# Empty lines and whitespace-only lines are ignored,
|
|
||||||
# as are lines whose first non-whitespace character
|
|
||||||
# is a `#'.
|
|
||||||
#
|
|
||||||
# multi-line text
|
|
||||||
# A logical line starts with non-whitespace text. A
|
|
||||||
# line that starts with whitespace continues a logi-
|
|
||||||
# cal line.
|
|
||||||
#
|
|
||||||
# The pattern specifies an email address, a domain name, or
|
|
||||||
# a domain name hierarchy, as described in section "TABLE
|
|
||||||
# LOOKUP".
|
|
||||||
#
|
|
||||||
# The result is of the form transport:nexthop and specifies
|
|
||||||
# how or where to deliver mail. This is described in section
|
|
||||||
# "RESULT FORMAT".
|
|
||||||
#
|
|
||||||
# TABLE SEARCH ORDER
|
|
||||||
# With lookups from indexed files such as DB or DBM, or from
|
|
||||||
# networked tables such as NIS, LDAP or SQL, patterns are
|
|
||||||
# tried in the order as listed below:
|
|
||||||
#
|
|
||||||
# user+extension@domain transport:nexthop
|
|
||||||
# Deliver mail for user+extension@domain through
|
|
||||||
# transport to nexthop.
|
|
||||||
#
|
|
||||||
# user@domain transport:nexthop
|
|
||||||
# Deliver mail for user@domain through transport to
|
|
||||||
# nexthop.
|
|
||||||
#
|
|
||||||
# domain transport:nexthop
|
|
||||||
# Deliver mail for domain through transport to nex-
|
|
||||||
# thop.
|
|
||||||
#
|
|
||||||
# .domain transport:nexthop
|
|
||||||
# Deliver mail for any subdomain of domain through
|
|
||||||
# transport to nexthop. This applies only when the
|
|
||||||
# string transport_maps is not listed in the par-
|
|
||||||
# ent_domain_matches_subdomains configuration set-
|
|
||||||
# ting. Otherwise, a domain name matches itself and
|
|
||||||
# its subdomains.
|
|
||||||
#
|
|
||||||
# * transport:nexthop
|
|
||||||
# The special pattern * represents any address (i.e.
|
|
||||||
# it functions as the wild-card pattern, and is
|
|
||||||
# unique to Postfix transport tables).
|
|
||||||
#
|
|
||||||
# Note 1: the null recipient address is looked up as
|
|
||||||
# $empty_address_recipient@$myhostname (default: mailer-dae-
|
|
||||||
# mon@hostname).
|
|
||||||
#
|
|
||||||
# Note 2: user@domain or user+extension@domain lookup is
|
|
||||||
# available in Postfix 2.0 and later.
|
|
||||||
#
|
|
||||||
# RESULT FORMAT
|
|
||||||
# The lookup result is of the form transport:nexthop. The
|
|
||||||
# transport field specifies a mail delivery transport such
|
|
||||||
# as smtp or local. The nexthop field specifies where and
|
|
||||||
# how to deliver mail.
|
|
||||||
#
|
|
||||||
# The transport field specifies the name of a mail delivery
|
|
||||||
# transport (the first name of a mail delivery service entry
|
|
||||||
# in the Postfix master.cf file).
|
|
||||||
#
|
|
||||||
# The interpretation of the nexthop field is transport
|
|
||||||
# dependent. In the case of SMTP, specify a service on a
|
|
||||||
# non-default port as host:service, and disable MX (mail
|
|
||||||
# exchanger) DNS lookups with [host] or [host]:port. The []
|
|
||||||
# form is required when you specify an IP address instead of
|
|
||||||
# a hostname.
|
|
||||||
#
|
|
||||||
# A null transport and null nexthop result means "do not
|
|
||||||
# change": use the delivery transport and nexthop informa-
|
|
||||||
# tion that would be used when the entire transport table
|
|
||||||
# did not exist.
|
|
||||||
#
|
|
||||||
# A non-null transport field with a null nexthop field
|
|
||||||
# resets the nexthop information to the recipient domain.
|
|
||||||
#
|
|
||||||
# A null transport field with non-null nexthop field does
|
|
||||||
# not modify the transport information.
|
|
||||||
#
|
|
||||||
# EXAMPLES
|
|
||||||
# In order to deliver internal mail directly, while using a
|
|
||||||
# mail relay for all other mail, specify a null entry for
|
|
||||||
# internal destinations (do not change the delivery trans-
|
|
||||||
# port or the nexthop information) and specify a wildcard
|
|
||||||
# for all other destinations.
|
|
||||||
#
|
|
||||||
# my.domain :
|
|
||||||
# .my.domain :
|
|
||||||
# * smtp:outbound-relay.my.domain
|
|
||||||
#
|
|
||||||
# In order to send mail for example.com and its subdomains
|
|
||||||
# via the uucp transport to the UUCP host named example:
|
|
||||||
#
|
|
||||||
# example.com uucp:example
|
|
||||||
# .example.com uucp:example
|
|
||||||
#
|
|
||||||
# When no nexthop host name is specified, the destination
|
|
||||||
# domain name is used instead. For example, the following
|
|
||||||
# directs mail for user@example.com via the slow transport
|
|
||||||
# to a mail exchanger for example.com. The slow transport
|
|
||||||
# could be configured to run at most one delivery process at
|
|
||||||
# a time:
|
|
||||||
#
|
|
||||||
# example.com slow:
|
|
||||||
#
|
|
||||||
# When no transport is specified, Postfix uses the transport
|
|
||||||
# that matches the address domain class (see DESCRIPTION
|
|
||||||
# above). The following sends all mail for example.com and
|
|
||||||
# its subdomains to host gateway.example.com:
|
|
||||||
#
|
|
||||||
# example.com :[gateway.example.com]
|
|
||||||
# .example.com :[gateway.example.com]
|
|
||||||
#
|
|
||||||
# In the above example, the [] suppress MX lookups. This
|
|
||||||
# prevents mail routing loops when your machine is primary
|
|
||||||
# MX host for example.com.
|
|
||||||
#
|
|
||||||
# In the case of delivery via SMTP, one may specify host-
|
|
||||||
# name:service instead of just a host:
|
|
||||||
#
|
|
||||||
# example.com smtp:bar.example:2025
|
|
||||||
#
|
|
||||||
# This directs mail for user@example.com to host bar.example
|
|
||||||
# port 2025. Instead of a numerical port a symbolic name may
|
|
||||||
# be used. Specify [] around the hostname if MX lookups must
|
|
||||||
# be disabled.
|
|
||||||
#
|
|
||||||
# The error mailer can be used to bounce mail:
|
|
||||||
#
|
|
||||||
# .example.com error:mail for *.example.com is not deliverable
|
|
||||||
#
|
|
||||||
# This causes all mail for user@anything.example.com to be
|
|
||||||
# bounced.
|
|
||||||
#
|
|
||||||
# REGULAR EXPRESSION TABLES
|
|
||||||
# This section describes how the table lookups change when
|
|
||||||
# the table is given in the form of regular expressions. For
|
|
||||||
# a description of regular expression lookup table syntax,
|
|
||||||
# see regexp_table(5) or pcre_table(5).
|
|
||||||
#
|
|
||||||
# Each pattern is a regular expression that is applied to
|
|
||||||
# the entire address being looked up. Thus,
|
|
||||||
# some.domain.hierarchy is not looked up via its parent
|
|
||||||
# domains, nor is user+foo@domain looked up as user@domain.
|
|
||||||
#
|
|
||||||
# Patterns are applied in the order as specified in the ta-
|
|
||||||
# ble, until a pattern is found that matches the search
|
|
||||||
# string.
|
|
||||||
#
|
|
||||||
# The trivial-rewrite(8) server disallows regular expression
|
|
||||||
# substitution of $1 etc. in regular expression lookup
|
|
||||||
# tables, because that could open a security hole (Postfix
|
|
||||||
# version 2.3 and later).
|
|
||||||
#
|
|
||||||
# TCP-BASED TABLES
|
|
||||||
# This section describes how the table lookups change when
|
|
||||||
# lookups are directed to a TCP-based server. For a descrip-
|
|
||||||
# tion of the TCP client/server lookup protocol, see tcp_ta-
|
|
||||||
# ble(5). This feature is not available up to and including
|
|
||||||
# Postfix version 2.4.
|
|
||||||
#
|
|
||||||
# Each lookup operation uses the entire recipient address
|
|
||||||
# once. Thus, some.domain.hierarchy is not looked up via
|
|
||||||
# its parent domains, nor is user+foo@domain looked up as
|
|
||||||
# user@domain.
|
|
||||||
#
|
|
||||||
# Results are the same as with indexed file lookups.
|
|
||||||
#
|
|
||||||
# CONFIGURATION PARAMETERS
|
|
||||||
# The following main.cf parameters are especially relevant.
|
|
||||||
# The text below provides only a parameter summary. See
|
|
||||||
# postconf(5) for more details including examples.
|
|
||||||
#
|
|
||||||
# empty_address_recipient
|
|
||||||
# The address that is looked up instead of the null
|
|
||||||
# sender address.
|
|
||||||
#
|
|
||||||
# parent_domain_matches_subdomains
|
|
||||||
# List of Postfix features that use domain.tld pat-
|
|
||||||
# terns to match sub.domain.tld (as opposed to
|
|
||||||
# requiring .domain.tld patterns).
|
|
||||||
#
|
|
||||||
# transport_maps
|
|
||||||
# List of transport lookup tables.
|
|
||||||
#
|
|
||||||
# SEE ALSO
|
|
||||||
# trivial-rewrite(8), rewrite and resolve addresses
|
|
||||||
# master(5), master.cf file format
|
|
||||||
# postconf(5), configuration parameters
|
|
||||||
# postmap(1), Postfix lookup table manager
|
|
||||||
#
|
|
||||||
# README FILES
|
|
||||||
# Use "postconf readme_directory" or "postconf html_direc-
|
|
||||||
# tory" to locate this information.
|
|
||||||
# ADDRESS_REWRITING_README, address rewriting guide
|
|
||||||
# DATABASE_README, Postfix lookup table overview
|
|
||||||
# FILTER_README, external content filter
|
|
||||||
#
|
|
||||||
# LICENSE
|
|
||||||
# The Secure Mailer license must be distributed with this
|
|
||||||
# software.
|
|
||||||
#
|
|
||||||
# AUTHOR(S)
|
|
||||||
# Wietse Venema
|
|
||||||
# IBM T.J. Watson Research
|
|
||||||
# P.O. Box 704
|
|
||||||
# Yorktown Heights, NY 10598, USA
|
|
||||||
#
|
|
||||||
# TRANSPORT(5)
|
|
||||||
|
|
||||||
# if we don't set local transport for email delivered to our node we'll
|
|
||||||
# catch a "loops back to myself" error
|
|
||||||
{{node}}.local local:
|
|
||||||
# send email to other nodes through our server
|
|
||||||
.local smtp:
|
|
||||||
# everything else is relayed through naven to the internet
|
|
||||||
* smtp:[naven.local]:25
|
|
@ -1,234 +0,0 @@
|
|||||||
.TH "CONVENCIONES" "2" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Notas para desarrolladores de lvpn :)
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.TP
|
|
||||||
.B lib/
|
|
||||||
comandos
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B lib/skel/
|
|
||||||
archivos base para tinc
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B doc/
|
|
||||||
documentación
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B bin/
|
|
||||||
programas de ayuda que no son especificamente de lvpn
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B etc/
|
|
||||||
código fuente extra
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B hosts/
|
|
||||||
archivos de nodos
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B nodos/
|
|
||||||
nodos propios
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B locale/
|
|
||||||
traducciones
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.SS Dónde van los scripts
|
|
||||||
.PP
|
|
||||||
El script \f[I]lvpn\f[] autodescubre los comandos siguiendo la
|
|
||||||
convención \f[I]lib/lvpn\-tuscript\f[].
|
|
||||||
Además setea algunas variables de entorno que los scripts pueden usar
|
|
||||||
para saber en qué red están trabajando.
|
|
||||||
.PP
|
|
||||||
Los scripts pueden estar en cualquier lenguaje de programación mientras
|
|
||||||
sepan leer esas variables de entorno.
|
|
||||||
.SS Variables de entorno
|
|
||||||
.PP
|
|
||||||
Estas son las variables de entorno que \f[I]lvpn\f[] exporta para el
|
|
||||||
resto de los comandos.
|
|
||||||
.TP
|
|
||||||
.B TINC
|
|
||||||
Ubicación del directorio del nodo, por defecto \f[I]/etc/tinc/lvpn\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B NETWORK
|
|
||||||
Nombre de la red, por defecto el último directorio de \f[I]TINC\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN
|
|
||||||
Path completo de \f[I]lvpn\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_DIR
|
|
||||||
Path completo del directorio de trabajo, por defecto el directorio base
|
|
||||||
de \f[I]LVPN\f[]
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_LIBDIR
|
|
||||||
Path completo del directorio de comandos.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_HOSTS
|
|
||||||
Path completo del directorio de hosts.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_BEADLE
|
|
||||||
Path completo del directorio de llaves anunciables nuevas de
|
|
||||||
desconocidos.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B KEYSIZE
|
|
||||||
Tamaño por defecto de las llaves.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_SUBNET
|
|
||||||
El rango de IPv4
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_SUBNET6
|
|
||||||
El rango de IPv6
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B TINCD_FLAGS
|
|
||||||
Flags para el demonio \f[I]tincd\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B PORT
|
|
||||||
Puerto por defecto
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B sudo
|
|
||||||
Usar esta variable delante de cualquier comando que deba correr con
|
|
||||||
privilegios de root, ej: \f[I]${sudo} rsync\f[].
|
|
||||||
Requiere \f[I]"root=true"\f[] al principio del script.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SS Dónde va la documentación
|
|
||||||
.PP
|
|
||||||
La documentación lleva el nombre completo del script:
|
|
||||||
\f[I]doc/idioma/lvpn\-tuscript.markdown\f[].
|
|
||||||
La función \f[I]help()\f[] en \f[I]lib/msg\f[] lo lleva como argumento
|
|
||||||
para mostrar la ayuda.
|
|
||||||
.PP
|
|
||||||
Además, toma la variable de entorno \f[I]PAGER\f[] para paginar la
|
|
||||||
salida, por defecto se usa \f[I]less\f[].
|
|
||||||
.SS Flags y parámetros
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn comando\f[] \-flags nodolocal parametros extra
|
|
||||||
.PP
|
|
||||||
Seguido de \f[I]lvpn\f[] viene el comando, al que se le pasan en orden
|
|
||||||
las flags (con sus opciones).
|
|
||||||
El primer parámetro siempre tiene que ser el nodo local en el que se
|
|
||||||
realiza la acción.
|
|
||||||
Luego vienen los parámetros extra (nombres de otros nodos, por ejemplo).
|
|
||||||
.SS Funciones comunes
|
|
||||||
.PP
|
|
||||||
En el archivo \f[I]lib/common\f[] se almacenan las funciones de uso
|
|
||||||
común entre todos los comandos.
|
|
||||||
Se la puede incluir en un script añadiendo la línea
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
\&.\ "${LVPN_LIBDIR}"/common
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
al principio del script.
|
|
||||||
.PP
|
|
||||||
Nota: Agregar \f[I]root=true\f[] antes de common para poder correr
|
|
||||||
funciones de root.
|
|
||||||
.SS Variables
|
|
||||||
.IP \[bu] 2
|
|
||||||
self: nombre del script.
|
|
||||||
Usado para obtener el nombre del script.
|
|
||||||
Ejemplo: \f[I]help $self\f[] llama a la ayuda del script actual.
|
|
||||||
.SS Funciones
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]add\f[]to_file()\f[I]: Agrega una línea al final de un archivo.
|
|
||||||
Uso: \f[]add_to_file archivo "Texto a agregar"_
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]requires()\f[]: Indica que el script necesita que un programa se
|
|
||||||
encuentre en el PATH.
|
|
||||||
Se recomienda cuando el script llama a un programa que puede no
|
|
||||||
encontrarse en una instalación estándar.
|
|
||||||
Uso: \f[I]requires avahi\-publish rsync\f[]
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_node_dir()\f[]: Encuentra el directorio de un nodo pasándole el
|
|
||||||
nombre del nodo como argumento.
|
|
||||||
\f[I]node\f[]dir="(\f[I]g\f[]\f[I]e\f[]\f[I]t\f[]~\f[I]n\f[]~\f[I]o\f[]\f[I]d\f[]\f[I]e\f[]~\f[I]d\f[]~\f[I]i\f[]\f[I]r\f[]{node})"_
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_node_file()\f[]: Encuentra el archivo de host de un nodo dentro
|
|
||||||
del directorio del nodo.
|
|
||||||
\f[I]node\f[]file="(\f[I]g\f[]\f[I]e\f[]\f[I]t\f[]~\f[I]n\f[]~\f[I]o\f[]\f[I]d\f[]\f[I]e\f[]~\f[I]f\f[]~\f[I]i\f[]\f[I]l\f[]\f[I]e\f[]{node})"_
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_node_name()\f[]: Limpia el nombre del nodo de caracteres
|
|
||||||
inválidos
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_host_file()\f[]: Obtiene el archivo del nodo en $LVPN_HOSTS
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]find_init_system()\f[]: Encuentra el tipo de inicio de tinc.
|
|
||||||
Ver \f[I]lib/lvpn\-install\f[].
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_id()\f[]: Obtiene nombre y mail del responsable del nodo usando
|
|
||||||
git o usuario\@hostname.
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_ipv4()\f[]: Genera una dirección IPv4 a partir de LVPN_SUBNET.
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_ipv6()\f[]: Genera una dirección IPv6 a partir de LVPN_SUBNET6.
|
|
||||||
.SS Mensajes
|
|
||||||
.PP
|
|
||||||
En \f[I]lib/msg\f[] se encuentran las funciones básicas para imprimir
|
|
||||||
mensajes en la salida de errores estándar.
|
|
||||||
Esto es para que no sean procesados como la salida estándar de los
|
|
||||||
scripts, que se reservan para poder enviar la información a una tubería.
|
|
||||||
.PP
|
|
||||||
No es necesario incluirla ya que se llama desde \f[I]lib/common\f[].
|
|
||||||
.PP
|
|
||||||
Todas las funciones tienen soporte para traducciones utilizando gettext,
|
|
||||||
por lo que los mensajes que se completan con variables deben seguir el
|
|
||||||
formato de \f[I]printf\f[]: \f[I]%s\f[] para reemplazar por cadenas,
|
|
||||||
\f[I]%d\f[] para números enteros, etc.
|
|
||||||
.PP
|
|
||||||
Por ejemplo: \f[I]msg "Procesando el nodo %s..." "$node"\f[]
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]msg()\f[]: Información
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]error()\f[]: Mensaje de error
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]warning()\f[]: Alerta
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]fatal_error()\f[]: Imprime un mensaje de error y termina el
|
|
||||||
programa inmediatamente
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]tip()\f[]: Recomendaciones, por ejemplo, cual comando correr a
|
|
||||||
continuación.
|
|
||||||
.SS Los comandos
|
|
||||||
.PP
|
|
||||||
La mayoria de los comandos solo configuran, luego hay que enviar los
|
|
||||||
cambios a directorio de instalación con el comando \f[I]lvpn init
|
|
||||||
install\f[].
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,189 +0,0 @@
|
|||||||
% CONVENCIONES(2) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Notas para desarrolladores de lvpn :)
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
lib/
|
|
||||||
: comandos
|
|
||||||
|
|
||||||
lib/skel/
|
|
||||||
: archivos base para tinc
|
|
||||||
|
|
||||||
doc/
|
|
||||||
: documentación
|
|
||||||
|
|
||||||
bin/
|
|
||||||
: programas de ayuda que no son especificamente de lvpn
|
|
||||||
|
|
||||||
etc/
|
|
||||||
: código fuente extra
|
|
||||||
|
|
||||||
hosts/
|
|
||||||
: archivos de nodos
|
|
||||||
|
|
||||||
nodos/
|
|
||||||
: nodos propios
|
|
||||||
|
|
||||||
locale/
|
|
||||||
: traducciones
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
## Dónde van los scripts
|
|
||||||
|
|
||||||
El script _lvpn_ autodescubre los comandos siguiendo la convención
|
|
||||||
_lib/lvpn-tuscript_. Además setea algunas variables de entorno que los
|
|
||||||
scripts pueden usar para saber en qué red están trabajando.
|
|
||||||
|
|
||||||
Los scripts pueden estar en cualquier lenguaje de programación mientras
|
|
||||||
sepan leer esas variables de entorno.
|
|
||||||
|
|
||||||
|
|
||||||
## Variables de entorno
|
|
||||||
|
|
||||||
Estas son las variables de entorno que _lvpn_ exporta para el resto de los
|
|
||||||
comandos.
|
|
||||||
|
|
||||||
TINC
|
|
||||||
: Ubicación del directorio del nodo, por defecto _/etc/tinc/lvpn_.
|
|
||||||
|
|
||||||
NETWORK
|
|
||||||
: Nombre de la red, por defecto el último directorio de _TINC_.
|
|
||||||
|
|
||||||
LVPN
|
|
||||||
: Path completo de _lvpn_.
|
|
||||||
|
|
||||||
LVPN\_DIR
|
|
||||||
: Path completo del directorio de trabajo, por defecto el directorio
|
|
||||||
base de _LVPN_
|
|
||||||
|
|
||||||
LVPN\_LIBDIR
|
|
||||||
: Path completo del directorio de comandos.
|
|
||||||
|
|
||||||
LVPN\_HOSTS
|
|
||||||
: Path completo del directorio de hosts.
|
|
||||||
|
|
||||||
LVPN\_BEADLE
|
|
||||||
: Path completo del directorio de llaves anunciables nuevas de desconocidos.
|
|
||||||
|
|
||||||
KEYSIZE
|
|
||||||
: Tamaño por defecto de las llaves.
|
|
||||||
|
|
||||||
LVPN\_SUBNET
|
|
||||||
: El rango de IPv4
|
|
||||||
|
|
||||||
LVPN\_SUBNET6
|
|
||||||
: El rango de IPv6
|
|
||||||
|
|
||||||
TINCD\_FLAGS
|
|
||||||
: Flags para el demonio _tincd_.
|
|
||||||
|
|
||||||
PORT
|
|
||||||
: Puerto por defecto
|
|
||||||
|
|
||||||
sudo
|
|
||||||
: Usar esta variable delante de cualquier comando que deba correr con
|
|
||||||
privilegios de root, ej: _${sudo} rsync_. Requiere _"root=true"_ al
|
|
||||||
principio del script.
|
|
||||||
|
|
||||||
|
|
||||||
## Dónde va la documentación
|
|
||||||
|
|
||||||
La documentación lleva el nombre completo del script:
|
|
||||||
_doc/idioma/lvpn-tuscript.markdown_. La función _help()_ en _lib/msg_
|
|
||||||
lo lleva como argumento para mostrar la ayuda.
|
|
||||||
|
|
||||||
Además, toma la variable de entorno _PAGER_ para paginar la salida, por
|
|
||||||
defecto se usa _less_.
|
|
||||||
|
|
||||||
|
|
||||||
## Flags y parámetros
|
|
||||||
|
|
||||||
_lvpn comando_ -flags nodolocal parametros extra
|
|
||||||
|
|
||||||
Seguido de _lvpn_ viene el comando, al que se le pasan en orden las flags (con
|
|
||||||
sus opciones). El primer parámetro siempre tiene que ser el nodo local en el
|
|
||||||
que se realiza la acción. Luego vienen los parámetros extra (nombres de otros
|
|
||||||
nodos, por ejemplo).
|
|
||||||
|
|
||||||
## Funciones comunes
|
|
||||||
|
|
||||||
En el archivo _lib/common_ se almacenan las funciones de uso común entre todos
|
|
||||||
los comandos. Se la puede incluir en un script añadiendo la línea
|
|
||||||
|
|
||||||
. "${LVPN_LIBDIR}"/common
|
|
||||||
|
|
||||||
al principio del script.
|
|
||||||
|
|
||||||
Nota: Agregar _root=true_ antes de common para poder correr funciones de
|
|
||||||
root.
|
|
||||||
|
|
||||||
### Variables
|
|
||||||
|
|
||||||
* self: nombre del script. Usado para obtener el nombre del script. Ejemplo:
|
|
||||||
_help $self_ llama a la ayuda del script actual.
|
|
||||||
|
|
||||||
### Funciones
|
|
||||||
|
|
||||||
* _add_to_file()_: Agrega una línea al final de un archivo. Uso: _add_to_file
|
|
||||||
archivo "Texto a agregar"_
|
|
||||||
|
|
||||||
* _requires()_: Indica que el script necesita que un programa se encuentre en el
|
|
||||||
PATH. Se recomienda cuando el script llama a un programa que puede no
|
|
||||||
encontrarse en una instalación estándar. Uso: _requires avahi-publish rsync_
|
|
||||||
|
|
||||||
* _get\_node\_dir()_: Encuentra el directorio de un nodo pasándole el nombre del
|
|
||||||
nodo como argumento. _node_dir="$(get_node_dir ${node})"_
|
|
||||||
|
|
||||||
* _get\_node\_file()_: Encuentra el archivo de host de un nodo dentro del
|
|
||||||
directorio del nodo. _node_file="$(get_node_file ${node})"_
|
|
||||||
|
|
||||||
* _get\_node\_name()_: Limpia el nombre del nodo de caracteres inválidos
|
|
||||||
|
|
||||||
* _get\_host\_file()_: Obtiene el archivo del nodo en $LVPN\_HOSTS
|
|
||||||
|
|
||||||
* _find\_init\_system()_: Encuentra el tipo de inicio de tinc. Ver
|
|
||||||
_lib/lvpn-install_.
|
|
||||||
|
|
||||||
* _get\_id()_: Obtiene nombre y mail del responsable del nodo usando git o
|
|
||||||
usuario@hostname.
|
|
||||||
|
|
||||||
* _get\_ipv4()_: Genera una dirección IPv4 a partir de LVPN_SUBNET.
|
|
||||||
|
|
||||||
* _get\_ipv6()_: Genera una dirección IPv6 a partir de LVPN_SUBNET6.
|
|
||||||
|
|
||||||
|
|
||||||
## Mensajes
|
|
||||||
|
|
||||||
En _lib/msg_ se encuentran las funciones básicas para imprimir mensajes en la
|
|
||||||
salida de errores estándar. Esto es para que no sean procesados como la salida
|
|
||||||
estándar de los scripts, que se reservan para poder enviar la información a una
|
|
||||||
tubería.
|
|
||||||
|
|
||||||
No es necesario incluirla ya que se llama desde _lib/common_.
|
|
||||||
|
|
||||||
Todas las funciones tienen soporte para traducciones utilizando gettext, por lo
|
|
||||||
que los mensajes que se completan con variables deben seguir el formato de
|
|
||||||
_printf_: _%s_ para reemplazar por cadenas, _%d_ para números enteros, etc.
|
|
||||||
|
|
||||||
Por ejemplo: _msg "Procesando el nodo %s..." "$node"_
|
|
||||||
|
|
||||||
* _msg()_: Información
|
|
||||||
* _error()_: Mensaje de error
|
|
||||||
* _warning()_: Alerta
|
|
||||||
* _fatal\_error()_: Imprime un mensaje de error y termina el programa
|
|
||||||
inmediatamente
|
|
||||||
* _tip()_: Recomendaciones, por ejemplo, cual comando correr a continuación.
|
|
||||||
|
|
||||||
|
|
||||||
## Los comandos
|
|
||||||
|
|
||||||
La mayoria de los comandos solo configuran, luego hay que enviar los cambios a
|
|
||||||
directorio de instalación con el comando _lvpn init install_.
|
|
@ -1,43 +0,0 @@
|
|||||||
.TH LVPN\-ADD\-HOST 1 "2013" "Manual de LibreVPN" "LibreVPN"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
lvpn add\-host adds a node to known nodes
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn add\-host [\-hfu] local\-node remote\-node [remote\-node2 ...]
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
For a node to connect to another, the latter must "recognize" it by
|
|
||||||
adding it\[aq]s host file.
|
|
||||||
.PP
|
|
||||||
For instance, if the \f[I]ponape\f[] node has a "ConnectTo = medieval"
|
|
||||||
line in it\[aq]s \f[I]tinc.conf\f[] file, for \f[I]medieval\f[] to
|
|
||||||
recognize it, it must add \f[I]ponape\f[]\[aq]s host file in it\[aq]s
|
|
||||||
node dir.
|
|
||||||
.PP
|
|
||||||
The \f[C]\-u\f[] flag updates the already recognized nodes.
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-u
|
|
||||||
Update host files
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Replace if already exists
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Add haiti and noanoa to ponape
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-host\f[] ponape haiti noanoa
|
|
||||||
.SS Update nodes
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-host\f[] \-u ponape
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,48 +0,0 @@
|
|||||||
% LVPN-ADD-HOST(1) Manual de LibreVPN | LibreVPN
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
lvpn add-host adds a node to known nodes
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
lvpn add-host [-hfu] local-node remote-node [remote-node2 ...]
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
For a node to connect to another, the latter must "recognize" it by
|
|
||||||
adding it's host file.
|
|
||||||
|
|
||||||
For instance, if the _ponape_ node has a "ConnectTo = medieval" line in
|
|
||||||
it's _tinc.conf_ file, for _medieval_ to recognize it, it must add
|
|
||||||
_ponape_'s host file in it's node dir.
|
|
||||||
|
|
||||||
The `-u` flag updates the already recognized nodes.
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-u
|
|
||||||
: Update host files
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Replace if already exists
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Add haiti and noanoa to ponape
|
|
||||||
|
|
||||||
_lvpn add-host_ ponape haiti noanoa
|
|
||||||
|
|
||||||
|
|
||||||
## Update nodes
|
|
||||||
|
|
||||||
_lvpn add-host_ -u ponape
|
|
@ -1,51 +0,0 @@
|
|||||||
.TH LVPN\-ADD\-SUBNET 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-subnet\f[] adds an IP address to a node
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-subnet\f[] [\-hvg] \-[4|6][local\-node] [address]
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Verbose mode, informs everything
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-g
|
|
||||||
Generate the IP address instead of waiting for a manually assigned one.
|
|
||||||
This is the default behavior if nothing is specified.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-4
|
|
||||||
Generate an IPv4 address
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-6
|
|
||||||
Generate an IPv6 address.
|
|
||||||
This is the default behavior.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Adds or generates an IP address to the specified host file.
|
|
||||||
It can be either an IPv4 (with \f[I]\-4\f[]) or an IPv6 (with
|
|
||||||
\f[I]\-6\f[]) address.
|
|
||||||
.PP
|
|
||||||
Useful for migrating to IPv6.
|
|
||||||
.PP
|
|
||||||
This command guesses the node\[aq]s name from the $HOSTNAME if none is
|
|
||||||
specified.
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Generate and add an IPv6 to the local node
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-subnet\f[] \-v
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,49 +0,0 @@
|
|||||||
% LVPN-ADD-SUBNET(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
_lvpn add-subnet_ adds an IP address to a node
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn add-subnet_ [-hvg] -[4|6] [local-node] [address]
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Verbose mode, informs everything
|
|
||||||
|
|
||||||
-g
|
|
||||||
: Generate the IP address instead of waiting for a manually assigned
|
|
||||||
one. This is the default behavior if nothing is specified.
|
|
||||||
|
|
||||||
-4
|
|
||||||
: Generate an IPv4 address
|
|
||||||
|
|
||||||
-6
|
|
||||||
: Generate an IPv6 address. This is the default behavior.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Adds or generates an IP address to the specified host file. It can be
|
|
||||||
either an IPv4 (with _-4_) or an IPv6 (with _-6_) address.
|
|
||||||
|
|
||||||
Useful for migrating to IPv6.
|
|
||||||
|
|
||||||
This command guesses the node's name from the $HOSTNAME if none is
|
|
||||||
specified.
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Generate and add an IPv6 to the local node
|
|
||||||
|
|
||||||
_lvpn add-subnet_ -v
|
|
@ -1,59 +0,0 @@
|
|||||||
.TH "LVPN\-ANNOUNCE" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn announce\f[] announce a key on the LAN using Avahi.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn announce\f[] [\-h] [\-sp] local\-node
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Facilitates key exchange on a local network by announcing the local host
|
|
||||||
file on mDNS.
|
|
||||||
Use it with \f[I]lvpn discover\f[].
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s
|
|
||||||
Stop announcing.
|
|
||||||
With \f[I]\-p\f[], removes the \f[I]lvpn.service\f[] file, otherwise it
|
|
||||||
stops \f[I]avahi\-publish\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-p
|
|
||||||
Announce permanently (requires root).
|
|
||||||
Installs \f[I]lvpn.service\f[] so that \f[I]avahi\-daemon\f[] announces
|
|
||||||
the host key every time the service is started.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Announce a node
|
|
||||||
.PP
|
|
||||||
lvpn announce noanoa
|
|
||||||
.SS Announce a node permanently
|
|
||||||
.PP
|
|
||||||
lvpn announce \-p noanoa
|
|
||||||
.PP
|
|
||||||
Installs the \f[I]noanoa\f[] host file on
|
|
||||||
/etc/avahi/services/lvpn.service.
|
|
||||||
.SS Announce keys on beadle (?)
|
|
||||||
.PP
|
|
||||||
lvpn announce \-b amigo
|
|
||||||
.SS Stop announcement
|
|
||||||
.PP
|
|
||||||
lvpn announce \-s
|
|
||||||
.PP
|
|
||||||
Stops \f[I]avahi\-publish\f[] on this session.
|
|
||||||
.SS Stop announcement permanently
|
|
||||||
.PP
|
|
||||||
lvpn announce \-sp
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]avahi.service(5)\f[], \f[I]avahi\-publish(1)\f[],
|
|
||||||
\f[I]lvpn\-discover(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,68 +0,0 @@
|
|||||||
% LVPN-ANNOUNCE(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
_lvpn announce_ announce a key on the LAN using Avahi.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn announce_ [-h] [-sp] local-node
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Facilitates key exchange on a local network by announcing the local host
|
|
||||||
file on mDNS. Use it with _lvpn discover_.
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-s
|
|
||||||
: Stop announcing. With _-p_, removes the _lvpn.service_ file,
|
|
||||||
otherwise it stops _avahi-publish_.
|
|
||||||
|
|
||||||
-p
|
|
||||||
: Announce permanently (requires root). Installs _lvpn.service_ so
|
|
||||||
that _avahi-daemon_ announces the host key every time the service
|
|
||||||
is started.
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Announce a node
|
|
||||||
|
|
||||||
lvpn announce noanoa
|
|
||||||
|
|
||||||
|
|
||||||
## Announce a node permanently
|
|
||||||
|
|
||||||
lvpn announce -p noanoa
|
|
||||||
|
|
||||||
Installs the _noanoa_ host file on /etc/avahi/services/lvpn.service.
|
|
||||||
|
|
||||||
|
|
||||||
## Announce keys on beadle (?)
|
|
||||||
|
|
||||||
lvpn announce -b amigo
|
|
||||||
|
|
||||||
|
|
||||||
## Stop announcement
|
|
||||||
|
|
||||||
lvpn announce -s
|
|
||||||
|
|
||||||
Stops _avahi-publish_ on this session.
|
|
||||||
|
|
||||||
|
|
||||||
## Stop announcement permanently
|
|
||||||
|
|
||||||
lvpn announce -sp
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_avahi.service(5)_, _avahi-publish(1)_, _lvpn-discover(1)_
|
|
@ -1,14 +0,0 @@
|
|||||||
.TH "LVPN\-AVAHI\-ANUNCIO.MARKDOWN" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH lvpn\-announce
|
|
||||||
.PP
|
|
||||||
Anunciar la llave en la red local usando avahi.
|
|
||||||
.PP
|
|
||||||
\-h Este mensaje
|
|
||||||
.PP
|
|
||||||
Uso:
|
|
||||||
.IP \[bu] 2
|
|
||||||
Anunciar un nodo
|
|
||||||
.PP
|
|
||||||
lvpn avahi\-anuncio nodo [tcp|udp] puerto archivo
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,17 +0,0 @@
|
|||||||
% LVPN-AVAHI-ANUNCIO.MARKDOWN(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# lvpn-announce
|
|
||||||
|
|
||||||
Anunciar la llave en la red local usando avahi.
|
|
||||||
|
|
||||||
-h Este mensaje
|
|
||||||
|
|
||||||
Uso:
|
|
||||||
|
|
||||||
* Anunciar un nodo
|
|
||||||
|
|
||||||
lvpn avahi-anuncio nodo [tcp|udp] puerto archivo
|
|
||||||
|
|
||||||
|
|
@ -1,37 +0,0 @@
|
|||||||
.TH LVPN\-CONNECTTO 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Connect to other nodes
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn connectto\f[] local\-node [nodo\-remoto nodo\-remoto2...]
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Configures the local node to connecto to the specified remote nodes.
|
|
||||||
To join a tinc network, you have to copy the host file for the remote
|
|
||||||
node on your hosts/ directory and add the \f[I]ConnectTo =
|
|
||||||
remote\-node\f[] line on your \f[I]tinc.conf\f[].
|
|
||||||
This script automatizes this step.
|
|
||||||
.PP
|
|
||||||
The remote nodes must run the \f[I]lvpn add\-host\f[] command for the
|
|
||||||
local node.
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS List nodes to which noanoa connects to
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ connectto\ noanoa
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SS Add ponape and medieval to noanoa
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ connectto\ noanoa\ ponape\ medieval
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]tinc.conf(5)\f[], \f[I]lvpn\-add\-host(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,39 +0,0 @@
|
|||||||
% LVPN-CONNECTTO(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Connect to other nodes
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn connectto_ local-node [nodo-remoto nodo-remoto2...]
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Configures the local node to connecto to the specified remote nodes. To
|
|
||||||
join a tinc network, you have to copy the host file for the remote node
|
|
||||||
on your hosts/ directory and add the _ConnectTo = remote-node_ line on
|
|
||||||
your _tinc.conf_. This script automatizes this step.
|
|
||||||
|
|
||||||
The remote nodes must run the _lvpn add-host_ command for the local
|
|
||||||
node.
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## List nodes to which noanoa connects to
|
|
||||||
|
|
||||||
lvpn connectto noanoa
|
|
||||||
|
|
||||||
## Add ponape and medieval to noanoa
|
|
||||||
|
|
||||||
lvpn connectto noanoa ponape medieval
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_tinc.conf(5)_, _lvpn-add-host(1)_
|
|
@ -1,15 +0,0 @@
|
|||||||
.TH LVPN\-D3 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Export links and nodes to a d3js force graph.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn d3 > data.json
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Extracts known nodes and links from the tincd log and prints them in
|
|
||||||
JSON format for D3.
|
|
||||||
.PP
|
|
||||||
Tincd must be started with \f[I]\-\-logfile\f[].
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,20 +0,0 @@
|
|||||||
% LVPN-D3(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Export links and nodes to a d3js force graph.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
lvpn d3 > data.json
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Extracts known nodes and links from the tincd log and prints them in
|
|
||||||
JSON format for D3.
|
|
||||||
|
|
||||||
Tincd must be started with *--logfile*.
|
|
@ -1,85 +0,0 @@
|
|||||||
.TH "LVPN\-DISCOVER" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Discover nodes in the local network using Avahi and optionally adds
|
|
||||||
them.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn discover\f[] [\-h] [\-i if|\-A] [\-a|\-c] [\-f] [\-b]
|
|
||||||
local\-node [nodo\-remoto]
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-i
|
|
||||||
Filter by network interface
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-a
|
|
||||||
Add nodes, recognize them.
|
|
||||||
Downloads the host file and adds it using \f[I]lvpn add\-host\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c
|
|
||||||
Connect to the nodes (implies \-a).
|
|
||||||
After running \f[I]\-a\f[], connect to the nodes using \f[I]lvpn
|
|
||||||
connectto\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Trust keys on the network rather than local copies.
|
|
||||||
When you already have the host file, this copy is used.
|
|
||||||
With this option the host is always downloaded.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-A
|
|
||||||
Use any interface (VPN included, don\[aq]t use with \f[I]\-c\f[]!)
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-b
|
|
||||||
Uses beadle (?)
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Facilitates host file exchange in a local network.
|
|
||||||
.PP
|
|
||||||
Used with \f[I]lvpn announce\f[] to discover nodes on the local network.
|
|
||||||
.PP
|
|
||||||
For security, if the host file already exists, this file is used.
|
|
||||||
With \f[I]\-f\f[] host file is always downloaded.
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Lists nodes discovered on the LAN
|
|
||||||
.PP
|
|
||||||
lvpn discover
|
|
||||||
.SS List all discovered nodes, even in the VPN
|
|
||||||
.PP
|
|
||||||
lvpn discover \-A
|
|
||||||
.SS Add discovered nodes to ponape
|
|
||||||
.PP
|
|
||||||
lvpn discover \-a ponape
|
|
||||||
.SS Ponape connects to all nodes
|
|
||||||
.PP
|
|
||||||
lvpn discover \-c ponape
|
|
||||||
.SS Trust the local network for all host files
|
|
||||||
.PP
|
|
||||||
lvpn discover \-f \-c ponape
|
|
||||||
.SS Only search on one interface
|
|
||||||
.PP
|
|
||||||
lvpn discover \-i eth0 \-c ponape
|
|
||||||
.SS Connect to all announced nodes (warning!)
|
|
||||||
.PP
|
|
||||||
lvpn discover \-c ponape \-A
|
|
||||||
.SS Connects using beadle
|
|
||||||
.PP
|
|
||||||
lvpn discover \-b ponape nuevo\-nodo
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,86 +0,0 @@
|
|||||||
% LVPN-DISCOVER(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Discover nodes in the local network using Avahi and optionally adds
|
|
||||||
them.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn discover_ [-h] [-i if|-A] [-a|-c] [-f] [-b] local-node [nodo-remoto]
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-i
|
|
||||||
: Filter by network interface
|
|
||||||
|
|
||||||
-a
|
|
||||||
: Add nodes, recognize them. Downloads the host file and adds it
|
|
||||||
using _lvpn add-host_.
|
|
||||||
|
|
||||||
-c
|
|
||||||
: Connect to the nodes (implies -a). After running _-a_, connect to
|
|
||||||
the nodes using _lvpn connectto_.
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Trust keys on the network rather than local copies. When you
|
|
||||||
already have the host file, this copy is used. With this option
|
|
||||||
the host is always downloaded.
|
|
||||||
|
|
||||||
-A
|
|
||||||
: Use any interface (VPN included, don't use with _-c_!)
|
|
||||||
|
|
||||||
-b
|
|
||||||
: Uses beadle (?)
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Facilitates host file exchange in a local network.
|
|
||||||
|
|
||||||
Used with _lvpn announce_ to discover nodes on the local network.
|
|
||||||
|
|
||||||
For security, if the host file already exists, this file is used.
|
|
||||||
With _-f_ host file is always downloaded.
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Lists nodes discovered on the LAN
|
|
||||||
|
|
||||||
lvpn discover
|
|
||||||
|
|
||||||
## List all discovered nodes, even in the VPN
|
|
||||||
|
|
||||||
lvpn discover -A
|
|
||||||
|
|
||||||
## Add discovered nodes to ponape
|
|
||||||
|
|
||||||
lvpn discover -a ponape
|
|
||||||
|
|
||||||
## Ponape connects to all nodes
|
|
||||||
|
|
||||||
lvpn discover -c ponape
|
|
||||||
|
|
||||||
## Trust the local network for all host files
|
|
||||||
|
|
||||||
lvpn discover -f -c ponape
|
|
||||||
|
|
||||||
## Only search on one interface
|
|
||||||
|
|
||||||
lvpn discover -i eth0 -c ponape
|
|
||||||
|
|
||||||
## Connect to all announced nodes (warning!)
|
|
||||||
|
|
||||||
lvpn discover -c ponape -A
|
|
||||||
|
|
||||||
## Connects using beadle
|
|
||||||
|
|
||||||
lvpn discover -b ponape nuevo-nodo
|
|
@ -1,120 +0,0 @@
|
|||||||
.TH "LVPN\-INIT" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Creates a new node
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn init [\-A] [\-f] [\-q] [\-p 655] [\-l 192.168.9.202/32] [\-s
|
|
||||||
10.4.24.128/27] [\-r] [\-a internet.domain.tld] [\-c otronodo] nodo
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-q
|
|
||||||
Silent mode
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-a example.org
|
|
||||||
Public address of the node (domain or IP).
|
|
||||||
It can be specified multiple times, so tinc tries these addresses in the
|
|
||||||
given order.
|
|
||||||
If not provided, the node isn\[aq]t publicly accesible and doesn\[aq]t
|
|
||||||
accept connections (it\[aq]s only a client).
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c remote\-node
|
|
||||||
Connect to this node.
|
|
||||||
Fast version of \f[I]lvpn connectto\f[].
|
|
||||||
Can be provided multiple times.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-l 192.168.9.0
|
|
||||||
Use this IP address.
|
|
||||||
If not provided, an address is automatically generated.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-i
|
|
||||||
Install when done (requires root).
|
|
||||||
It\[aq]s the same as \f[I]lvpn install\f[] afterwards.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Force creation.
|
|
||||||
Use when a previous attempt was cancelled or you need to start over.
|
|
||||||
All data is lost!
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-p 655
|
|
||||||
Port number, default is 655 o \f[I]LVPN_PORT\f[] env var.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s 10.0.0.0
|
|
||||||
Announce another subnet (deprecated)
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-r
|
|
||||||
Accept other subnets (deprecated)
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-A
|
|
||||||
Creates a node for Android.
|
|
||||||
Since the system doesn\[aq]t have advanced configuration utilities, this
|
|
||||||
option provides a stripped down version of \f[I]tinc\-up\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Generates the basic configuration of a node and stores it on the
|
|
||||||
\f[I]nodos/node\-name\f[] directory.
|
|
||||||
.PP
|
|
||||||
Se puede correr varias veces con diferentes nombres de nodo para tener
|
|
||||||
configuraciones separadas (un sólo host, varios nodos) o unidas (un nodo
|
|
||||||
para cada host local o remoto).
|
|
||||||
.PP
|
|
||||||
You can run it several times using different node names so you can have
|
|
||||||
separate configurations (single host, several nodes) or united (a node
|
|
||||||
per local or remote host).
|
|
||||||
.PP
|
|
||||||
For instance, embedded devices may not support \f[I]lvpn\f[], but from a
|
|
||||||
GNU/Linux system you can generate the config and push it to the
|
|
||||||
correspondent host (Android phone or tablet, OpenWrt router, etc.)
|
|
||||||
.PP
|
|
||||||
\f[I]IMPORTANT\f[]: by default, nodes without an Address field are
|
|
||||||
assumed to be behind firewalls or not configured to accept direct
|
|
||||||
connections.
|
|
||||||
If you add an Address later you have to remove the IndirectData option.
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Basic config with a single connection
|
|
||||||
.PP
|
|
||||||
lvpn init \-c trululu guachiguau
|
|
||||||
.SS Generate and install basic config with a single connection
|
|
||||||
.PP
|
|
||||||
lvpn init \-i \-a guachiguau.org \-c trululu guachiguau
|
|
||||||
.SS Create a node with a given IP address
|
|
||||||
.PP
|
|
||||||
lvpn init \-l 192.168.9.202/32 guachiguau
|
|
||||||
.SS Create a node that reaches other subnets
|
|
||||||
.PP
|
|
||||||
lvpn init \-r guachiguau
|
|
||||||
.SS Create a node that reaches other subnets and routes one
|
|
||||||
.PP
|
|
||||||
lvpn init \-r \-s 10.4.23.224/27 guachiguau
|
|
||||||
.SS Create an Android node
|
|
||||||
.PP
|
|
||||||
Requires Tinc GUI for Android (http://tinc_gui.poirsouille.org/)
|
|
||||||
.PP
|
|
||||||
lvpn init \-A \-c ponape rapanui
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,107 +0,0 @@
|
|||||||
% LVPN-INIT(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Creates a new node
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
lvpn init [-A] [-f] [-q] [-p 655] [-l 192.168.9.202/32] [-s 10.4.24.128/27] [-r] [-a internet.domain.tld] [-c otronodo] nodo
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-q
|
|
||||||
: Silent mode
|
|
||||||
|
|
||||||
-a example.org
|
|
||||||
: Public address of the node (domain or IP). It can be specified
|
|
||||||
multiple times, so tinc tries these addresses in the given order.
|
|
||||||
If not provided, the node isn't publicly accesible and doesn't
|
|
||||||
accept connections (it's only a client).
|
|
||||||
|
|
||||||
-c remote-node
|
|
||||||
: Connect to this node. Fast version of _lvpn connectto_. Can be
|
|
||||||
provided multiple times.
|
|
||||||
|
|
||||||
-l 192.168.9.0
|
|
||||||
: Use this IP address. If not provided, an address is automatically
|
|
||||||
generated.
|
|
||||||
|
|
||||||
-i
|
|
||||||
: Install when done (requires root). It's the same as _lvpn install_
|
|
||||||
afterwards.
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Force creation. Use when a previous attempt was cancelled or you
|
|
||||||
need to start over. All data is lost!
|
|
||||||
|
|
||||||
-p 655
|
|
||||||
: Port number, default is 655 o *LVPN_PORT* env var.
|
|
||||||
|
|
||||||
-s 10.0.0.0
|
|
||||||
: Announce another subnet (deprecated)
|
|
||||||
|
|
||||||
-r
|
|
||||||
: Accept other subnets (deprecated)
|
|
||||||
|
|
||||||
-A
|
|
||||||
: Creates a node for Android. Since the system doesn't have advanced
|
|
||||||
configuration utilities, this option provides a stripped down
|
|
||||||
version of _tinc-up_.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Generates the basic configuration of a node and stores it on the
|
|
||||||
_nodos/node-name_ directory.
|
|
||||||
|
|
||||||
Se puede correr varias veces con diferentes nombres de nodo para tener
|
|
||||||
configuraciones separadas (un sólo host, varios nodos) o unidas (un nodo
|
|
||||||
para cada host local o remoto).
|
|
||||||
|
|
||||||
You can run it several times using different node names so you can have
|
|
||||||
separate configurations (single host, several nodes) or united (a node
|
|
||||||
per local or remote host).
|
|
||||||
|
|
||||||
For instance, embedded devices may not support _lvpn_, but from a
|
|
||||||
GNU/Linux system you can generate the config and push it to the
|
|
||||||
correspondent host (Android phone or tablet, OpenWrt router, etc.)
|
|
||||||
|
|
||||||
_IMPORTANT_: by default, nodes without an Address field are assumed to
|
|
||||||
be behind firewalls or not configured to accept direct connections. If
|
|
||||||
you add an Address later you have to remove the IndirectData option.
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Basic config with a single connection
|
|
||||||
|
|
||||||
lvpn init -c trululu guachiguau
|
|
||||||
|
|
||||||
## Generate and install basic config with a single connection
|
|
||||||
|
|
||||||
lvpn init -i -a guachiguau.org -c trululu guachiguau
|
|
||||||
|
|
||||||
## Create a node with a given IP address
|
|
||||||
|
|
||||||
lvpn init -l 192.168.9.202/32 guachiguau
|
|
||||||
|
|
||||||
## Create a node that reaches other subnets
|
|
||||||
|
|
||||||
lvpn init -r guachiguau
|
|
||||||
|
|
||||||
## Create a node that reaches other subnets and routes one
|
|
||||||
|
|
||||||
lvpn init -r -s 10.4.23.224/27 guachiguau
|
|
||||||
|
|
||||||
## Create an Android node
|
|
||||||
|
|
||||||
Requires [Tinc GUI for Android](http://tinc_gui.poirsouille.org/)
|
|
||||||
|
|
||||||
lvpn init -A -c ponape rapanui
|
|
@ -1,38 +0,0 @@
|
|||||||
.TH "LVPN\-INSTALL\-MAIL\-SERVER" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\-mail\-server\f[] installs a local mailserver for
|
|
||||||
email exchange from node to node.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\-mail\-server\f[] [\-h] [\-f] [\-p /etc/postfix]
|
|
||||||
local\-node
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Install a \f[I]postfix\f[] configuration suited for email exchange
|
|
||||||
between nodes using local addresses in the form
|
|
||||||
\f[I]user\@node.local\f[].
|
|
||||||
It can also route email to Internet via a SMTP gateway that knows how to
|
|
||||||
translate addresses.
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Force installation.
|
|
||||||
It will replace your actual postfix config!
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-p /etc/postfix
|
|
||||||
Install configuration on another path.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]postfix(1)\f[] \f[I]postmap(1)\f[] \f[I]transport(5)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,38 +0,0 @@
|
|||||||
% LVPN-INSTALL-MAIL-SERVER(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
_lvpn install-mail-server_ installs a local mailserver for email
|
|
||||||
exchange from node to node.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn install-mail-server_ [-h] [-f] [-p /etc/postfix] local-node
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Install a _postfix_ configuration suited for email exchange between
|
|
||||||
nodes using local addresses in the form _user@node.local_. It can also
|
|
||||||
route email to Internet via a SMTP gateway that knows how to translate
|
|
||||||
addresses.
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Force installation. It will replace your actual postfix config!
|
|
||||||
|
|
||||||
-p /etc/postfix
|
|
||||||
: Install configuration on another path.
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_postfix(1)_ _postmap(1)_ _transport(5)_
|
|
@ -1,90 +0,0 @@
|
|||||||
.TH "LVPN\-INSTALL\-SCRIPT" "1" "2013" "LibreVPN Manual" "LibreVPN"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
lvpn install\-script install a script thats executed during VPN events.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn install\-script [\-hves] local\-node event script
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Installs scripts to be executed on VPN events.
|
|
||||||
At the moment, \f[C]tincd\f[] only supports two kinds of events after
|
|
||||||
the VPN starts, when a node connects or disconnects, or when a subnet is
|
|
||||||
announced or dis\-announced.
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Verbose mode
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-e
|
|
||||||
List available events
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s
|
|
||||||
List available scripts
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EVENTS
|
|
||||||
.TP
|
|
||||||
.B tinc
|
|
||||||
This event triggers when the VPN starts/stops.
|
|
||||||
Put scripts that should run once here.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B host
|
|
||||||
Run this script when a node (dis)connects.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B subnet
|
|
||||||
Run this script when a subnet becomes (un)reachable
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH SCRIPTS
|
|
||||||
.TP
|
|
||||||
.B debug
|
|
||||||
Debug events
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B notify
|
|
||||||
Show a notification using D\-Bus.
|
|
||||||
\f[B]It doesn\[aq]t work\f[] because D\-Bus doesn\[aq]t allow users to
|
|
||||||
send notification to another user\[aq]s session.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B ipv6\-router
|
|
||||||
Set this node as an IPv6 router/gateway.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B ipv6\-default\-route
|
|
||||||
Set this node\[aq]s IPv6 default route.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B port\-forwarding
|
|
||||||
Asks the default router to open up the ports, using NAT\-PMP and
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
UPnP
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Notify when a host (dis)connects
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\-script\f[] ponape host notify
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]tinc.conf(5)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,79 +0,0 @@
|
|||||||
% LVPN-INSTALL-SCRIPT(1) LibreVPN Manual | LibreVPN
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
lvpn install-script install a script thats executed during VPN events.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
lvpn install-script [-hves] local-node event script
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Installs scripts to be executed on VPN events. At the moment, `tincd`
|
|
||||||
only supports two kinds of events after the VPN starts, when a node
|
|
||||||
connects or disconnects, or when a subnet is announced or dis-announced.
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Verbose mode
|
|
||||||
|
|
||||||
-e
|
|
||||||
: List available events
|
|
||||||
|
|
||||||
-s
|
|
||||||
: List available scripts
|
|
||||||
|
|
||||||
|
|
||||||
# EVENTS
|
|
||||||
|
|
||||||
tinc
|
|
||||||
: This event triggers when the VPN starts/stops. Put scripts that
|
|
||||||
should run once here.
|
|
||||||
|
|
||||||
host
|
|
||||||
: Run this script when a node (dis)connects.
|
|
||||||
|
|
||||||
subnet
|
|
||||||
: Run this script when a subnet becomes (un)reachable
|
|
||||||
|
|
||||||
|
|
||||||
# SCRIPTS
|
|
||||||
|
|
||||||
debug
|
|
||||||
: Debug events
|
|
||||||
|
|
||||||
notify
|
|
||||||
: Show a notification using D-Bus. **It doesn't work** because D-Bus
|
|
||||||
doesn't allow users to send notification to another user's session.
|
|
||||||
|
|
||||||
ipv6-router
|
|
||||||
: Set this node as an IPv6 router/gateway.
|
|
||||||
|
|
||||||
ipv6-default-route
|
|
||||||
: Set this node's IPv6 default route.
|
|
||||||
|
|
||||||
port-forwarding
|
|
||||||
: Asks the default router to open up the ports, using NAT-PMP and
|
|
||||||
UPnP
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Notify when a host (dis)connects
|
|
||||||
|
|
||||||
_lvpn install-script_ ponape host notify
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_tinc.conf(5)_
|
|
@ -1,46 +0,0 @@
|
|||||||
.TH "LVPN\-INSTALL" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Installs or synchronizes a node on the system.
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\f[] [\-hvdn] local\-node
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Verbose mode
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-r
|
|
||||||
Remove extra files, pristine copy of \f[I]nodos/local\-node\f[].
|
|
||||||
It was \f[I]\-d\f[] but this flag is now reserved for debugging.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-n
|
|
||||||
Dry\-run, use it with \f[I]\-v\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Syncs \f[I]nodos/local\-node\f[] to \f[I]/etc/tinc/lvpn\f[].
|
|
||||||
.PP
|
|
||||||
It\[aq]s required to run it after any change on the config.
|
|
||||||
.PP
|
|
||||||
Also, it configures the system to run the VPN after reboot, and if
|
|
||||||
NetworkManager is used, automatic reconnection after a succesful
|
|
||||||
connection.
|
|
||||||
.PP
|
|
||||||
If the package providing \f[I]nss\-mdns\f[] is installed, edits
|
|
||||||
\f[I]/etc/nsswitch.conf\f[] so it can solve .local addresses.
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]rsync(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,47 +0,0 @@
|
|||||||
% LVPN-INSTALL(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Installs or synchronizes a node on the system.
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn install_ [-hvdn] local-node
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Verbose mode
|
|
||||||
|
|
||||||
-r
|
|
||||||
: Remove extra files, pristine copy of _nodos/local-node_. It was
|
|
||||||
_-d_ but this flag is now reserved for debugging.
|
|
||||||
|
|
||||||
-n
|
|
||||||
: Dry-run, use it with _-v_.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Syncs _nodos/local-node_ to _/etc/tinc/lvpn_.
|
|
||||||
|
|
||||||
It's required to run it after any change on the config.
|
|
||||||
|
|
||||||
Also, it configures the system to run the VPN after reboot, and if
|
|
||||||
NetworkManager is used, automatic reconnection after a succesful
|
|
||||||
connection.
|
|
||||||
|
|
||||||
If the package providing _nss-mdns_ is installed, edits
|
|
||||||
_/etc/nsswitch.conf_ so it can solve .local addresses.
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_rsync(1)_
|
|
@ -1,19 +0,0 @@
|
|||||||
.TH LVPN\-PUSH 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Push a node to a remote host
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn push\f[] nodo user\@host [remote tinc dir]
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
This command allows to install or update a node on a remote host.
|
|
||||||
It\[aq]s designed to work with embedded systems, like OpenWrts routers.
|
|
||||||
.PP
|
|
||||||
Requires SSH access.
|
|
||||||
.SH EXAMPLES
|
|
||||||
.SS Sync a node
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn push\f[] guachiguau root\@10.4.23.225
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,27 +0,0 @@
|
|||||||
% LVPN-PUSH(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Push a node to a remote host
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn push_ nodo user@host [remote tinc dir]
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
This command allows to install or update a node on a remote host. It's
|
|
||||||
designed to work with embedded systems, like OpenWrts routers.
|
|
||||||
|
|
||||||
Requires SSH access.
|
|
||||||
|
|
||||||
|
|
||||||
# EXAMPLES
|
|
||||||
|
|
||||||
## Sync a node
|
|
||||||
|
|
||||||
_lvpn push_ guachiguau root@10.4.23.225
|
|
@ -1,45 +0,0 @@
|
|||||||
.TH LVPN\-SEND\-EMAIL 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Sends the host file by email
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-t
|
|
||||||
Destinataion, default is vpn\@hackcoop.com.ar
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
From field, default is git user or user\@hostname
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s
|
|
||||||
Alternate subject
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-m
|
|
||||||
Alternate message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SS Env vars
|
|
||||||
.TP
|
|
||||||
.B SENDMAIL
|
|
||||||
Alternate sendmail
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Generates an email with the host file and sends it.
|
|
||||||
.PP
|
|
||||||
Requires \f[I]sendmail\f[] or compatible to be configured in the system.
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]sendmail(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,39 +0,0 @@
|
|||||||
% LVPN-SEND-EMAIL(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Sends the host file by email
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-t
|
|
||||||
: Destinataion, default is vpn@hackcoop.com.ar
|
|
||||||
|
|
||||||
-f
|
|
||||||
: From field, default is git user or user@hostname
|
|
||||||
|
|
||||||
-s
|
|
||||||
: Alternate subject
|
|
||||||
|
|
||||||
-m
|
|
||||||
: Alternate message
|
|
||||||
|
|
||||||
|
|
||||||
## Env vars
|
|
||||||
|
|
||||||
SENDMAIL
|
|
||||||
: Alternate sendmail
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Generates an email with the host file and sends it.
|
|
||||||
|
|
||||||
Requires _sendmail_ or compatible to be configured in the system.
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_sendmail(1)_
|
|
@ -1,32 +0,0 @@
|
|||||||
.TH "LVPN\-UNKNOWN\-PEERS" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Lists unknown peers
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn unknown\-peers\f[] [/var/log/tinc.lvpn.log]
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c
|
|
||||||
Count failed connection attempts.
|
|
||||||
Shows a numeric summary of the failed connections.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
Searchs the logfile for nodes which connection attempts are denied
|
|
||||||
because their host files aren\[aq]t available.
|
|
||||||
.PP
|
|
||||||
Tincd must be started with _\-\-logfile__.
|
|
||||||
.PP
|
|
||||||
Useful with \f[I]lvpn add\-host\f[]
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn\-add\-host(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,37 +0,0 @@
|
|||||||
% LVPN-UNKNOWN-PEERS(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Lists unknown peers
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn unknown-peers_ [/var/log/tinc.lvpn.log]
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-c
|
|
||||||
: Count failed connection attempts. Shows a numeric summary of the
|
|
||||||
failed connections.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
Searchs the logfile for nodes which connection attempts are denied
|
|
||||||
because their host files aren't available.
|
|
||||||
|
|
||||||
Tincd must be started with _--logfile__.
|
|
||||||
|
|
||||||
Useful with _lvpn add-host_
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_lvpn-add-host(1)_
|
|
@ -1,22 +0,0 @@
|
|||||||
.TH "LVPN\-UPDATE\-SKEL" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
Upgrades skel files
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn update\-skel\f[] [\-v] node1 [node2 ...]
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Verbose mode
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
The \f[I]lvpn\f[] skel includes init and self\-configuration scripts
|
|
||||||
(\f[I]tinc\-up\f[], etc.).
|
|
||||||
This command upgrades the scripts on the specified nodes.
|
|
||||||
.PP
|
|
||||||
If the files already exist, they\[aq]re saved as \f[I]\&.backup\f[].
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,26 +0,0 @@
|
|||||||
% LVPN-UPDATE-SKEL(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
Upgrades skel files
|
|
||||||
|
|
||||||
|
|
||||||
# SYNOPSIS
|
|
||||||
|
|
||||||
_lvpn update-skel_ [-v] node1 [node2 ...]
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Verbose mode
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
The _lvpn_ skel includes init and self-configuration scripts (_tinc-up_,
|
|
||||||
etc.). This command upgrades the scripts on the specified nodes.
|
|
||||||
|
|
||||||
If the files already exist, they're saved as _.backup_.
|
|
@ -1,53 +0,0 @@
|
|||||||
.TH "LVPN" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
LibreVPN
|
|
||||||
.SS SYNOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn command \-options parameters
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
This message
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c
|
|
||||||
Available commands
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-d
|
|
||||||
Debug mode.
|
|
||||||
Use this flag to enable command debug.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.SS How do I start?
|
|
||||||
.PP
|
|
||||||
By reading http://librevpn.org.ar o \f[I]lvpn init\f[]\[aq]s help :)
|
|
||||||
.SS Where\[aq]s my node?
|
|
||||||
.PP
|
|
||||||
The \f[I]lvpn init\f[] command creates your node on the \f[I]nodos/\f[]
|
|
||||||
directory if running \f[I]lvpn\f[] from the development clone, or to
|
|
||||||
\f[I]~/.config/lvpn/nodos\f[] if installed on system.
|
|
||||||
.PP
|
|
||||||
You can have several nodes but only one per host can be installed (using
|
|
||||||
\f[I]lvpn install your\-node\f[]).
|
|
||||||
.PP
|
|
||||||
Any command that makes changes on the local node must be installed
|
|
||||||
afterwards using the \f[I]lvpn install local\-node\f[] command.
|
|
||||||
.PP
|
|
||||||
All command\[aq]s help can be queried using the \f[I]\-h\f[] flag after
|
|
||||||
the command name:
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ add\-host\ \-h
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn\-init(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,52 +0,0 @@
|
|||||||
% LVPN(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
LibreVPN
|
|
||||||
|
|
||||||
## SYNOPSIS
|
|
||||||
|
|
||||||
lvpn command -options parameters
|
|
||||||
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
-h
|
|
||||||
: This message
|
|
||||||
|
|
||||||
-c
|
|
||||||
: Available commands
|
|
||||||
|
|
||||||
-d
|
|
||||||
: Debug mode. Use this flag to enable command debug.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPTION
|
|
||||||
|
|
||||||
## How do I start?
|
|
||||||
|
|
||||||
By reading http://librevpn.org.ar o _lvpn init_'s help :)
|
|
||||||
|
|
||||||
## Where's my node?
|
|
||||||
|
|
||||||
The _lvpn init_ command creates your node on the _nodos/_ directory if
|
|
||||||
running _lvpn_ from the development clone, or to _~/.config/lvpn/nodos_
|
|
||||||
if installed on system.
|
|
||||||
|
|
||||||
You can have several nodes but only one per host can be installed (using
|
|
||||||
_lvpn install your-node_).
|
|
||||||
|
|
||||||
Any command that makes changes on the local node must be installed
|
|
||||||
afterwards using the _lvpn install local-node_ command.
|
|
||||||
|
|
||||||
All command's help can be queried using the _-h_ flag after the command
|
|
||||||
name:
|
|
||||||
|
|
||||||
lvpn add-host -h
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_lvpn-init(1)_
|
|
@ -1,41 +0,0 @@
|
|||||||
.TH "LVPN_TINCD" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
LibreVPN
|
|
||||||
.SH OPTIONS
|
|
||||||
.PP
|
|
||||||
Recommended flags to run \f[I]tincd\f[]:
|
|
||||||
.SS Security
|
|
||||||
.TP
|
|
||||||
.B \-U nobody
|
|
||||||
Root privileges are dropped
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-R
|
|
||||||
Chroots to the config dir
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-L
|
|
||||||
Put tincd in protected memory.
|
|
||||||
This option protects the encryption keys but it makes tincd unstabled.
|
|
||||||
Use with precaution.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SS Log
|
|
||||||
.TP
|
|
||||||
.B \-\-logfile
|
|
||||||
Logs to /var/log/tinc.vpn.log
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-d 1
|
|
||||||
Logs connections
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
\f[I]tincd(8)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,37 +0,0 @@
|
|||||||
% LVPN\_TINCD(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NAME
|
|
||||||
|
|
||||||
LibreVPN
|
|
||||||
|
|
||||||
# OPTIONS
|
|
||||||
|
|
||||||
Recommended flags to run _tincd_:
|
|
||||||
|
|
||||||
### Security
|
|
||||||
|
|
||||||
-U nobody
|
|
||||||
: Root privileges are dropped
|
|
||||||
|
|
||||||
-R
|
|
||||||
: Chroots to the config dir
|
|
||||||
|
|
||||||
-L
|
|
||||||
: Put tincd in protected memory. This option protects the encryption
|
|
||||||
keys but it makes tincd unstabled. Use with precaution.
|
|
||||||
|
|
||||||
|
|
||||||
### Log
|
|
||||||
|
|
||||||
--logfile
|
|
||||||
: Logs to /var/log/tinc.vpn.log
|
|
||||||
|
|
||||||
-d 1
|
|
||||||
: Logs connections
|
|
||||||
|
|
||||||
|
|
||||||
# SEE ALSO
|
|
||||||
|
|
||||||
_tincd(8)_
|
|
@ -1,239 +1,179 @@
|
|||||||
.TH "CONVENCIONES" "2" "2013" "Manual de LibreVPN" "lvpn"
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "CONVENCIONES" "2" "2013" "Manual de RAP" "rap"
|
||||||
|
.hy
|
||||||
.SH NOMBRE
|
.SH NOMBRE
|
||||||
.PP
|
.PP
|
||||||
Notas para desarrolladores de lvpn :)
|
Notas para desarrolladorxs de RAP :)
|
||||||
.SH SINOPSIS
|
.SH SINOPSIS
|
||||||
.TP
|
.TP
|
||||||
.B lib/
|
lib/
|
||||||
|
herramientas
|
||||||
|
.TP
|
||||||
|
lib/exec/
|
||||||
comandos
|
comandos
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B lib/skel/
|
skel/
|
||||||
archivos base para tinc
|
archivos base para tinc
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B lib/skel/scripts/
|
skel/scripts/
|
||||||
directorio de scripts/hooks
|
directorio de scripts/hooks
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B doc/
|
doc/
|
||||||
documentación
|
documentaci\['o]n
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B bin/
|
hosts/
|
||||||
programas de ayuda que no son especificamente de lvpn
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B etc/
|
|
||||||
código fuente extra
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B hosts/
|
|
||||||
archivos de nodos
|
archivos de nodos
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B nodos/
|
nodos/
|
||||||
nodos propios
|
nodos propios
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B locale/
|
locale/
|
||||||
traducciones
|
traducciones
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPCION
|
.SH DESCRIPCION
|
||||||
.SS Dónde van los scripts
|
.SS D\['o]nde van los scripts
|
||||||
.PP
|
.PP
|
||||||
El script \f[I]lvpn\f[] autodescubre los comandos siguiendo la
|
El script \f[I]rap\f[R] autodescubre los comandos siguiendo la
|
||||||
convención \f[I]lib/lvpn\-tuscript\f[].
|
convenci\['o]n \f[I]lib/exec/el-script\f[R].
|
||||||
Además setea algunas variables de entorno que los scripts pueden usar
|
Adem\['a]s configura algunas variables de entorno que los scripts pueden
|
||||||
para saber en qué red están trabajando.
|
usar para saber en qu\['e] red est\['a]n trabajando.
|
||||||
.PP
|
.PP
|
||||||
Los scripts pueden estar en cualquier lenguaje de programación mientras
|
Los scripts pueden estar en cualquier lenguaje de programaci\['o]n
|
||||||
sepan leer esas variables de entorno.
|
mientras sepan leer esas variables de entorno.
|
||||||
.SS Variables de entorno
|
.SS Variables de entorno
|
||||||
.PP
|
.PP
|
||||||
Estas son las variables de entorno que \f[I]lvpn\f[] exporta para el
|
Estas son las variables de entorno que \f[I]rap\f[R] exporta para el
|
||||||
resto de los comandos.
|
resto de los comandos.
|
||||||
.TP
|
.TP
|
||||||
.B TINC
|
TINC
|
||||||
Ubicación del directorio del nodo, por defecto \f[I]/etc/tinc/lvpn\f[].
|
Ubicaci\['o]n del directorio del nodo, por defecto
|
||||||
.RS
|
\f[I]/etc/tinc/rap\f[R].
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B NETWORK
|
NETWORK
|
||||||
Nombre de la red, por defecto el último directorio de \f[I]TINC\f[].
|
Nombre de la red, por defecto \f[I]rap\f[R].
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN
|
RAP
|
||||||
Path completo de \f[I]lvpn\f[].
|
Path completo de \f[I]rap\f[R].
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN_DIR
|
RAP_DIR
|
||||||
Path completo del directorio de trabajo, por defecto el directorio base
|
Path completo del directorio de trabajo, por defecto el directorio base
|
||||||
de \f[I]LVPN\f[]
|
de \f[I]RAP\f[R]
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN_LIBDIR
|
RAP_LIBDIR
|
||||||
Path completo del directorio de comandos.
|
Path completo del directorio de comandos.
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN_HOSTS
|
RAP_HOSTS
|
||||||
Path completo del directorio de hosts.
|
Path completo del directorio de hosts.
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN_BEADLE
|
KEYSIZE
|
||||||
Path completo del directorio de llaves anunciables nuevas de
|
Tama\[~n]o por defecto de las llaves.
|
||||||
desconocidos.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B KEYSIZE
|
TINCD_FLAGS
|
||||||
Tamaño por defecto de las llaves.
|
Flags para el demonio \f[I]tincd\f[R].
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B LVPN_SUBNET
|
PORT
|
||||||
El rango de IPv4
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B LVPN_SUBNET6
|
|
||||||
El rango de IPv6
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B TINCD_FLAGS
|
|
||||||
Flags para el demonio \f[I]tincd\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B PORT
|
|
||||||
Puerto por defecto
|
Puerto por defecto
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
.TP
|
||||||
.B sudo
|
sudo
|
||||||
Usar esta variable delante de cualquier comando que deba correr con
|
Usar esta variable delante de cualquier comando que deba correr con
|
||||||
privilegios de root, ej: \f[I]${sudo} rsync\f[].
|
privilegios de root, ej: \f[I]${sudo} rsync\f[R].
|
||||||
Requiere \f[I]"root=true"\f[] al principio del script.
|
Requiere \f[I]\[lq]root=true\[rq]\f[R] al principio del script.
|
||||||
.RS
|
.SS D\['o]nde va la documentaci\['o]n
|
||||||
.RE
|
|
||||||
.SS Dónde va la documentación
|
|
||||||
.PP
|
.PP
|
||||||
La documentación lleva el nombre completo del script:
|
La documentaci\['o]n lleva el nombre completo del script:
|
||||||
\f[I]doc/idioma/lvpn\-tuscript.markdown\f[].
|
\f[I]doc/idioma/tuscript.markdown\f[R].
|
||||||
La función \f[I]help()\f[] en \f[I]lib/msg\f[] lo lleva como argumento
|
La funci\['o]n \f[I]help()\f[R] en \f[I]lib/msg\f[R] lo lleva como
|
||||||
para mostrar la ayuda.
|
argumento para mostrar la ayuda.
|
||||||
.PP
|
.PP
|
||||||
Además, toma la variable de entorno \f[I]PAGER\f[] para paginar la
|
Adem\['a]s, toma la variable de entorno \f[I]PAGER\f[R] para paginar la
|
||||||
salida, por defecto se usa \f[I]less\f[].
|
salida, por defecto se usa \f[I]less\f[R].
|
||||||
.SS Flags y parámetros
|
.SS Flags y par\['a]metros
|
||||||
.PP
|
.PP
|
||||||
\f[I]lvpn comando\f[] \-flags nodolocal parametros extra
|
\f[I]rap comando\f[R] -flags nodolocal parametros extra
|
||||||
.PP
|
.PP
|
||||||
Seguido de \f[I]lvpn\f[] viene el comando, al que se le pasan en orden
|
Seguido de \f[I]rap\f[R] viene el comando, al que se le pasan en orden
|
||||||
las flags (con sus opciones).
|
las opciones (con sus valores).
|
||||||
El primer parámetro siempre tiene que ser el nodo local en el que se
|
El primer par\['a]metro siempre tiene que ser el nodo local en el que se
|
||||||
realiza la acción.
|
realiza la acci\['o]n.
|
||||||
Luego vienen los parámetros extra (nombres de otros nodos, por ejemplo).
|
Luego vienen los par\['a]metros extra (nombres de otros nodos, por
|
||||||
|
ejemplo).
|
||||||
.SS Funciones comunes
|
.SS Funciones comunes
|
||||||
.PP
|
.PP
|
||||||
En el archivo \f[I]lib/common\f[] se almacenan las funciones de uso
|
En el archivo \f[I]lib/common\f[R] se almacenan las funciones de uso
|
||||||
común entre todos los comandos.
|
com\['u]n entre todos los comandos.
|
||||||
Se la puede incluir en un script añadiendo la línea
|
Se la puede incluir en un script a\[~n]adiendo la l\['i]nea
|
||||||
.IP
|
.IP
|
||||||
.nf
|
.nf
|
||||||
\f[C]
|
\f[C]
|
||||||
\&.\ "${LVPN_LIBDIR}"/common
|
\&. \[dq]${RAP_LIBDIR}\[dq]/common
|
||||||
\f[]
|
\f[R]
|
||||||
.fi
|
.fi
|
||||||
.PP
|
.PP
|
||||||
al principio del script.
|
al principio del script.
|
||||||
.PP
|
.PP
|
||||||
Nota: Agregar \f[I]root=true\f[] antes de common para poder correr
|
\f[B]Nota:\f[R] Agregar \f[I]root=true\f[R] antes de common para poder
|
||||||
funciones de root.
|
correr funciones de root.
|
||||||
.SS Variables
|
.SS Variables
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
self: nombre del script.
|
self: nombre del script.
|
||||||
Usado para obtener el nombre del script.
|
Usado para obtener el nombre del script.
|
||||||
Ejemplo: \f[I]help $self\f[] llama a la ayuda del script actual.
|
Ejemplo: \f[I]help $self\f[R] llama a la ayuda del script actual.
|
||||||
.SS Funciones
|
.SS Funciones
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]add_to_file()\f[]: Agrega una línea al final de un archivo.
|
\f[I]add_to_file()\f[R]: Agrega una l\['i]nea al final de un archivo.
|
||||||
Uso: \f[I]add_to_file archivo "Texto a agregar"\f[]
|
Uso: \f[I]add_to_file archivo \[lq]Texto a agregar\[rq]\f[R]
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]requires()\f[]: Indica que el script necesita que un programa se
|
\f[I]requires()\f[R]: Indica que el script necesita que un programa se
|
||||||
encuentre en el PATH.
|
encuentre en el PATH.
|
||||||
Se recomienda cuando el script llama a un programa que puede no
|
Se recomienda cuando el script llama a un programa que puede no
|
||||||
encontrarse en una instalación estándar.
|
encontrarse en una instalaci\['o]n est\['a]ndar.
|
||||||
Uso: \f[I]requires avahi\-publish rsync\f[]
|
Uso: \f[I]requires avahi-publish rsync\f[R]
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]get_node_dir()\f[]: Encuentra el directorio de un nodo pasándole el
|
\f[I]get_node_dir()\f[R]: Encuentra el directorio de un nodo
|
||||||
nombre del nodo como argumento.
|
pas\['a]ndole el nombre del nodo como argumento.
|
||||||
\f[I]node_dir="(\f[I]g\f[]\f[I]e\f[]\f[I]t\f[]_\f[I]n\f[]\f[I]o\f[]\f[I]d\f[]\f[I]e\f[]_\f[I]d\f[]\f[I]i\f[]\f[I]r\f[]{node})"\f[]
|
\f[I]node_dir=\[lq]$(get_node_dir ${node})\[rq]\f[R]
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]get_node_file()\f[]: Encuentra el archivo de host de un nodo dentro
|
\f[I]get_node_file()\f[R]: Encuentra el archivo de host de un nodo
|
||||||
del directorio del nodo.
|
dentro del directorio del nodo.
|
||||||
\f[I]node_file="(\f[I]g\f[]\f[I]e\f[]\f[I]t\f[]_\f[I]n\f[]\f[I]o\f[]\f[I]d\f[]\f[I]e\f[]_\f[I]f\f[]\f[I]i\f[]\f[I]l\f[]\f[I]e\f[]{node})"\f[]
|
\f[I]node_file=\[lq]$(get_node_file ${node})\[rq]\f[R]
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]get_node_name()\f[]: Limpia el nombre del nodo de caracteres
|
\f[I]get_node_name()\f[R]: Limpia el nombre del nodo de caracteres
|
||||||
inválidos
|
inv\['a]lidos
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]get_host_file()\f[]: Obtiene el archivo del nodo en $LVPN_HOSTS
|
\f[I]get_host_file()\f[R]: Obtiene el archivo del nodo en $RAP_HOSTS
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]find_init_system()\f[]: Encuentra el tipo de inicio de tinc.
|
|
||||||
Ver \f[I]lib/lvpn\-install\f[].
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_id()\f[]: Obtiene nombre y mail del responsable del nodo usando
|
|
||||||
git o usuario\@hostname.
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_ipv4()\f[]: Genera una dirección IPv4 a partir de LVPN_SUBNET.
|
|
||||||
.IP \[bu] 2
|
|
||||||
\f[I]get_ipv6()\f[]: Genera una dirección IPv6 a partir de LVPN_SUBNET6.
|
|
||||||
.SS Mensajes
|
.SS Mensajes
|
||||||
.PP
|
.PP
|
||||||
En \f[I]lib/msg\f[] se encuentran las funciones básicas para imprimir
|
En \f[I]lib/msg\f[R] se encuentran las funciones b\['a]sicas para
|
||||||
mensajes en la salida de errores estándar.
|
imprimir mensajes en la salida de errores est\['a]ndar.
|
||||||
Esto es para que no sean procesados como la salida estándar de los
|
Esto es para que no sean procesados como la salida est\['a]ndar de los
|
||||||
scripts, que se reservan para poder enviar la información a una tubería.
|
scripts, que se reservan para poder enviar la informaci\['o]n a una
|
||||||
|
tuber\['i]a.
|
||||||
.PP
|
.PP
|
||||||
No es necesario incluirla ya que se llama desde \f[I]lib/common\f[].
|
No es necesario incluirla ya que se llama desde \f[I]lib/common\f[R].
|
||||||
.PP
|
.PP
|
||||||
Todas las funciones tienen soporte para traducciones utilizando gettext,
|
Todas las funciones tienen soporte para traducciones utilizando gettext,
|
||||||
por lo que los mensajes que se completan con variables deben seguir el
|
por lo que los mensajes que se completan con variables deben seguir el
|
||||||
formato de \f[I]printf\f[]: \f[I]%s\f[] para reemplazar por cadenas,
|
formato de \f[I]printf\f[R]: \f[I]%s\f[R] para reemplazar por cadenas,
|
||||||
\f[I]%d\f[] para números enteros, etc.
|
\f[I]%d\f[R] para n\['u]meros enteros, etc.
|
||||||
.PP
|
.PP
|
||||||
Por ejemplo: \f[I]msg "Procesando el nodo %s..." "$node"\f[]
|
Por ejemplo: \f[I]msg \[lq]Procesando el nodo %s\&...\[rq]
|
||||||
|
\[lq]$node\[rq]\f[R]
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]msg()\f[]: Información
|
\f[I]msg()\f[R]: Informaci\['o]n
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]error()\f[]: Mensaje de error
|
\f[I]error()\f[R]: Mensaje de error
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]warning()\f[]: Alerta
|
\f[I]warning()\f[R]: Alerta
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]fatal_error()\f[]: Imprime un mensaje de error y termina el
|
\f[I]fatal_error()\f[R]: Imprime un mensaje de error y termina el
|
||||||
programa inmediatamente
|
programa inmediatamente
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
\f[I]tip()\f[]: Recomendaciones, por ejemplo, cual comando correr a
|
\f[I]tip()\f[R]: Recomendaciones, por ejemplo, cual comando correr a
|
||||||
continuación.
|
continuaci\['o]n.
|
||||||
.SS Los comandos
|
.SS Los comandos
|
||||||
.PP
|
.PP
|
||||||
La mayoria de los comandos solo configuran, luego hay que enviar los
|
La mayoria de los comandos solo configuran, luego hay que enviar los
|
||||||
cambios a directorio de instalación con el comando \f[I]lvpn init
|
cambios a directorio de instalaci\['o]n con el comando \f[I]rap init
|
||||||
install\f[].
|
install\f[R].
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
fauno <fauno@endefensadelsl.org>.
|
fauno <fauno@endefensadelsl.org>.
|
||||||
|
@ -1,32 +1,29 @@
|
|||||||
% CONVENCIONES(2) Manual de LibreVPN | lvpn
|
% CONVENCIONES(2) Manual de RAP | rap
|
||||||
% fauno <fauno@endefensadelsl.org>
|
% fauno <fauno@endefensadelsl.org>
|
||||||
% 2013
|
% 2013
|
||||||
|
|
||||||
# NOMBRE
|
# NOMBRE
|
||||||
|
|
||||||
Notas para desarrolladores de lvpn :)
|
Notas para desarrolladorxs de RAP :)
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
# SINOPSIS
|
||||||
|
|
||||||
lib/
|
lib/
|
||||||
|
: herramientas
|
||||||
|
|
||||||
|
lib/exec/
|
||||||
: comandos
|
: comandos
|
||||||
|
|
||||||
lib/skel/
|
skel/
|
||||||
: archivos base para tinc
|
: archivos base para tinc
|
||||||
|
|
||||||
lib/skel/scripts/
|
skel/scripts/
|
||||||
: directorio de scripts/hooks
|
: directorio de scripts/hooks
|
||||||
|
|
||||||
doc/
|
doc/
|
||||||
: documentación
|
: documentación
|
||||||
|
|
||||||
bin/
|
|
||||||
: programas de ayuda que no son especificamente de lvpn
|
|
||||||
|
|
||||||
etc/
|
|
||||||
: código fuente extra
|
|
||||||
|
|
||||||
hosts/
|
hosts/
|
||||||
: archivos de nodos
|
: archivos de nodos
|
||||||
|
|
||||||
@ -41,9 +38,9 @@ locale/
|
|||||||
|
|
||||||
## Dónde van los scripts
|
## Dónde van los scripts
|
||||||
|
|
||||||
El script _lvpn_ autodescubre los comandos siguiendo la convención
|
El script _rap_ autodescubre los comandos siguiendo la convención
|
||||||
_lib/lvpn-tuscript_. Además setea algunas variables de entorno que los
|
_lib/exec/el-script_. Además configura algunas variables de entorno que
|
||||||
scripts pueden usar para saber en qué red están trabajando.
|
los scripts pueden usar para saber en qué red están trabajando.
|
||||||
|
|
||||||
Los scripts pueden estar en cualquier lenguaje de programación mientras
|
Los scripts pueden estar en cualquier lenguaje de programación mientras
|
||||||
sepan leer esas variables de entorno.
|
sepan leer esas variables de entorno.
|
||||||
@ -51,40 +48,31 @@ sepan leer esas variables de entorno.
|
|||||||
|
|
||||||
## Variables de entorno
|
## Variables de entorno
|
||||||
|
|
||||||
Estas son las variables de entorno que _lvpn_ exporta para el resto de los
|
Estas son las variables de entorno que _rap_ exporta para el resto de
|
||||||
comandos.
|
los comandos.
|
||||||
|
|
||||||
TINC
|
TINC
|
||||||
: Ubicación del directorio del nodo, por defecto _/etc/tinc/lvpn_.
|
: Ubicación del directorio del nodo, por defecto _/etc/tinc/rap_.
|
||||||
|
|
||||||
NETWORK
|
NETWORK
|
||||||
: Nombre de la red, por defecto el último directorio de _TINC_.
|
: Nombre de la red, por defecto _rap_.
|
||||||
|
|
||||||
LVPN
|
RAP
|
||||||
: Path completo de _lvpn_.
|
: Path completo de _rap_.
|
||||||
|
|
||||||
LVPN\_DIR
|
RAP\_DIR
|
||||||
: Path completo del directorio de trabajo, por defecto el directorio
|
: Path completo del directorio de trabajo, por defecto el directorio
|
||||||
base de _LVPN_
|
base de _RAP_
|
||||||
|
|
||||||
LVPN\_LIBDIR
|
RAP\_LIBDIR
|
||||||
: Path completo del directorio de comandos.
|
: Path completo del directorio de comandos.
|
||||||
|
|
||||||
LVPN\_HOSTS
|
RAP\_HOSTS
|
||||||
: Path completo del directorio de hosts.
|
: Path completo del directorio de hosts.
|
||||||
|
|
||||||
LVPN\_BEADLE
|
|
||||||
: Path completo del directorio de llaves anunciables nuevas de desconocidos.
|
|
||||||
|
|
||||||
KEYSIZE
|
KEYSIZE
|
||||||
: Tamaño por defecto de las llaves.
|
: Tamaño por defecto de las llaves.
|
||||||
|
|
||||||
LVPN\_SUBNET
|
|
||||||
: El rango de IPv4
|
|
||||||
|
|
||||||
LVPN\_SUBNET6
|
|
||||||
: El rango de IPv6
|
|
||||||
|
|
||||||
TINCD\_FLAGS
|
TINCD\_FLAGS
|
||||||
: Flags para el demonio _tincd_.
|
: Flags para el demonio _tincd_.
|
||||||
|
|
||||||
@ -100,8 +88,8 @@ sudo
|
|||||||
## Dónde va la documentación
|
## Dónde va la documentación
|
||||||
|
|
||||||
La documentación lleva el nombre completo del script:
|
La documentación lleva el nombre completo del script:
|
||||||
_doc/idioma/lvpn-tuscript.markdown_. La función _help()_ en _lib/msg_
|
_doc/idioma/tuscript.markdown_. La función _help()_ en _lib/msg_ lo
|
||||||
lo lleva como argumento para mostrar la ayuda.
|
lleva como argumento para mostrar la ayuda.
|
||||||
|
|
||||||
Además, toma la variable de entorno _PAGER_ para paginar la salida, por
|
Además, toma la variable de entorno _PAGER_ para paginar la salida, por
|
||||||
defecto se usa _less_.
|
defecto se usa _less_.
|
||||||
@ -109,72 +97,65 @@ defecto se usa _less_.
|
|||||||
|
|
||||||
## Flags y parámetros
|
## Flags y parámetros
|
||||||
|
|
||||||
_lvpn comando_ -flags nodolocal parametros extra
|
_rap comando_ -flags nodolocal parametros extra
|
||||||
|
|
||||||
Seguido de _lvpn_ viene el comando, al que se le pasan en orden las flags (con
|
Seguido de _rap_ viene el comando, al que se le pasan en orden las
|
||||||
sus opciones). El primer parámetro siempre tiene que ser el nodo local en el
|
opciones (con sus valores). El primer parámetro siempre tiene que ser
|
||||||
que se realiza la acción. Luego vienen los parámetros extra (nombres de otros
|
el nodo local en el que se realiza la acción. Luego vienen los
|
||||||
nodos, por ejemplo).
|
parámetros extra (nombres de otros nodos, por ejemplo).
|
||||||
|
|
||||||
## Funciones comunes
|
## Funciones comunes
|
||||||
|
|
||||||
En el archivo _lib/common_ se almacenan las funciones de uso común entre todos
|
En el archivo _lib/common_ se almacenan las funciones de uso común entre
|
||||||
los comandos. Se la puede incluir en un script añadiendo la línea
|
todos los comandos. Se la puede incluir en un script añadiendo la línea
|
||||||
|
|
||||||
. "${LVPN_LIBDIR}"/common
|
. "${RAP_LIBDIR}"/common
|
||||||
|
|
||||||
al principio del script.
|
al principio del script.
|
||||||
|
|
||||||
Nota: Agregar _root=true_ antes de common para poder correr funciones de
|
**Nota:** Agregar _root=true_ antes de common para poder correr
|
||||||
root.
|
funciones de root.
|
||||||
|
|
||||||
### Variables
|
### Variables
|
||||||
|
|
||||||
* self: nombre del script. Usado para obtener el nombre del script. Ejemplo:
|
* self: nombre del script. Usado para obtener el nombre del
|
||||||
_help $self_ llama a la ayuda del script actual.
|
script. Ejemplo: _help $self_ llama a la ayuda del script actual.
|
||||||
|
|
||||||
### Funciones
|
### Funciones
|
||||||
|
|
||||||
* _add\_to\_file()_: Agrega una línea al final de un archivo. Uso:
|
* _add\_to\_file()_: Agrega una línea al final de un archivo. Uso:
|
||||||
_add\_to\_file archivo "Texto a agregar"_
|
_add\_to\_file archivo "Texto a agregar"_
|
||||||
|
|
||||||
* _requires()_: Indica que el script necesita que un programa se encuentre en el
|
* _requires()_: Indica que el script necesita que un programa se
|
||||||
PATH. Se recomienda cuando el script llama a un programa que puede no
|
encuentre en el PATH. Se recomienda cuando el script llama a un
|
||||||
encontrarse en una instalación estándar. Uso: _requires avahi-publish rsync_
|
programa que puede no encontrarse en una instalación estándar. Uso:
|
||||||
|
_requires avahi-publish rsync_
|
||||||
|
|
||||||
* _get\_node\_dir()_: Encuentra el directorio de un nodo pasándole el nombre del
|
* _get\_node\_dir()_: Encuentra el directorio de un nodo pasándole el
|
||||||
nodo como argumento. _node\_dir="$(get\_node\_dir ${node})"_
|
nombre del nodo como argumento. _node\_dir="$(get\_node\_dir
|
||||||
|
${node})"_
|
||||||
|
|
||||||
* _get\_node\_file()_: Encuentra el archivo de host de un nodo dentro del
|
* _get\_node\_file()_: Encuentra el archivo de host de un nodo dentro
|
||||||
directorio del nodo. _node\_file="$(get\_node\_file ${node})"_
|
del directorio del nodo. _node\_file="$(get\_node\_file ${node})"_
|
||||||
|
|
||||||
* _get\_node\_name()_: Limpia el nombre del nodo de caracteres inválidos
|
* _get\_node\_name()_: Limpia el nombre del nodo de caracteres inválidos
|
||||||
|
|
||||||
* _get\_host\_file()_: Obtiene el archivo del nodo en $LVPN\_HOSTS
|
* _get\_host\_file()_: Obtiene el archivo del nodo en $RAP\_HOSTS
|
||||||
|
|
||||||
* _find\_init\_system()_: Encuentra el tipo de inicio de tinc. Ver
|
|
||||||
_lib/lvpn-install_.
|
|
||||||
|
|
||||||
* _get\_id()_: Obtiene nombre y mail del responsable del nodo usando git o
|
|
||||||
usuario@hostname.
|
|
||||||
|
|
||||||
* _get\_ipv4()_: Genera una dirección IPv4 a partir de LVPN_SUBNET.
|
|
||||||
|
|
||||||
* _get\_ipv6()_: Genera una dirección IPv6 a partir de LVPN_SUBNET6.
|
|
||||||
|
|
||||||
|
|
||||||
## Mensajes
|
## Mensajes
|
||||||
|
|
||||||
En _lib/msg_ se encuentran las funciones básicas para imprimir mensajes en la
|
En _lib/msg_ se encuentran las funciones básicas para imprimir mensajes
|
||||||
salida de errores estándar. Esto es para que no sean procesados como la salida
|
en la salida de errores estándar. Esto es para que no sean procesados
|
||||||
estándar de los scripts, que se reservan para poder enviar la información a una
|
como la salida estándar de los scripts, que se reservan para poder
|
||||||
tubería.
|
enviar la información a una tubería.
|
||||||
|
|
||||||
No es necesario incluirla ya que se llama desde _lib/common_.
|
No es necesario incluirla ya que se llama desde _lib/common_.
|
||||||
|
|
||||||
Todas las funciones tienen soporte para traducciones utilizando gettext, por lo
|
Todas las funciones tienen soporte para traducciones utilizando gettext,
|
||||||
que los mensajes que se completan con variables deben seguir el formato de
|
por lo que los mensajes que se completan con variables deben seguir el
|
||||||
_printf_: _%s_ para reemplazar por cadenas, _%d_ para números enteros, etc.
|
formato de _printf_: _%s_ para reemplazar por cadenas, _%d_ para números
|
||||||
|
enteros, etc.
|
||||||
|
|
||||||
Por ejemplo: _msg "Procesando el nodo %s..." "$node"_
|
Por ejemplo: _msg "Procesando el nodo %s..." "$node"_
|
||||||
|
|
||||||
@ -188,5 +169,5 @@ Por ejemplo: _msg "Procesando el nodo %s..." "$node"_
|
|||||||
|
|
||||||
## Los comandos
|
## Los comandos
|
||||||
|
|
||||||
La mayoria de los comandos solo configuran, luego hay que enviar los cambios a
|
La mayoria de los comandos solo configuran, luego hay que enviar los
|
||||||
directorio de instalación con el comando _lvpn init install_.
|
cambios a directorio de instalación con el comando _rap init install_.
|
||||||
|
40
doc/es/add-host.1
Normal file
40
doc/es/add-host.1
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP-ADD-HOST" "1" "2013" "Manual de RAP" "RAP"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
rap add-host agrega un nodo a los nodos conocidos
|
||||||
|
.SH SINOPSIS
|
||||||
|
.PP
|
||||||
|
rap add-host [-hfu] nodo-local nodo-remoto1 [nodo-remoto2 \&...]
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.PP
|
||||||
|
Para que un nodo pueda conectarse a otro, el segundo nodo debe
|
||||||
|
\[lq]reconocerlo\[rq] agregando su archivo de host.
|
||||||
|
.PP
|
||||||
|
Por ejemplo, si el nodo \f[I]ponape\f[R] posee en su archivo
|
||||||
|
\f[I]tinc.conf\f[R] el comando \[lq]ConnectTo = medieval\[rq], para que
|
||||||
|
\f[I]medieval\f[R] lo reconozca, debe agregar el archivo de
|
||||||
|
\f[I]ponape\f[R] en su directorio de nodos.
|
||||||
|
.PP
|
||||||
|
Con el flag \f[C]-u\f[R] se actualizan los hosts ya agregados.
|
||||||
|
.SH OPCIONES
|
||||||
|
.TP
|
||||||
|
-h
|
||||||
|
Este mensaje
|
||||||
|
.TP
|
||||||
|
-u
|
||||||
|
Actualizar los hosts
|
||||||
|
.TP
|
||||||
|
-f
|
||||||
|
Reemplazar el host si ya existe, forzar
|
||||||
|
.SH EJEMPLOS
|
||||||
|
.SS Agregar los nodos haiti y noanoa a ponape
|
||||||
|
.PP
|
||||||
|
\f[I]rap add-host\f[R] ponape haiti noanoa
|
||||||
|
.SS Actualizar los nodos
|
||||||
|
.PP
|
||||||
|
\f[I]rap add-host\f[R] -u ponape
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
@ -1,15 +1,15 @@
|
|||||||
% LVPN-ADD-HOST(1) Manual de LibreVPN | LibreVPN
|
% RAP-ADD-HOST(1) Manual de RAP | RAP
|
||||||
% fauno <fauno@endefensadelsl.org>
|
% fauno <fauno@endefensadelsl.org>
|
||||||
% 2013
|
% 2013
|
||||||
|
|
||||||
# NOMBRE
|
# NOMBRE
|
||||||
|
|
||||||
lvpn add-host agrega un nodo a los nodos conocidos
|
rap add-host agrega un nodo a los nodos conocidos
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
# SINOPSIS
|
||||||
|
|
||||||
lvpn add-host [-hfu] nodo-local nodo-remoto1 [nodo-remoto2 ...]
|
rap add-host [-hfu] nodo-local nodo-remoto1 [nodo-remoto2 ...]
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
# DESCRIPCION
|
||||||
@ -17,7 +17,7 @@ lvpn add-host [-hfu] nodo-local nodo-remoto1 [nodo-remoto2 ...]
|
|||||||
Para que un nodo pueda conectarse a otro, el segundo nodo debe
|
Para que un nodo pueda conectarse a otro, el segundo nodo debe
|
||||||
"reconocerlo" agregando su archivo de host.
|
"reconocerlo" agregando su archivo de host.
|
||||||
|
|
||||||
Por ejemplo, si el nodo _ponape_ posee en tu archivo _tinc.conf_ el
|
Por ejemplo, si el nodo _ponape_ posee en su archivo _tinc.conf_ el
|
||||||
comando "ConnectTo = medieval", para que _medieval_ lo reconozca, debe
|
comando "ConnectTo = medieval", para que _medieval_ lo reconozca, debe
|
||||||
agregar el archivo de _ponape_ en su directorio de nodos.
|
agregar el archivo de _ponape_ en su directorio de nodos.
|
||||||
|
|
||||||
@ -40,9 +40,9 @@ Con el flag `-u` se actualizan los hosts ya agregados.
|
|||||||
|
|
||||||
## Agregar los nodos haiti y noanoa a ponape
|
## Agregar los nodos haiti y noanoa a ponape
|
||||||
|
|
||||||
_lvpn add-host_ ponape haiti noanoa
|
_rap add-host_ ponape haiti noanoa
|
||||||
|
|
||||||
|
|
||||||
## Actualizar los nodos
|
## Actualizar los nodos
|
||||||
|
|
||||||
_lvpn add-host_ -u ponape
|
_rap add-host_ -u ponape
|
41
doc/es/connectto.1
Normal file
41
doc/es/connectto.1
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP-CONNECTTO" "1" "2013" "Manual de RAP" "rap"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
Se conecta con otros nodos
|
||||||
|
.SH SINOPSIS
|
||||||
|
.PP
|
||||||
|
\f[I]rap connectto\f[R] nodo-local [nodo-remoto nodo-remoto2\&...]
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.PP
|
||||||
|
Configura el nodo local para conectarse a los nodos remotos
|
||||||
|
especificados.
|
||||||
|
Para poder ingresar a una red aut\['o]noma pirata, hay que copiar el
|
||||||
|
archivo de host del nodo remoto en el directorio hosts/ y agregar la
|
||||||
|
l\['i]nea \f[I]ConnectTo = nodo-remoto\f[R] en \f[I]tinc.conf\f[R].
|
||||||
|
Este script automatiza este paso.
|
||||||
|
.PP
|
||||||
|
Los nodos remotos deben ejecutar el comando \f[I]rap add-host\f[R] con
|
||||||
|
el nombre del nodo local.
|
||||||
|
.SH EJEMPLOS
|
||||||
|
.SS Listar los nodos a los que noanoa se conecta
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
rap connectto noanoa
|
||||||
|
\f[R]
|
||||||
|
.fi
|
||||||
|
.SS Agregar los nodos ponape y medieval al nodo noanoa
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
rap connectto noanoa ponape medieval
|
||||||
|
\f[R]
|
||||||
|
.fi
|
||||||
|
.SH VER TAMBIEN
|
||||||
|
.PP
|
||||||
|
\f[I]tinc.conf(5)\f[R], \f[I]rap-add-host(1)\f[R]
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
40
doc/es/connectto.markdown
Normal file
40
doc/es/connectto.markdown
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
% RAP-CONNECTTO(1) Manual de RAP | rap
|
||||||
|
% fauno <fauno@endefensadelsl.org>
|
||||||
|
% 2013
|
||||||
|
|
||||||
|
# NOMBRE
|
||||||
|
|
||||||
|
Se conecta con otros nodos
|
||||||
|
|
||||||
|
|
||||||
|
# SINOPSIS
|
||||||
|
|
||||||
|
_rap connectto_ nodo-local [nodo-remoto nodo-remoto2...]
|
||||||
|
|
||||||
|
|
||||||
|
# DESCRIPCION
|
||||||
|
|
||||||
|
Configura el nodo local para conectarse a los nodos remotos
|
||||||
|
especificados. Para poder ingresar a una red autónoma pirata, hay que
|
||||||
|
copiar el archivo de host del nodo remoto en el directorio hosts/
|
||||||
|
y agregar la línea _ConnectTo = nodo-remoto_ en _tinc.conf_. Este
|
||||||
|
script automatiza este paso.
|
||||||
|
|
||||||
|
Los nodos remotos deben ejecutar el comando _rap add-host_ con el
|
||||||
|
nombre del nodo local.
|
||||||
|
|
||||||
|
|
||||||
|
# EJEMPLOS
|
||||||
|
|
||||||
|
## Listar los nodos a los que noanoa se conecta
|
||||||
|
|
||||||
|
rap connectto noanoa
|
||||||
|
|
||||||
|
## Agregar los nodos ponape y medieval al nodo noanoa
|
||||||
|
|
||||||
|
rap connectto noanoa ponape medieval
|
||||||
|
|
||||||
|
|
||||||
|
# VER TAMBIEN
|
||||||
|
|
||||||
|
_tinc.conf(5)_, _rap-add-host(1)_
|
70
doc/es/init.1
Normal file
70
doc/es/init.1
Normal file
@ -0,0 +1,70 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP-INIT" "1" "2013" "Manual de RAP" "rap"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
Crea un nuevo nodo
|
||||||
|
.SH SINOPSIS
|
||||||
|
.PP
|
||||||
|
rap init [-f] [-q] [-p 655] [-a dominio.eninternet.tld] [-c otronodo]
|
||||||
|
nodo
|
||||||
|
.SH OPCIONES
|
||||||
|
.TP
|
||||||
|
-h
|
||||||
|
Ayuda
|
||||||
|
.TP
|
||||||
|
-q
|
||||||
|
Modo silencioso
|
||||||
|
.TP
|
||||||
|
-a ejemplo.org
|
||||||
|
Ubicaci\['o]n p\['u]blica del nodo (dominio o IP).
|
||||||
|
Puede especificarse varias veces en el orden en que se quiera que los
|
||||||
|
dem\['a]s nodos intenten conectarse.
|
||||||
|
Si no se especifica esta opci\['o]n se entiende que el nodo no es
|
||||||
|
accesible p\['u]blicamente y no acepta conexiones (s\['o]lo cliente).
|
||||||
|
.TP
|
||||||
|
-c nodo-remoto
|
||||||
|
Conectar a este nodo.
|
||||||
|
Versi\['o]n r\['a]pida de \f[I]rap connectto\f[R].
|
||||||
|
Puede especificarse varias veces.
|
||||||
|
.TP
|
||||||
|
-i
|
||||||
|
Instalar al finalizar (requiere root).
|
||||||
|
Es lo mismo que correr \f[I]rap install\f[R] m\['a]s tarde.
|
||||||
|
.TP
|
||||||
|
-f
|
||||||
|
Forzar la creaci\['o]n de un nodo.
|
||||||
|
\['U]til si se cancel\['o] previamente o se quiere comenzar desde cero.
|
||||||
|
.TP
|
||||||
|
-p 655
|
||||||
|
N\['u]mero de puerto, por defecto 655 o la variable de entorno
|
||||||
|
\f[I]RAP_PORT\f[R].
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.PP
|
||||||
|
Genera la configuraci\['o]n b\['a]sica de un nodo y lo almacena en el
|
||||||
|
directorio \f[I]nodos/nombre-del-nodo\f[R].
|
||||||
|
.PP
|
||||||
|
Se puede correr varias veces con diferentes nombres de nodo para tener
|
||||||
|
configuraciones separadas (un s\['o]lo host, varios nodos) o unidas (un
|
||||||
|
nodo para cada host local o remoto).
|
||||||
|
.PP
|
||||||
|
Por ejemplo, los dispositivos embebidos pueden no soportar las
|
||||||
|
herramientas de \f[I]rap\f[R], pero desde un sistema GNU/Linux se puede
|
||||||
|
generar la configuraci\['o]n y luego copiarla al host que corresponda
|
||||||
|
(al celular o tablet Android, router con OpenWrt, etc.)
|
||||||
|
.PP
|
||||||
|
\f[I]IMPORTANTE\f[R]: La configuraci\['o]n por defecto de un nodo sin el
|
||||||
|
campo Address asume que se encuentra detr\['a]s de un firewall o que no
|
||||||
|
est\['a]n configurados para aceptar conexiones directas.
|
||||||
|
Si luego agreg\['a]s una direcci\['o]n p\['u]blica tambi\['e]n ten\['e]s
|
||||||
|
que deshabilitar la opci\['o]n IndirectData.
|
||||||
|
.SH EJEMPLOS
|
||||||
|
.SS Uso b\['a]sico con una sola conexi\['o]n
|
||||||
|
.PP
|
||||||
|
rap init -c trululu guachiguau
|
||||||
|
.SS Crear un nodo p\['u]blico con una conexi\['o]n e instalarlo localmente
|
||||||
|
.PP
|
||||||
|
rap init -i -a guachiguau.org -c trululu guachiguau
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
74
doc/es/init.markdown
Normal file
74
doc/es/init.markdown
Normal file
@ -0,0 +1,74 @@
|
|||||||
|
% RAP-INIT(1) Manual de RAP | rap
|
||||||
|
% fauno <fauno@endefensadelsl.org>
|
||||||
|
% 2013
|
||||||
|
|
||||||
|
# NOMBRE
|
||||||
|
|
||||||
|
Crea un nuevo nodo
|
||||||
|
|
||||||
|
|
||||||
|
# SINOPSIS
|
||||||
|
|
||||||
|
rap init [-f] [-q] [-p 655] [-a dominio.eninternet.tld] [-c otronodo] nodo
|
||||||
|
|
||||||
|
|
||||||
|
# OPCIONES
|
||||||
|
|
||||||
|
-h
|
||||||
|
: Ayuda
|
||||||
|
|
||||||
|
-q
|
||||||
|
: Modo silencioso
|
||||||
|
|
||||||
|
-a ejemplo.org
|
||||||
|
: Ubicación pública del nodo (dominio o IP). Puede especificarse
|
||||||
|
varias veces en el orden en que se quiera que los demás nodos
|
||||||
|
intenten conectarse. Si no se especifica esta opción se entiende
|
||||||
|
que el nodo no es accesible públicamente y no acepta conexiones
|
||||||
|
(sólo cliente).
|
||||||
|
|
||||||
|
-c nodo-remoto
|
||||||
|
: Conectar a este nodo. Versión rápida de _rap connectto_. Puede
|
||||||
|
especificarse varias veces.
|
||||||
|
|
||||||
|
-i
|
||||||
|
: Instalar al finalizar (requiere root). Es lo mismo que correr
|
||||||
|
_rap install_ más tarde.
|
||||||
|
|
||||||
|
-f
|
||||||
|
: Forzar la creación de un nodo. Útil si se canceló previamente o se
|
||||||
|
quiere comenzar desde cero.
|
||||||
|
|
||||||
|
-p 655
|
||||||
|
: Número de puerto, por defecto 655 o la variable de entorno
|
||||||
|
_RAP\_PORT_.
|
||||||
|
|
||||||
|
# DESCRIPCION
|
||||||
|
|
||||||
|
Genera la configuración básica de un nodo y lo almacena en el directorio
|
||||||
|
_nodos/nombre-del-nodo_.
|
||||||
|
|
||||||
|
Se puede correr varias veces con diferentes nombres de nodo para tener
|
||||||
|
configuraciones separadas (un sólo host, varios nodos) o unidas (un nodo
|
||||||
|
para cada host local o remoto).
|
||||||
|
|
||||||
|
Por ejemplo, los dispositivos embebidos pueden no soportar las
|
||||||
|
herramientas de _rap_, pero desde un sistema GNU/Linux se puede generar
|
||||||
|
la configuración y luego copiarla al host que corresponda (al celular o
|
||||||
|
tablet Android, router con OpenWrt, etc.)
|
||||||
|
|
||||||
|
_IMPORTANTE_: La configuración por defecto de un nodo sin el campo
|
||||||
|
Address asume que se encuentra detrás de un firewall o que no están
|
||||||
|
configurados para aceptar conexiones directas. Si luego agregás una
|
||||||
|
dirección pública también tenés que deshabilitar la opción IndirectData.
|
||||||
|
|
||||||
|
|
||||||
|
# EJEMPLOS
|
||||||
|
|
||||||
|
## Uso básico con una sola conexión
|
||||||
|
|
||||||
|
rap init -c trululu guachiguau
|
||||||
|
|
||||||
|
## Crear un nodo público con una conexión e instalarlo localmente
|
||||||
|
|
||||||
|
rap init -i -a guachiguau.org -c trululu guachiguau
|
62
doc/es/install-script.1
Normal file
62
doc/es/install-script.1
Normal file
@ -0,0 +1,62 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP-INSTALL-SCRIPT" "1" "2013" "Manual de RAP" "RAP"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
rap install-script instala script que se ejecutan en eventos de la VPN.
|
||||||
|
.SH SINOPSIS
|
||||||
|
.PP
|
||||||
|
rap install-script [-hves] nodo-local evento script
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.PP
|
||||||
|
Instala scripts que se ejecutan durante eventos de la VPN.
|
||||||
|
Al momento \f[C]tincd\f[R] s\['o]lo soporta dos tipos de eventos luego
|
||||||
|
de iniciado, cuando un nodo se conecta o desconecta, o cuando una subred
|
||||||
|
es anunciada o desanunciada.
|
||||||
|
.SH OPCIONES
|
||||||
|
.TP
|
||||||
|
-h
|
||||||
|
Este mensaje
|
||||||
|
.TP
|
||||||
|
-v
|
||||||
|
Modo verborr\['a]gico
|
||||||
|
.TP
|
||||||
|
-e
|
||||||
|
Listar los eventos disponibles
|
||||||
|
.TP
|
||||||
|
-s
|
||||||
|
Listar los scripts disponibles
|
||||||
|
.SH EVENTOS
|
||||||
|
.TP
|
||||||
|
tinc
|
||||||
|
Este evento se ejecuta cuando se inicia o se detiene la VPN.
|
||||||
|
Colocar scripts que s\['o]lo deben ejecutarse una vez ac\['a].
|
||||||
|
.TP
|
||||||
|
host
|
||||||
|
Ejecutar este script cada vez que un nodo aparece o desaparece.
|
||||||
|
.TP
|
||||||
|
subnet
|
||||||
|
Ejecutar este script cada vez que una subred aparece o desaparece.
|
||||||
|
.SH SCRIPTS
|
||||||
|
.TP
|
||||||
|
debug
|
||||||
|
\['U]til para debuguear eventos
|
||||||
|
.TP
|
||||||
|
ipv6-router
|
||||||
|
Configura este nodo como un router/gateway de IPv6
|
||||||
|
.TP
|
||||||
|
ipv6-default-route
|
||||||
|
Configura la ruta IPv6 por defecto para este nodo
|
||||||
|
.TP
|
||||||
|
port-forwarding
|
||||||
|
Le pide al router que abra los puertos, usando NAT-PMP y UPnP
|
||||||
|
.SH EJEMPLOS
|
||||||
|
.SS Configurar el nodo como un router IPv6
|
||||||
|
.PP
|
||||||
|
\f[I]rap install-script\f[R] ponape host ipv6-router
|
||||||
|
.SH VER TAMBIEN
|
||||||
|
.PP
|
||||||
|
\f[I]tinc.conf(5)\f[R]
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
@ -1,15 +1,15 @@
|
|||||||
% LVPN-INSTALL-SCRIPT(1) Manual de LibreVPN | LibreVPN
|
% RAP-INSTALL-SCRIPT(1) Manual de RAP | RAP
|
||||||
% fauno <fauno@endefensadelsl.org>
|
% fauno <fauno@endefensadelsl.org>
|
||||||
% 2013
|
% 2013
|
||||||
|
|
||||||
# NOMBRE
|
# NOMBRE
|
||||||
|
|
||||||
lvpn install-script instala script que se ejecutan en eventos de la VPN.
|
rap install-script instala script que se ejecutan en eventos de la VPN.
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
# SINOPSIS
|
||||||
|
|
||||||
lvpn install-script [-hves] nodo-local evento script
|
rap install-script [-hves] nodo-local evento script
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
# DESCRIPCION
|
||||||
@ -53,11 +53,6 @@ subnet
|
|||||||
debug
|
debug
|
||||||
: Útil para debuguear eventos
|
: Útil para debuguear eventos
|
||||||
|
|
||||||
notify
|
|
||||||
: Muestra una notificación cada vez que un nodo se conecta o
|
|
||||||
desconecta, usando libnotify. **No funciona**, D-Bus no permite que
|
|
||||||
un usuario mande notificaciones a la sesión de otro.
|
|
||||||
|
|
||||||
ipv6-router
|
ipv6-router
|
||||||
: Configura este nodo como un router/gateway de IPv6
|
: Configura este nodo como un router/gateway de IPv6
|
||||||
|
|
||||||
@ -70,9 +65,9 @@ port-forwarding
|
|||||||
|
|
||||||
# EJEMPLOS
|
# EJEMPLOS
|
||||||
|
|
||||||
## Mostrar una notificación cuando un nodo se (des)conecta
|
## Configurar el nodo como un router IPv6
|
||||||
|
|
||||||
_lvpn install-script_ ponape host notify
|
_rap install-script_ ponape host ipv6-router
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
# VER TAMBIEN
|
38
doc/es/install.1
Normal file
38
doc/es/install.1
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP-INSTALL" "1" "2013" "Manual de RAP" "rap"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
Instala o sincroniza el nodo en el sistema.
|
||||||
|
.SH SINOPSIS
|
||||||
|
.PP
|
||||||
|
\f[I]rap install\f[R] [-hvdn] nodo-local
|
||||||
|
.SH OPCIONES
|
||||||
|
.TP
|
||||||
|
-h
|
||||||
|
Esta ayuda
|
||||||
|
.TP
|
||||||
|
-v
|
||||||
|
Modo verborr\['a]gico
|
||||||
|
.TP
|
||||||
|
-r
|
||||||
|
Eliminar archivos extra, copiar tal cual se ve en nodos/nodo-local.
|
||||||
|
Antes era \f[I]-d\f[R] pero esta flag est\['a] reservada para debug.
|
||||||
|
.TP
|
||||||
|
-n
|
||||||
|
Mostrar los cambios sin realizarlos (usar con -v)
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.PP
|
||||||
|
Sincroniza \f[I]nodos/nodo-local\f[R] con \f[I]/etc/tinc/rap\f[R].
|
||||||
|
.PP
|
||||||
|
\f[B]Es necesario correrlo luego de cada cambio.\f[R]
|
||||||
|
.PP
|
||||||
|
Adem\['a]s, configura el sistema para el inicio autom\['a]tico de la VPN
|
||||||
|
y si se usa NetworkManager, la reconexi\['o]n inmediata al conectarse a
|
||||||
|
una red.
|
||||||
|
.SH VER TAMBIEN
|
||||||
|
.PP
|
||||||
|
\f[I]rsync(1)\f[R]
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
@ -1,4 +1,4 @@
|
|||||||
% LVPN-INSTALL(1) Manual de LibreVPN | lvpn
|
% RAP-INSTALL(1) Manual de RAP | rap
|
||||||
% fauno <fauno@endefensadelsl.org>
|
% fauno <fauno@endefensadelsl.org>
|
||||||
% 2013
|
% 2013
|
||||||
|
|
||||||
@ -9,7 +9,7 @@ Instala o sincroniza el nodo en el sistema.
|
|||||||
|
|
||||||
# SINOPSIS
|
# SINOPSIS
|
||||||
|
|
||||||
_lvpn install_ [-hvdn] nodo-local
|
_rap install_ [-hvdn] nodo-local
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
# OPCIONES
|
||||||
@ -30,17 +30,13 @@ _lvpn install_ [-hvdn] nodo-local
|
|||||||
|
|
||||||
# DESCRIPCION
|
# DESCRIPCION
|
||||||
|
|
||||||
Sincroniza _nodos/nodo-local_ con _/etc/tinc/lvpn_.
|
Sincroniza _nodos/nodo-local_ con _/etc/tinc/rap_.
|
||||||
|
|
||||||
Es necesario correrlo luego de cada cambio.
|
**Es necesario correrlo luego de cada cambio.**
|
||||||
|
|
||||||
Además, configura el sistema para el inicio automático de la VPN y si
|
Además, configura el sistema para el inicio automático de la VPN y si
|
||||||
se usa NetworkManager, la reconexión inmediata al conectarse a una red.
|
se usa NetworkManager, la reconexión inmediata al conectarse a una red.
|
||||||
|
|
||||||
Si el paquete que provee _nss-mdns_ se encuentra instalado, modificar el
|
|
||||||
archivo _/etc/nsswitch.conf_ para resolver direcciones _hostname.local_.
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
# VER TAMBIEN
|
||||||
|
|
||||||
_rsync(1)_
|
_rsync(1)_
|
@ -1,43 +0,0 @@
|
|||||||
.TH LVPN\-ADD\-HOST 1 "2013" "Manual de LibreVPN" "LibreVPN"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
lvpn add\-host agrega un nodo a los nodos conocidos
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn add\-host [\-hfu] nodo\-local nodo\-remoto1 [nodo\-remoto2 ...]
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Para que un nodo pueda conectarse a otro, el segundo nodo debe
|
|
||||||
"reconocerlo" agregando su archivo de host.
|
|
||||||
.PP
|
|
||||||
Por ejemplo, si el nodo \f[I]ponape\f[] posee en tu archivo
|
|
||||||
\f[I]tinc.conf\f[] el comando "ConnectTo = medieval", para que
|
|
||||||
\f[I]medieval\f[] lo reconozca, debe agregar el archivo de
|
|
||||||
\f[I]ponape\f[] en su directorio de nodos.
|
|
||||||
.PP
|
|
||||||
Con el flag \f[C]\-u\f[] se actualizan los hosts ya agregados.
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Este mensaje
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-u
|
|
||||||
Actualizar los hosts
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Reemplazar el host si ya existe, forzar
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EJEMPLOS
|
|
||||||
.SS Agregar los nodos haiti y noanoa a ponape
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-host\f[] ponape haiti noanoa
|
|
||||||
.SS Actualizar los nodos
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn add\-host\f[] \-u ponape
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,50 +0,0 @@
|
|||||||
% LVPN-ADD-SUBNET(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
_lvpn add-subnet_ agrega una dirección IP al nodo
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn add-subnet_ [-hvg] -[4|6] [nodo-local] [dirección]
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Ayuda
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Modo verborrágico, informa todo lo que se está haciendo
|
|
||||||
|
|
||||||
-g
|
|
||||||
: Generar la dirección IP automáticamente en lugar de esperar una
|
|
||||||
dirección asignada manualmente. Este es el comportamiento por
|
|
||||||
defecto si no se especifica nada.
|
|
||||||
|
|
||||||
-4
|
|
||||||
: Generar una dirección IPv4
|
|
||||||
|
|
||||||
-6
|
|
||||||
: Generar una dirección IPv6. Este es el comportamiento por defecto.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Agrega o genera una dirección IP en el archivo de host del nodo
|
|
||||||
especificado. Puede ser IPv4 (con _-4_) o IPv6 (con _-6_).
|
|
||||||
|
|
||||||
Útil para la migración a IPv6.
|
|
||||||
|
|
||||||
Este comando adivina el nombre del nodo a partir de $HOSTNAME si no se
|
|
||||||
pasa como argumento.
|
|
||||||
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Generar y agregar una IPv6 al nodo local
|
|
||||||
|
|
||||||
_lvpn add-subnet_ -v
|
|
@ -1,68 +0,0 @@
|
|||||||
% LVPN-ANNOUNCE(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
_lvpn announce_ Anunciar la llave en la red local usando avahi.
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn announce_ [-h] [-sp] nodo-local
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Facilita el intercambio de llaves en una red local anunciando el host
|
|
||||||
local en mDNS. Usar en conjunto con _lvpn discover_.
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Ayuda
|
|
||||||
|
|
||||||
-s
|
|
||||||
: Dejar de anunciar, junto con _-p_ elimina el archivo
|
|
||||||
_lvpn.service_, sino, detiene _avahi-publish_.
|
|
||||||
|
|
||||||
-p
|
|
||||||
: Anunciar permanentemente (requiere root). Instala _lvpn.service_
|
|
||||||
de forma que _avahi-daemon_ anuncie la llave cada vez que se inicia
|
|
||||||
el servicio.
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Anunciar un nodo
|
|
||||||
|
|
||||||
lvpn announce noanoa
|
|
||||||
|
|
||||||
|
|
||||||
## Anunciar un nodo permanentemente
|
|
||||||
|
|
||||||
lvpn announce -p noanoa
|
|
||||||
|
|
||||||
Instala el host _noanoa_ en /etc/avahi/services/lvpn.service.
|
|
||||||
|
|
||||||
|
|
||||||
## Anuncia una llaves tipo conserje (?)
|
|
||||||
|
|
||||||
lvpn announce -b amigo
|
|
||||||
|
|
||||||
|
|
||||||
## Dejar de anunciar un nodo
|
|
||||||
|
|
||||||
lvpn announce -s
|
|
||||||
|
|
||||||
Detiene _avahi-publish_ para esta sesión.
|
|
||||||
|
|
||||||
|
|
||||||
## Dejar de anunciar un nodo permanente
|
|
||||||
|
|
||||||
lvpn announce -sp
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
|
||||||
|
|
||||||
_avahi.service(5)_, _avahi-publish(1)_, _lvpn-discover(1)_
|
|
@ -1,17 +0,0 @@
|
|||||||
% LVPN-AVAHI-ANUNCIO.MARKDOWN(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# lvpn-announce
|
|
||||||
|
|
||||||
Anunciar la llave en la red local usando avahi.
|
|
||||||
|
|
||||||
-h Este mensaje
|
|
||||||
|
|
||||||
Uso:
|
|
||||||
|
|
||||||
* Anunciar un nodo
|
|
||||||
|
|
||||||
lvpn avahi-anuncio nodo [tcp|udp] puerto archivo
|
|
||||||
|
|
||||||
|
|
@ -1,38 +0,0 @@
|
|||||||
.TH LVPN\-CONNECTTO 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
Agregar otros nodos a los que conectarse
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn connectto\f[] nodo\-local [nodo\-remoto nodo\-remoto2...]
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Configura el nodo local para conectarse a los nodos remotos
|
|
||||||
especificados.
|
|
||||||
Para poder ingresar a una red tinc, hay que copiar el archivo de host
|
|
||||||
del nodo remoto en el directorio hosts/ y agregar la línea
|
|
||||||
\f[I]ConnectTo = nodo\-remoto\f[] en \f[I]tinc.conf\f[].
|
|
||||||
Este script automatiza este paso.
|
|
||||||
.PP
|
|
||||||
Los nodos remotos deben ejecutar el comando \f[I]lvpn add\-host\f[] con
|
|
||||||
el nombre del nodo local.
|
|
||||||
.SH EJEMPLOS
|
|
||||||
.SS Listar los nodos a los que noanoa se conecta
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ connectto\ noanoa
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SS Agregar los nodos ponape y medieval al nodo noanoa
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ connectto\ noanoa\ ponape\ medieval
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SH VER TAMBIEN
|
|
||||||
.PP
|
|
||||||
\f[I]tinc.conf(5)\f[], \f[I]lvpn\-add\-host(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,40 +0,0 @@
|
|||||||
% LVPN-CONNECTTO(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Agregar otros nodos a los que conectarse
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn connectto_ nodo-local [nodo-remoto nodo-remoto2...]
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Configura el nodo local para conectarse a los nodos remotos
|
|
||||||
especificados. Para poder ingresar a una red tinc, hay que copiar el
|
|
||||||
archivo de host del nodo remoto en el directorio hosts/ y agregar la
|
|
||||||
línea _ConnectTo = nodo-remoto_ en _tinc.conf_. Este script automatiza
|
|
||||||
este paso.
|
|
||||||
|
|
||||||
Los nodos remotos deben ejecutar el comando _lvpn add-host_ con el
|
|
||||||
nombre del nodo local.
|
|
||||||
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Listar los nodos a los que noanoa se conecta
|
|
||||||
|
|
||||||
lvpn connectto noanoa
|
|
||||||
|
|
||||||
## Agregar los nodos ponape y medieval al nodo noanoa
|
|
||||||
|
|
||||||
lvpn connectto noanoa ponape medieval
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
|
||||||
|
|
||||||
_tinc.conf(5)_, _lvpn-add-host(1)_
|
|
@ -1,20 +0,0 @@
|
|||||||
% LVPN-D3(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Exportar los enlaces y nodos a un gráfico de fuerza con d3.js.
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
lvpn d3 > data.json
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Extrae los nodos y enlaces conocidos del log de tincd y los imprime en
|
|
||||||
JSON para D3.
|
|
||||||
|
|
||||||
El daemon tincd debe iniciarse con *--logfile*.
|
|
@ -1,86 +0,0 @@
|
|||||||
% LVPN-DISCOVER(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Descubrir nodos en la red local usando Avahi y opcionalmente agregarlos.
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn discover_ [-h] [-i if|-A] [-a|-c] [-f] [-b] nodo-local [nodo-remoto]
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Ayuda
|
|
||||||
|
|
||||||
-i
|
|
||||||
: Filtrar por interface de red
|
|
||||||
|
|
||||||
-a
|
|
||||||
: Agregar los nodos, reconocerlos. Descarga el archivo de host del
|
|
||||||
nodo y lo agrega usando _lvpn add-host_.
|
|
||||||
|
|
||||||
-c
|
|
||||||
: Conectarse a los nodos (implica -a). Luego de correr _-a_, se
|
|
||||||
conecta a los nodos como si se corriera _lvpn connectto_.
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Confiar en las llaves de la red en lugar de las locales. Cuando ya
|
|
||||||
se posee una copia del archivo de host, se utiliza esa copia. Con
|
|
||||||
esta opción siempre se usa el host anunciado.
|
|
||||||
|
|
||||||
-A
|
|
||||||
: Usar todas las interfaces (incluso la de la VPN, ¡no usar con _-c_!)
|
|
||||||
|
|
||||||
-b
|
|
||||||
: Agrega una llave anunciada en la LibreVPN (?)
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Facilita el intercambio de archivos de nodo en una red local.
|
|
||||||
|
|
||||||
Usado en conjunto con _lvpn announce_ para descubrir nodos anunciados en
|
|
||||||
la red local de esta forma.
|
|
||||||
|
|
||||||
Por seguridad, si el archivo del nodo ya existe localmente, se utiliza ese.
|
|
||||||
Con la opción _-f_ se confía en todos.
|
|
||||||
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Listar los nodos encontrados en la LAN
|
|
||||||
|
|
||||||
lvpn discover
|
|
||||||
|
|
||||||
## Encontrar todos los nodos anunciados, incluida la VPN
|
|
||||||
|
|
||||||
lvpn discover -A
|
|
||||||
|
|
||||||
## Agregar los nodos encontrados a ponape
|
|
||||||
|
|
||||||
lvpn discover -a ponape
|
|
||||||
|
|
||||||
## Conectarse a los nodos encontrados por ponape
|
|
||||||
|
|
||||||
lvpn discover -c ponape
|
|
||||||
|
|
||||||
## La red local es de confianza
|
|
||||||
|
|
||||||
lvpn discover -f -c ponape
|
|
||||||
|
|
||||||
## Si estamos conectados a varias redes, sólo buscar en una:
|
|
||||||
|
|
||||||
lvpn discover -i eth0 -c ponape
|
|
||||||
|
|
||||||
## Conectarse a todos los nodos anunciados, incluida la VPN (¡nunca hacer esto!)
|
|
||||||
|
|
||||||
lvpn discover -c ponape -A
|
|
||||||
|
|
||||||
## Conecta a una llave anunciada en la VPN
|
|
||||||
|
|
||||||
lvpn discover -b ponape nuevo-nodo
|
|
@ -1,120 +0,0 @@
|
|||||||
.TH "LVPN\-INIT" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
Crea un nuevo nodo
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn init [\-A] [\-f] [\-q] [\-p 655] [\-l 192.168.9.202/32] [\-s
|
|
||||||
10.4.24.128/27] [\-r] [\-a dominio.eninternet.tld] [\-c otronodo] nodo
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Ayuda
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-q
|
|
||||||
Modo silencioso
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-a ejemplo.org
|
|
||||||
Ubicación pública del nodo (dominio o IP).
|
|
||||||
Puede especificarse varias veces en el orden en que se quiera que los
|
|
||||||
demás nodos intenten conectarse.
|
|
||||||
Si no se especifica esta opción se entiende que el nodo no es accesible
|
|
||||||
públicamente y no acepta conexiones (sólo cliente).
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c nodo\-remoto
|
|
||||||
Conectar a este nodo.
|
|
||||||
Versión rápida de \f[I]lvpn connectto\f[].
|
|
||||||
Puede especificarse varias veces.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-l 192.168.9.0
|
|
||||||
Usar esta dirección IP.
|
|
||||||
Si no se especifica, la dirección es generada automáticamente.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-i
|
|
||||||
Instalar al finalizar (requiere root).
|
|
||||||
Es lo mismo que correr \f[I]lvpn install\f[] más tarde.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-f
|
|
||||||
Forzar la creación de un nodo.
|
|
||||||
Útil si se canceló previamente o se quiere comenzar desde cero.
|
|
||||||
Se pierden todos los datos!
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-p 655
|
|
||||||
Número de puerto, por defecto 655 o la variable de entorno
|
|
||||||
\f[I]LVPN_PORT\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s 10.0.0.0
|
|
||||||
Anunciar otra subred (\f[I]opción no funcional\f[]).
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-r
|
|
||||||
Aceptar otras subredes remotas (\f[I]opción no funcional\f[]).
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-A
|
|
||||||
Crear un nodo para sistemas Android.
|
|
||||||
Dado que el sistema puede no contener utilidades avanzadas de
|
|
||||||
configuración, esta opción instala una versión mínima de
|
|
||||||
\f[I]tinc\-up\f[].
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Genera la configuración básica de un nodo y lo almacena en el directorio
|
|
||||||
\f[I]nodos/nombre\-del\-nodo\f[].
|
|
||||||
.PP
|
|
||||||
Se puede correr varias veces con diferentes nombres de nodo para tener
|
|
||||||
configuraciones separadas (un sólo host, varios nodos) o unidas (un nodo
|
|
||||||
para cada host local o remoto).
|
|
||||||
.PP
|
|
||||||
Por ejemplo, los dispositivos embebidos pueden no soportar las
|
|
||||||
herramientas de \f[I]lvpn\f[], pero desde un sistema GNU/Linux se puede
|
|
||||||
generar la configuración y luego copiarla al host que corresponda (al
|
|
||||||
celular o tablet Android, router con OpenWrt, etc.)
|
|
||||||
.PP
|
|
||||||
\f[I]IMPORTANTE\f[]: La configuración por defecto de un nodo sin el
|
|
||||||
campo Address asume que se encuentra detrás de un firewall o que no
|
|
||||||
están configurados para aceptar conexiones directas.
|
|
||||||
Si agregás un dirección pública también tenés que deshabilitar la opción
|
|
||||||
IndirectData.
|
|
||||||
.SH EJEMPLOS
|
|
||||||
.SS Uso básico con una sola conexión
|
|
||||||
.PP
|
|
||||||
lvpn init \-c trululu guachiguau
|
|
||||||
.SS Crear un nodo público con una conexión e instalarlo localmente
|
|
||||||
.PP
|
|
||||||
lvpn init \-i \-a guachiguau.org \-c trululu guachiguau
|
|
||||||
.SS Crear un nodo con una IP predeterminada en la red
|
|
||||||
.PP
|
|
||||||
lvpn init \-l 192.168.9.202/32 guachiguau
|
|
||||||
.SS Crear un nodo que acepte otras redes
|
|
||||||
.PP
|
|
||||||
lvpn init \-r guachiguau
|
|
||||||
.SS Crear un nodo que acepte otras redes y sea puente de otra red
|
|
||||||
.PP
|
|
||||||
lvpn init \-r \-s 10.4.23.224/27 guachiguau
|
|
||||||
.SS Crear el nodo rapanui para sistemas android
|
|
||||||
.PP
|
|
||||||
Necesita Tinc GUI for Android (http://tinc_gui.poirsouille.org/)
|
|
||||||
.PP
|
|
||||||
lvpn init \-A \-c ponape rapanui
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,108 +0,0 @@
|
|||||||
% LVPN-INIT(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Crea un nuevo nodo
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
lvpn init [-A] [-f] [-q] [-p 655] [-l 192.168.9.202/32] [-s 10.4.24.128/27] [-r] [-a dominio.eninternet.tld] [-c otronodo] nodo
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Ayuda
|
|
||||||
|
|
||||||
-q
|
|
||||||
: Modo silencioso
|
|
||||||
|
|
||||||
-a ejemplo.org
|
|
||||||
: Ubicación pública del nodo (dominio o IP). Puede especificarse
|
|
||||||
varias veces en el orden en que se quiera que los demás nodos
|
|
||||||
intenten conectarse. Si no se especifica esta opción se entiende
|
|
||||||
que el nodo no es accesible públicamente y no acepta conexiones
|
|
||||||
(sólo cliente).
|
|
||||||
|
|
||||||
-c nodo-remoto
|
|
||||||
: Conectar a este nodo. Versión rápida de _lvpn connectto_. Puede
|
|
||||||
especificarse varias veces.
|
|
||||||
|
|
||||||
-l 192.168.9.0
|
|
||||||
: Usar esta dirección IP. Si no se especifica, la dirección es
|
|
||||||
generada automáticamente.
|
|
||||||
|
|
||||||
-i
|
|
||||||
: Instalar al finalizar (requiere root). Es lo mismo que correr
|
|
||||||
_lvpn install_ más tarde.
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Forzar la creación de un nodo. Útil si se canceló previamente o se
|
|
||||||
quiere comenzar desde cero. Se pierden todos los datos!
|
|
||||||
|
|
||||||
-p 655
|
|
||||||
: Número de puerto, por defecto 655 o la variable de entorno
|
|
||||||
_LVPN\_PORT_.
|
|
||||||
|
|
||||||
-s 10.0.0.0
|
|
||||||
: Anunciar otra subred (_opción no funcional_).
|
|
||||||
|
|
||||||
-r
|
|
||||||
: Aceptar otras subredes remotas (_opción no funcional_).
|
|
||||||
|
|
||||||
-A
|
|
||||||
: Crear un nodo para sistemas Android. Dado que el sistema puede no
|
|
||||||
contener utilidades avanzadas de configuración, esta opción instala
|
|
||||||
una versión mínima de _tinc-up_.
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Genera la configuración básica de un nodo y lo almacena en el directorio
|
|
||||||
_nodos/nombre-del-nodo_.
|
|
||||||
|
|
||||||
Se puede correr varias veces con diferentes nombres de nodo para tener
|
|
||||||
configuraciones separadas (un sólo host, varios nodos) o unidas (un nodo
|
|
||||||
para cada host local o remoto).
|
|
||||||
|
|
||||||
Por ejemplo, los dispositivos embebidos pueden no soportar las
|
|
||||||
herramientas de _lvpn_, pero desde un sistema GNU/Linux se puede generar
|
|
||||||
la configuración y luego copiarla al host que corresponda (al celular o
|
|
||||||
tablet Android, router con OpenWrt, etc.)
|
|
||||||
|
|
||||||
_IMPORTANTE_: La configuración por defecto de un nodo sin el campo
|
|
||||||
Address asume que se encuentra detrás de un firewall o que no están
|
|
||||||
configurados para aceptar conexiones directas. Si agregás un dirección
|
|
||||||
pública también tenés que deshabilitar la opción IndirectData.
|
|
||||||
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Uso básico con una sola conexión
|
|
||||||
|
|
||||||
lvpn init -c trululu guachiguau
|
|
||||||
|
|
||||||
## Crear un nodo público con una conexión e instalarlo localmente
|
|
||||||
|
|
||||||
lvpn init -i -a guachiguau.org -c trululu guachiguau
|
|
||||||
|
|
||||||
## Crear un nodo con una IP predeterminada en la red
|
|
||||||
|
|
||||||
lvpn init -l 192.168.9.202/32 guachiguau
|
|
||||||
|
|
||||||
## Crear un nodo que acepte otras redes
|
|
||||||
|
|
||||||
lvpn init -r guachiguau
|
|
||||||
|
|
||||||
## Crear un nodo que acepte otras redes y sea puente de otra red
|
|
||||||
|
|
||||||
lvpn init -r -s 10.4.23.224/27 guachiguau
|
|
||||||
|
|
||||||
## Crear el nodo rapanui para sistemas android
|
|
||||||
|
|
||||||
Necesita [Tinc GUI for Android](http://tinc_gui.poirsouille.org/)
|
|
||||||
|
|
||||||
lvpn init -A -c ponape rapanui
|
|
@ -1,39 +0,0 @@
|
|||||||
% LVPN-INSTALL-MAIL-SERVER(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
_lvpn install-mail-server_ instala un servidor de correo local para
|
|
||||||
intercambio de correo electrónico de nodo a nodo.
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn install-mail-server_ [-h] [-f] [-p /etc/postfix] nodo-local
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Instala una configuración de _postfix_ orientada a intercambiar correo
|
|
||||||
electrónico entre nodos usando direcciones locales con la forma
|
|
||||||
_usuario@nodo.local_. Además puede enviar correo hacia Internet usando
|
|
||||||
un gateway SMTP que traduce las direcciones.
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Este mensaje
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Forzar la instalación, eliminando la configuración de postfix
|
|
||||||
existente
|
|
||||||
|
|
||||||
-p /etc/postfix
|
|
||||||
: Instala la configuración en otra ruta.
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
|
||||||
|
|
||||||
_postfix(1)_ _postmap(1)_ _transport(5)_
|
|
@ -1,90 +0,0 @@
|
|||||||
.TH "LVPN\-INSTALL\-SCRIPT" "1" "2013" "Manual de LibreVPN" "LibreVPN"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
lvpn install\-script instala script que se ejecutan en eventos de la
|
|
||||||
VPN.
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn install\-script [\-hves] nodo\-local evento script
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Instala scripts que se ejecutan durante eventos de la VPN.
|
|
||||||
Al momento \f[C]tincd\f[] sólo soporta dos tipos de eventos luego de
|
|
||||||
iniciado, cuando un nodo se conecta o desconecta, o cuando una subred es
|
|
||||||
anunciada o desanunciada.
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Este mensaje
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Modo verborrágico
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-e
|
|
||||||
Listar los eventos disponibles
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-s
|
|
||||||
Listar los scripts disponibles
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EVENTOS
|
|
||||||
.TP
|
|
||||||
.B tinc
|
|
||||||
Este evento se ejecuta cuando se inicia o se detiene la VPN.
|
|
||||||
Colocar scripts que sólo deben ejecutarse una vez acá.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B host
|
|
||||||
Ejecutar este script cada vez que un nodo aparece o desaparece.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B subnet
|
|
||||||
Ejecutar este script cada vez que una subred aparece o desaparece.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH SCRIPTS
|
|
||||||
.TP
|
|
||||||
.B debug
|
|
||||||
Útil para debuguear eventos
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B notify
|
|
||||||
Muestra una notificación cada vez que un nodo se conecta o desconecta,
|
|
||||||
usando libnotify.
|
|
||||||
\f[B]No funciona\f[], D\-Bus no permite que un usuario mande
|
|
||||||
notificaciones a la sesión de otro.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B ipv6\-router
|
|
||||||
Configura este nodo como un router/gateway de IPv6
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B ipv6\-default\-route
|
|
||||||
Configura la ruta IPv6 por defecto para este nodo
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B port\-forwarding
|
|
||||||
Le pide al router que abra los puertos, usando NAT\-PMP y UPnP
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH EJEMPLOS
|
|
||||||
.SS Mostrar una notificación cuando un nodo se (des)conecta
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\-script\f[] ponape host notify
|
|
||||||
.SH VER TAMBIEN
|
|
||||||
.PP
|
|
||||||
\f[I]tinc.conf(5)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,46 +0,0 @@
|
|||||||
.TH "LVPN\-INSTALL" "1" "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
Instala o sincroniza el nodo en el sistema.
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn install\f[] [\-hvdn] nodo\-local
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Esta ayuda
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-v
|
|
||||||
Modo verborrágico
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-r
|
|
||||||
Eliminar archivos extra, copiar tal cual se ve en nodos/nodo\-local.
|
|
||||||
Antes era \f[I]\-d\f[] pero esta flag está reservada para debug.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-n
|
|
||||||
Mostrar los cambios sin realizarlos (usar con \-v)
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Sincroniza \f[I]nodos/nodo\-local\f[] con \f[I]/etc/tinc/lvpn\f[].
|
|
||||||
.PP
|
|
||||||
Es necesario correrlo luego de cada cambio.
|
|
||||||
.PP
|
|
||||||
Además, configura el sistema para el inicio automático de la VPN y si se
|
|
||||||
usa NetworkManager, la reconexión inmediata al conectarse a una red.
|
|
||||||
.PP
|
|
||||||
Si el paquete que provee \f[I]nss\-mdns\f[] se encuentra instalado,
|
|
||||||
modificar el archivo \f[I]/etc/nsswitch.conf\f[] para resolver
|
|
||||||
direcciones \f[I]hostname.local\f[].
|
|
||||||
.SH VER TAMBIEN
|
|
||||||
.PP
|
|
||||||
\f[I]rsync(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,28 +0,0 @@
|
|||||||
% LVPN-PUSH(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Sincronizar un nodo en otro sistema
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn push_ nodo user@host [directorio de tinc]
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Este comando permite instalar o actualizar un nodo en otro sistema. Está
|
|
||||||
pensado para poder trabajar con nodos embebidos, como los instalados en
|
|
||||||
routers con OpenWRT.
|
|
||||||
|
|
||||||
Necesita acceso SSH.
|
|
||||||
|
|
||||||
|
|
||||||
# EJEMPLOS
|
|
||||||
|
|
||||||
## Sincronizar un nodo
|
|
||||||
|
|
||||||
_lvpn push_ guachiguau root@10.4.23.225
|
|
@ -1,41 +0,0 @@
|
|||||||
% LVPN-SEND-EMAIL(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Envía un nodo por correo
|
|
||||||
|
|
||||||
-h
|
|
||||||
: Ayuda
|
|
||||||
|
|
||||||
-t
|
|
||||||
: Destinatario, por defecto es la lista vpn@hackcoop.com.ar
|
|
||||||
|
|
||||||
-f
|
|
||||||
: Remitente, por defecto email de git o usuario@hostname
|
|
||||||
|
|
||||||
-s
|
|
||||||
: Asunto alternativo
|
|
||||||
|
|
||||||
-m
|
|
||||||
: Mensaje alternativo
|
|
||||||
|
|
||||||
|
|
||||||
## Variables de entorno:
|
|
||||||
|
|
||||||
SENDMAIL
|
|
||||||
: Programa alternativo a sendmail
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
Genera un email con el archivo de host del nodo especificado y lo envía
|
|
||||||
al destinatario.
|
|
||||||
|
|
||||||
Necesita la utilidad _sendmail_ o compatible configurada en el sistema.
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
|
||||||
|
|
||||||
_sendmail(1)_
|
|
@ -1,32 +0,0 @@
|
|||||||
.TH LVPN\-UNKNOWN\-PEERS 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
Lista los pares desconocidos
|
|
||||||
.SH SINOPSIS
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn unknown-peers\f[] [/var/log/tinc.lvpn.log]
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Esta ayuda
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c
|
|
||||||
Contar los intentos de conexión fallidos.
|
|
||||||
Muestra una cuenta de las conexiones sin éxito de cada par.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.PP
|
|
||||||
Busca los nodos que intentan conectarse con el nodo local pero son
|
|
||||||
rechazados porque la llave no está accesible.
|
|
||||||
.PP
|
|
||||||
El demonio tincd debe iniciarse con la opción \f[I]\-\-logfile\f[].
|
|
||||||
.PP
|
|
||||||
Útil para usar en conjunto con \f[I]lvpn add\-host\f[].
|
|
||||||
.SH VER TAMBIEN
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn\-add\-host(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,29 +0,0 @@
|
|||||||
% LVPN-UPDATE-SKEL(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
Actualizar los archivos base.
|
|
||||||
|
|
||||||
|
|
||||||
# SINOPSIS
|
|
||||||
|
|
||||||
_lvpn update-skel_ [-v] nodo1 [nodo2 ...]
|
|
||||||
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
-v
|
|
||||||
: Modo verborrágico
|
|
||||||
|
|
||||||
|
|
||||||
# DESCRIPCION
|
|
||||||
|
|
||||||
El "skel" de _lvpn_ incluye los scripts que inician y configuran la red
|
|
||||||
(_tinc-up_, _tinc-down_, etc.). Este comando actualiza esos scripts en
|
|
||||||
los nodos especificados.
|
|
||||||
|
|
||||||
Si los archivos ya existen se guardan backups con la extensión
|
|
||||||
_.backup_.
|
|
||||||
|
|
@ -1,55 +0,0 @@
|
|||||||
.TH LVPN 1 "2013" "Manual de LibreVPN" "lvpn"
|
|
||||||
.SH NOMBRE
|
|
||||||
.PP
|
|
||||||
LibreVPN
|
|
||||||
.SS SINOPSIS
|
|
||||||
.PP
|
|
||||||
lvpn comando \-opciones parametros
|
|
||||||
.SH OPCIONES
|
|
||||||
.TP
|
|
||||||
.B \-h
|
|
||||||
Ayuda
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-c
|
|
||||||
Lista de comandos disponibles
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.TP
|
|
||||||
.B \-d
|
|
||||||
Habilitar debug.
|
|
||||||
Para hacer debug de los comandos, agregar esta opción.
|
|
||||||
.RS
|
|
||||||
.RE
|
|
||||||
.SH DESCRIPCION
|
|
||||||
.SS ¿Cómo empiezo?
|
|
||||||
.PP
|
|
||||||
Leyendo el sitio http://librevpn.org.ar o la ayuda de \f[I]lvpn init\f[]
|
|
||||||
:)
|
|
||||||
.SS ¿Donde está mi nodo?
|
|
||||||
.PP
|
|
||||||
El comando \f[I]lvpn init\f[] crea tu nodo dentro del directorio
|
|
||||||
\f[I]nodos/\f[] si se está corriendo \f[I]lvpn\f[] desde el directorio
|
|
||||||
de desarrollo, o en \f[I]~/.config/lvpn/nodos\f[] si se encuentra
|
|
||||||
instalado en el sistema.
|
|
||||||
.PP
|
|
||||||
Podés tener varios nodos pero instalar uno por sistema (usando \f[I]lvpn
|
|
||||||
install tunodo\f[]).
|
|
||||||
.PP
|
|
||||||
Cualquier comando que aplique cambios en tu nodo, debe instalarse luego
|
|
||||||
usando el comando \f[I]lvpn install tunodo\f[].
|
|
||||||
.PP
|
|
||||||
Consultar la ayuda de cada comando usando la opción \-h luego del nombre
|
|
||||||
de comando:
|
|
||||||
.IP
|
|
||||||
.nf
|
|
||||||
\f[C]
|
|
||||||
lvpn\ add\-host\ \-h
|
|
||||||
\f[]
|
|
||||||
.fi
|
|
||||||
.SH VER TAMBIEN
|
|
||||||
.PP
|
|
||||||
\f[I]lvpn\-init(1)\f[]
|
|
||||||
.SH AUTHORS
|
|
||||||
fauno <fauno@endefensadelsl.org>.
|
|
@ -1,38 +0,0 @@
|
|||||||
% LVPN\_TINCD(1) Manual de LibreVPN | lvpn
|
|
||||||
% fauno <fauno@endefensadelsl.org>
|
|
||||||
% 2013
|
|
||||||
|
|
||||||
# NOMBRE
|
|
||||||
|
|
||||||
LibreVPN
|
|
||||||
|
|
||||||
# OPCIONES
|
|
||||||
|
|
||||||
Las flags recomendadas para correr _tincd_ son:
|
|
||||||
|
|
||||||
### Seguridad
|
|
||||||
|
|
||||||
-U nobody
|
|
||||||
: No correr con privilegios de root
|
|
||||||
|
|
||||||
-R
|
|
||||||
: Chroot al directorio de configuración
|
|
||||||
|
|
||||||
-L
|
|
||||||
: Poner tincd en memoria protegida. Esta opción protege mejor los
|
|
||||||
parámetros de cifrado pero en mi experiencia hace que _tincd_ se
|
|
||||||
cierre inesperadamente. Usar con precaución.
|
|
||||||
|
|
||||||
|
|
||||||
### Log
|
|
||||||
|
|
||||||
--logfile
|
|
||||||
: Crea /var/log/tinc.vpn.log
|
|
||||||
|
|
||||||
-d 1
|
|
||||||
: Informa las conexiones
|
|
||||||
|
|
||||||
|
|
||||||
# VER TAMBIEN
|
|
||||||
|
|
||||||
_tincd(8)_
|
|
49
doc/es/rap.1
Normal file
49
doc/es/rap.1
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
.\" Automatically generated by Pandoc 2.9.2
|
||||||
|
.\"
|
||||||
|
.TH "RAP" "1" "2013" "Manual de RAP" "rap"
|
||||||
|
.hy
|
||||||
|
.SH NOMBRE
|
||||||
|
.PP
|
||||||
|
RAP
|
||||||
|
.SS SINOPSIS
|
||||||
|
.PP
|
||||||
|
rap comando -opciones parametros
|
||||||
|
.SH OPCIONES
|
||||||
|
.TP
|
||||||
|
-h
|
||||||
|
Ayuda
|
||||||
|
.TP
|
||||||
|
-c
|
||||||
|
Lista de comandos disponibles
|
||||||
|
.TP
|
||||||
|
-d
|
||||||
|
Habilitar debug.
|
||||||
|
Para hacer debug de los comandos, agregar esta opci\['o]n.
|
||||||
|
.SH DESCRIPCION
|
||||||
|
.SS \[r?]C\['o]mo empiezo?
|
||||||
|
.PP
|
||||||
|
Leyendo la ayuda de \f[I]rap init\f[R] :)
|
||||||
|
.SS \[r?]Donde est\['a] mi nodo?
|
||||||
|
.PP
|
||||||
|
El comando \f[I]rap init\f[R] crea tu nodo dentro del directorio
|
||||||
|
\f[I]nodos/\f[R].
|
||||||
|
.PP
|
||||||
|
Pod\['e]s tener varios nodos pero instalar uno por sistema (usando
|
||||||
|
\f[I]rap install tu-nodo\f[R]).
|
||||||
|
.PP
|
||||||
|
Cualquier comando que aplique cambios en tu nodo, debe instalarse luego
|
||||||
|
usando el comando \f[I]rap install tu-nodo\f[R].
|
||||||
|
.PP
|
||||||
|
Consultar la ayuda de cada comando usando la opci\['o]n -h luego del
|
||||||
|
nombre de comando:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
rap add-host -h
|
||||||
|
\f[R]
|
||||||
|
.fi
|
||||||
|
.SH VER TAMBIEN
|
||||||
|
.PP
|
||||||
|
\f[I]rap-init(1)\f[R]
|
||||||
|
.SH AUTHORS
|
||||||
|
fauno <fauno@endefensadelsl.org>.
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user