faucet - Online en la nube

PROGRAMA:

NOMBRE

faucet - un accesorio para una tubería de red BSD

tubos de red 4.2

SINOPSIS

grifo Puerto (--en|--fuera|--errar|--fd n) + [--una vez] [--verboso] [--tranquilo] [--Unix]
[--anfitrión extranjero addr] [--puerto extranjero Puerto] [--localhost addr] [--de serie] [--demonio]
[--apagar (r | w)] [--pidfile nombre de archivo] [--noreuseaddr] [--reserva n]
[-[i][o][e][#3[,4[,5...]]] [v][1][q][u][d][s]] [-p puerto extranjero] [-h anfitrión-extranjero] [-H
anfitrión local] comando args

DESCRIPCIÓN

grifo intenta proporcionar la funcionalidad de las tuberías a través de la red. Se comporta como el
extremo servidor de una conexión servidor-cliente. Cuando se usa con manguera(1) puede funcionar como un
reemplazo para

alquitrán -cf -. | rsh otro "cd destdir; tar -xf -"

grifo y manguera son especialmente útiles cuando no tiene un acceso fácil y no interactivo a
la cuenta de destino (como una cuenta raíz donde .rhosts es una mala idea).

grifo crea un conector BSD, lo une al Puerto especificado en la línea de comando, y
escucha las conexiones.

Cada vez grifo consigue una conexión ejecutivo(2) s comando y su args con stdin, stdout,
stderr, y / o descriptores de archivos arbitrarios redirigidos de acuerdo con --en --fuera --errar
--fd n banderas. grifo también apaga automágicamente la mitad no utilizada de la conexión si
only --en se especifica o si solo --fuera y/o --errar se especifican. Ver el --apagar
opción para obtener más información.

OPCIONES

Si --una vez se especifica la bandera, grifo will ejecutivo(2) el comando en lugar de tenedor(2) ing y
ejecutivo(2) ing. --una vez significa que la tubería de red solo es buena para una toma.

El sistema --verboso bandera especifica que grifo debe imprimir información sobre la conexión de hosts.
Esta información incluye la dirección de host numérica, los nombres de host y los números de puerto externo.
El sistema --tranquilo bandera especifica que grifo NO debe imprimir dicha información. --tranquilo son los
predeterminada.

El sistema --Unix bandera especifica que el Puerto no es un número de puerto de Internet o un nombre de servicio,
pero en cambio es un nombre de archivo para un socket de dominio UNIX.

El sistema --anfitrión extranjero La opción especifica que la llave debe rechazar todas las conexiones que no
venir de la fortaleza máquina. similar --puerto extranjero especifica que el grifo debe rechazar
todas las conexiones que no están vinculadas en su máquina local a la Puerto argumento. Lo anterior
dos opciones permiten una forma burda de autenticación. Tenga en cuenta que en los sistemas UNIX solo el root puede
enlazar un socket a un número de puerto por debajo de 1024.

Por favor, no se deje engañar pensando que esto hace que el grifo sea seguro. Hay formas de parodiar
Números de IP que se conocen desde hace años (pero que solo se han publicado recientemente). Yo creo que
este método está a salvo de falsificaciones de DNS, pero probablemente debería tener sin engaño on in
/etc/host.conf de todos modos.

--localhost especifica que el conector de escucha debe estar vinculado a una Internet específica
dirección en este host. Esto solo es útil en hosts con varios números de Internet.

--demonio especifica que el grifo debe disociarse del terminal de control una vez
ha comenzado a escuchar en el zócalo. Esto se hace usando la llamada al sistema setsid (). Si
no tiene setsid en su sistema, utiliza el estándar `` cerrar todos los descriptores de archivos,
ioctl TIOCNOTTY, fork () y secuencia de salida principal ''.

--apagar se utiliza para convertir el enchufe (normalmente) bidireccional en uno unidireccional
Si la 'r' está presente, entonces grifo cerrará la mitad de la conexión para que sea de solo lectura
enchufe. Si intentamos escribir, fallará. Si la conexión remota intenta leer,
Percibirá el enchufe como cerrado. Si en cambio está presente la 'w', entonces grifo cerrará
la otra mitad de la conexión para convertirla en un zócalo de solo escritura. Si intentamos leer,
Percibirá el enchufe como cerrado. Si la conexión remota intenta escribir, lo hará
fallar. El comportamiento predeterminado es dejar ambas mitades abiertas, sin embargo, el cierre de la mitad de
la conexión se realiza automágicamente mediante ciertas combinaciones de los --en, --fueray --errar
banderas. Para suprimir su comportamiento automágico, puede usar (respectivamente) --fd 0, --fd 1,
y --fd 2.

--apagar no se puede utilizar con algunos servidores de Internet (como ciertos httpds) porque
interpretan el cierre de la mitad de la conexión como un cierre de toda la
conexión. Esta advertencia se aplica a --en, --fueray --errar.

--de serie hace que faucet espere a que un niño termine antes de aceptar más
conexiones. La serialización es una forma muy burda de gestión de secciones críticas.

--pidfile nombre de archivo comandos grifo para escribir su ID de proceso en nombre de archivo. Esto es útil
cuando el grifo es parte de un sistema más grande y un proceso de control puede querer matar el
grifo. --pidfile funciona correctamente cuando se utiliza el --demonio .

De forma predeterminada, grifo realiza un

setsockopt (fd, SOL_SOCKET, SO_REUSEADDR ...)

lo que evita el problema de la `` Dirección en uso '' que `` plagó '' las versiones 4.0 y
más temprano. --noreuseaddr le dice a Faucet que omita esa llamada al sistema y vuelva a la versión anterior a 4.1
comportamiento. Sin esta llamada, el enchufe no siempre está disponible para su reutilización inmediata después de
sale el grifo.

--reserva n le permite especificar el segundo parámetro a la escuchan(2) llamada al sistema. los
el predeterminado es 5.

SHORT BANDERAS

Reducir los requisitos de mecanografía para los argumentos (y rendir homenaje a los antiguos
tradición de la criptotaxonomía UNIX) He añadido algunas formas cortas de las banderas. Aquí hay un
tabla de correspondencia:

┌──────┬──────────────┐
│ Corto │ Largo │
│ i │ in │
│ o │ out │
│ e │ equivocarse │
│ #n │ fdn │
│ v │ verboso │
│ 1 │ una vez │
│ q │ tranquilo │
│ u │ UNIX │
│ d │ demonio │
│ s │ de serie │
│ p │ puerto extranjero │
│ h │ host extranjero │
│ H │ localhost │
└──────┴──────────────┘
Por ejemplo, el siguiente comando

ejemplo $ faucet 3000 --out --verbose --once --foreignhost client echo blah

podría ser escrito

ejemplo $ faucet 3000 -ov1h cliente echo blah

El sistema -p, -hy -H las banderas toman un argumento, pero las banderas pueden agruparse en un solo argumento.
Luego toman los argumentos que necesitan de la línea de comando en el orden en que las banderas
Aparecer.

ejemplo $ faucet 3000 -hpHov1 cliente 2999 ejemplo-le2 echo blah

Considerando que cada --fd La bandera de palabra requería un descriptor individual, el -# bandera de personaje puede
tomar varios descriptores. Los siguientes son equivalentes:

ejemplo $ faucet 3000 --fd 0 --fd 1 --verbose --una vez echo blah
ejemplo $ faucet 3000 - # 0,1v --una vez echo blah
ejemplo $ faucet 3000 -v1 # 0,1 echo blah
ejemplo $ faucet 3000 - # 0,1v1 echo blah

Tenga en cuenta que debe prestar atención al utilizar el -# bandera de personaje y el -1 personaje
bandera en el mismo argumento. Además, recuerda el especial cierre(2) semántica de -in y
-fuera.

EJEMPLOS

Esto crea un socket TCP-IP en la máquina local vinculada al puerto 3000.

ejemplo $ faucet 3000 --out --verbose tar -cf -.

Cada vez que algún proceso (desde cualquier máquina) intenta conectarse al puerto 3000 en este
maquina el grifo programa será tenedor(2) un proceso y el niño ejecutivo(2) a

alquitrán -cf -.

El sistema --fuera opción significa que la salida del proceso hijo se habrá redirigido a
el nuevo enchufe recuperado por el aceptar(2) llamar. --verboso significa que el grifo imprimirá
información sobre cada nueva conexión.

Esto crea un socket de dominio UNIX en el directorio actual.

ejemplo $ faucet u-socket --out --err --once --unix csh -c \
"dd if = angio.pgm | funky.perl.script"

El sistema --fuera --errar opción significa que stdout y stderr serán redirigidos en el niño
proceso. los --una vez opción significa que el grifo no tenedor(2), pero ejecutivo(2) el
proceso para que solo el primer proceso pueda conectarse al enchufe en U antes del grifo
deja de estar disponible.

Este ejemplo escucha en un socket hasta que llega la primera conexión. Luego genera
una copia bidireccional que es similar a la manguera-esclava.

grifo 3000 -1v --fd 3 sh -c 'cat <& 3 & cat> & 3; calcetín 3 '

Use faucet en línea usando los servicios de onworks.net