Provided by: manpages-es-extra_0.8a-17_all bug

NOMBRE

       rpost - envía un artículo a un servidor de noticias NNTP

SINOPSIS

       rpost  [  nodo ] [ @archivo ] [ -s | -S archivo ] [ -e | -E archivo ] [
       -b archivo_batch ] [ -p prefijo ] [ -d ] [ -U usuario ] [ -P clave ]  [
       -M ] [ -N puerto ] [ -l archivo_de_frases ] [ -D ] [ -T tiempo_tope ] [
       -u ] [ -f programa_filtro $$o=<outfile> filter_arg1 ...  ]

DESCRIPTION

       Rpost enviará uno o más artículos al nodo especificado. En caso  de  no
       especificarse ninguno, rpost usará la variable de entorno NNTPSERVER.

Opciones generales

       -s|-S archivo

       Estas  opciones  enviarán  todos los mensajes de estado (que normamente
       van a la salida estándar) a un archivo alternativo. Cuando la opción es
       la  minúscula,  -s,  enviarán  los  mensajes  de  estado al archivo por
       defecto en definido en tiempo  de  compilación  en  suck_config.h.  Por
       defecto  se toma /dev/null, o sea: no se escribirán mensajes de estado.
       La mayúscula, -S, requiere un nombre de archivo. Todos los mensajes  de
       estado serán enviados a este archivo.

       -e|-E archivo

       Estas  opciones  enviarán  todos  los  mensajes  de  error (normalmente
       escritos en la salida de error estándar) a un archivo  alternativo.  La
       versión  en  minúscula, -e enviará los mensajes de error al archivo por
       defecto definido en tiempo de compilación en suck_config.h. Por defecto
       se  toma  suck.errlog. La mayúscula, -E, requiere un nombre de archivo.
       Todos los mensajes de error serán enviados a este archivo.

       -U usuario -P clave

       Estas dos opciones le permiten a Vd. especificar un usuario y una clave
       si su servidor de NNTP los solicita.

       -M

       Esta  opción  hace  que  rpost envíe un comando de "modo de lectura" al
       servidor remoto.  Si  Vd.  obtiene  un  mensaje  de   comando  inválido
       inmediatamente después del anuncio de bienvenida, pruebe esta opción.

       -N puerto

       Esta  opción  hace  que  rpost use un puerto NNRP alternativo cuando se
       conecta al nodo, en lugar del puerto 119, que es el  que  se  toma  por
       defecto.

       @archivo

       Esta  opción  hace  que  rpost lea otras opciones del archivo indicado,
       además de las de la línea de comando.

       -l archivo_de_frases

       Esta opción hace que rpost cargue un archivo de frases alternativas, en
       vez  de  usar  los  mensajes  imbuidos. Esto le permite a Vd. hacer que
       rpost muestre sus mensajes en otro idioma o  permite  personalizar  los
       mensajes  sin  tener  que  recompilar. Para más detalles vea "FRASES EN
       DIVERSOS LENGUAJES" en suck(1).

       -D Esta opción  hace  que  rpost  envíe  varios  mensajes  de  debug  a
       "debug.suck", para uso básicamente del programador.

       -T  Esta opción reemplaza el valor precompilado de TIMEOUT, tiempo tope
       de conexión. Es el tiempo que  rpost  está  esperando  datos  del  host
       remoto antes de sobrepasar el tope y abortarse.

       -u  Esta  opción  hace  que  rpost  envíe al servidor remoto un comando
       AUTHINFO USER nada más conectarse, en lugar de esperar la  petición  de
       autorización.  Deberá además usar las opciones -U y -P cuando use ésta.

MODO STDIN O DE ENTRADA ESTÁNDAR

       rpost

       rpost nodo

       rpost  lee  un  artículo  en su entrada estándar y lo envía al servidor
       NNTP. El artículo debe contener una cabecera con al  menos  dos  líneas
       llamadas  Newsgroups:  y  Subject: y un cuerpo (el artículo propiamente
       dicho).  La cabecera y el cuerpo deben estar separados por un  caracter
       de cambio de línea. Rpost no hace ningún cambio en el artículo.

       Rpost  usa el comando POST para enviar el artículo, tal y como haría un
       programa lector de noticias. Esto es práctico cuando se usa SLIP o  PPP
       pues  muchos  proveedores  de  servicios  de  internet no permiten otro
       método de enviar artículos (como nntpsend o innxmit).

MODO BATCH O POR LOTES

       rpost nodo

       -b  archivo_batch  -p  prefijo  -d   -f   filtro   $$o=<archivo_salida>
       arg1_filtro ...

       -b archivo_batch

       Una  lista  de  los  artículos  a enviar. Este parámentro es NECESARIO.
       Este archivo contiene una línea por cada artículo, siendo cada  una  de
       ellas  el  camino+nombre  del  archivo  que  contiene al artículo.  Por
       ejemplo:

              -b /usr/spool/news/out.going/pixi

       Si hay problemas al enviar el artículo se creará un archivo de  fallos.
       Se  llamará "archivo_batch".fail y contendrá la línea del archivo_batch
       de cada uno de los artículos que no sean enviados  correctamente.  Este
       archivo puede ser usado para volver a enviar los mensajes usando rpost.
       NOTA: los mensajes duplicados  no  son  considerados  como  erróneos  a
       efectos de ser incluidos en el archivo "fail".

       -d

       Si  se  envían  los artículos correctamente, esta opción hace que rpost
       borre el archivo especificado con la opción -b.

       -p prefijo

       Este parámetro debe ser especificado si el archivo_batch contiene  sólo
       una  parte  del camnino de los artículos, en lugar del camino completo.
       Esto es útil cuando archivo batch es generado por  otro  programa.  Por
       ejemplo,  Inn  lista  los  artículos  en  su  directorio out.going pero
       relativos a su directorio base:  /var/spool/news.  En  ese  caso  basta
       usar:

               -p /var/spool/news

       -f filtro $$o=<archivo_salida> arg1_filtro arg2_filtro ...

       En  muchos  casos,  cada  artículo  debe ser maquillado antes de que el
       servidor NNTP remoto lo acepte. Esta opción le permite hacerlo. Observe
       que  la  opción -f ... debe ser la ULTIMA opción puesto que todo lo que
       le sigue es pasado al filtro, excepto lo señalado más abajo.  Hay  tres
       parámetro necesarios:

       $$o=<archivo_salida>     -  <archivo_salida>  es el nombre del artículo
       generado por el filtro y que será enviado al servidor NNTP  remoto.  NO
       se  pasa  al  programa  de  filtro. Puede ser especificado en cualquier
       lugar de la línea DESPUÉS del argumento -f, bien antes  o  después  del
       nombre del filtro.

       filtro  -  nombre  del  programa a ejecutar. Cualquier cosa que siga al
       filtro, EXCEPTO $$o, será pasado como argumento al filtro.

       arg1 -  El  primer  argumento  a  su  programa/script  de  filtro.  Muy
       posiblemente  sea $$i, el cual será reemplazado por rpost con el nombre
       del artículo que va a ser filtrado.

       arg2 ... - cualesquiera argumentos adicionales que sean necesarios.

       Un ejemplo para clarificar esto un poco. A algunos servidores  NNTP  no
       les  gusta  recibir  artículos con el campo  NNTP-Posting-Host relleno.
       Cree un pequeno script para borrar esto del artículo:


       -miscript--------------------------------------------
       #!/bin/sh

       sed -e "/^NNTP-Posting-Host/d" $1 > $2


       -end miscript----------------------------------------
       Y ejecute rpost con algo como esto:
              rpost    -b    /usr/spool/news/out.going/pixi    -f     miscript
              \$\$o=/tmp/MSG_FILTRADO \$\$i /tmp/MSG_FILTRADO

       Entonces, antes de que cada artículo sea enviado, se llamará a miscript
       de este modo:

              miscript archivo_con_mensaje /tmp/MSG_FILTRADO

       Tras la finalización de miscript, rpost envía  al  servidor  remoto  el
       artículo guardado en /tmp/MSG_FILTRADO

NOTA:

       $$o  y $$i tienen que ir precedidos por símbolos de escape, como pueden
       ser barras de división invertidas o bien entre  comillas  simples  para
       evitar  que  la shell los interprete como variables y los expanda. ¡ Si
       no se tiene esa precaución puede ocurrir que rpost no envíe mensajes !

PRECAUCIÓN:

       Tenga mucho cuidado con lo que el filtro borra del artículo. Borrar una
       línea  equivocada  puede  tener  efectos  perniciosos  más  tarde.  Por
       ejemplo, no borre la línea NSG-ID, pues en ese caso puede  ocurrir  que
       un   mismo   mensaje  sea  enviado  varias  veces,  dependiendo  de  la
       configuración de los servidores local y remoto.

ARCHIVO DE ARGUMENTOS DE RPOST

       Si Vd. especifica un @archivo en la línea de comando, rpost  leerá  ese
       archivo  y  buscará  en él argumentos que serán pasados a rpost.  Puede
       especificar los mismos argumentos que  en  la  línea  de  comando.  Los
       argumentos  pueden  aparecer en la misma línea o distribuidos en varias
       líneas. Puede incluir comentarios. Los comentarios empiezan por  '#'  y
       continúan  hasta  el  final  de la línea. Los argumentos de la línea de
       comando prevalecen sobre los  del  archivo.  Una  ventaja  de  usar  un
       archivo  de  parámetros  en  lugar de la línea de comandos es que no es
       necesario incluir símbolos de escape para prevenir la expansión de  los
       caracteres especiales como $.

              # Ejemplo de archivo de argumentos
              -b batch # opción de archivar en un lote  batch
              -M   # usar el modo de lectura

VALORES DEVUELTOS

       Rpost devuelve los siguientes valores:

              0 = finalizó con éxito
              1 = error enviando un artículo
              2  = imposible llevar a cabo un proceso de autorización NNTP con
              servidor remoto
              3 = respuesta inesperada en el curso de una autorización NNTP.
              -1 = otro error fatal.

VÉASE TAMBIÉN

       suck(1), testhost(1), lpost(1).

                                                                      RPOST(1)