gup - Online en la nube

PROGRAMA:

NOMBRE

gup - A Grupo Update Pprograma que acepta comandos por correo para editar un grupo de noticias
archivo de suscripción para uso posterior por sistemas de noticias como INDNR y C-Noticias.

SINTAXIS

chisme [-hvP] -un ruta_activa [-d directorio_inicio] [-l ruta_log]
[-m Reply_headers] [-n ruta_gruposdenoticias]
[-s site_directory] [-M Correo_comando]

DESCRIPCIÓN

El único propósito de chisme es automatizar el tedioso proceso de editar la selección de grupos
patrones definidos en los archivos de configuración de noticias (por ejemplo: `` newsfeeds '' para INDNR y `` sys ''
para C-Noticias).

Chisme es útil para los administradores de noticias que dedican una cantidad excesiva de tiempo a editar sus
archivos de configuración de noticias a instancias de los sitios que alimentan. De hecho, una vez chisme esta instalado,
Es muy probable que las ediciones manuales de su archivo `` newsfeeds '' o `` sys '' se conviertan en
cosa del pasado.

Chisme está diseñado para ser instalado como un programa de servidor de correo que se alimenta con un correo entrante a través de
entrada estándar Chisme generalmente se invoca desde un archivo .forward. P.ej:

"| /.../ bin / gup -options ...."

Cada sitio tiene una entrada en el archivo `` config '' que contiene los detalles de la contraseña y la dirección de correo
y un archivo de selección de grupo llamado `` grupos '', consulte CONFIG y GRUPOS para más detalles.

El administrador de noticias de cada sitio envía comandos a chisme. Hay comandos para incluir
y excluir patrones de grupo, enumerar los patrones actuales para ese sitio y enumerar los disponibles
grupos de noticias; ver COMANDOS, para más detalles.

Los resultados normalmente se envían por correo al administrador configurado del sitio. Sin embargo
En algunas circunstancias, los resultados se envían por correo al creador o al local.
administrador; ver Tratamiento, para mas detalles.

Chisme no cambia directamente los archivos de control del sistema de noticias (por ejemplo, `` newsfeeds '' para INN).
En su lugar, se debe ejecutar un script de shell trivial para concatenar todos los `` grupos '' modificados
archivos juntos en un archivo con el formato adecuado para su sistema de noticias particular. (Uno
se proporciona en el kit de fuentes para INN).

Dado que cada sitio debe configurarse específicamente en chisme's archivo `` config' ', el acceso puede ser
restringido a administradores capaces de gestionar sus propios patrones de grupo.

OPCIONES

Las opciones pueden aparecer en cualquier orden en la línea de comando. El punto más importante a tener en cuenta es
que todas las rutas y directorios definidos normalmente serán rutas absolutas a menos que
están íntimamente familiarizados con la forma en que chisme cambia de directorio a medida que procesa un
mail (la posible excepción aquí es el directorio_de_sitios).

-a ruta_activa
La ruta del archivo activo para su sistema de noticias. Antes de aceptar cualquier grupo de noticias
identificado en un comando, chisme valida el grupo contra el archivo activo. los
El comando se rechaza si no se encuentra ninguna coincidencia.

-d directorio_inicio
Define chismedirectorio de inicio de. Chisme cambios en este directorio lo antes posible
después de la puesta en marcha. Si esta opción no está presente, se utiliza el directorio actual.
Chisme busca el archivo `` config '' en su directorio de inicio.

-h Imprima un mensaje de ayuda que muestre las opciones de la línea de comando, luego salga.

-l ruta_log
En este archivo se escribe un registro de todas las solicitudes importantes. Si el camino es
relativo, entonces será relativo a chismedirectorio de inicio de; ver la opción -d).
Chisme debe poder escribir en este archivo. Si el -l la opción no se usa, entonces chisme
usa stderr. Esto es útil para propósitos de prueba, pero es poco probable que lo sea en un
archivo .forward.

-m Reply_headers
¿Cuándo? chisme genera una respuesta de correo, solo genera la línea de encabezado `` Para: ''.
Esta opción define la ruta de un archivo que contiene otro encabezado conforme a RFC882
líneas que se canalizan al programa de correo (consulte la opción -M). De hecho, si esto
El archivo contiene un cuerpo que sigue a los encabezados, que precederá a cualquier texto.
generado por chisme. Si esta ruta no es una ruta absoluta, se tratará como
relativo a chismedirectorio de inicio de (ver la opción -d).

-M Correo_comando
Chisme canaliza los encabezados rfc822 y el cuerpo del correo al correo designado
programa. Normalmente, esto se configura cuando chisme está instalado, pero puede
montado con esta opción. El comando de correo debe poder determinar el destinatario
direcciones de los encabezados rfc822.

-n ruta_gruposdenoticias
Si está presente, el archivo de grupos de noticias se utiliza para intentar encontrar una descripción coincidente de
grupo de noticias cuando aparece en la lista.

-P Do no sea Elimine los patrones superfluos del archivo de `` grupos '' de un sitio. Antes de escribir el
archivo actualizado de `` grupos '', chisme aplica una prueba bastante rigurosa a los patrones,
podando cualquier patrón sin sentido o innecesario. Este proceso de poda puede resultar bastante
CP intensivo en la medida en que pueda tener un efecto perjudicial en su sistema -
de ahí la posibilidad de desactivarlo.

-s directorio_sitios
Los archivos de `` grupos '' y de `` exclusión '' de cada sitio se encuentran en un directorio único para
cada sitio. Estos directorios del sitio se encuentran en el directorio definido con este
opción. Si esto se da como una ruta relativa, será relativo a chismeen casa
directorio (ver la opción -d). Chisme intentará crear este directorio si lo hace
no existe.

-v Imprima el número de versión y varias variables de tiempo de compilación, luego salga.

COMANDOS

Chisme escanea el cuerpo del correo en busca de comandos. Las líneas en blanco se ignoran y cualquier dato posterior
el carácter `` # '' se considera un comentario. No se permite la continuación. Mucho de
Los comandos aceptan un patrón como parámetro. Este patrón es idéntico al formato del
patrón wildmat (); ver salvaje (3) ). De hecho, Chisme utiliza a propósito el salvaje rutina
de INN para garantizar que las características de coincidencia de patrones sean idénticas.

Los comandos válidos son:

site nombre del sitio la contraseña
Este deben sea ​​el primer comando en el correo. nombre del sitio y la contraseña debe coincidir con un
entrada en el archivo `` config ''. Sólo uno site Se permite el comando por correo. Alias:
"abrir" y "alojar".

renuncia Este comando se detiene chisme de procesar el resto del correo. Esto es útil si su
Mail User Agent tiende a agregar automáticamente un archivo de firma a su correo. Alias:
"q".

incluir patrón
El patrón se compara con el archivo activo. Si coincide con al menos uno
grupo de noticias, el patrón se coloca al final del archivo de `` grupo '' del sitio como un
incluir entrada. Sólo uno patrón per incluir Se permite el comando. Si el patrón
coincide con cualquier cosa en la lista de exclusión del sitio (consulte EXCLUSIONES) entonces el incluir
fallará. Alias: "+" e "inc".

excluir patrón
El patrón se compara con el archivo activo. Si coincide con al menos uno
grupo de noticias, el patrón se coloca al final del archivo de `` grupo '' del sitio como un
excluir entrada. Sólo uno patrón per excluir Se permite el comando. Alias: "-" y
"Exc ª".

tóxico patrón
Si patrón coincide con al menos un grupo de noticias con publicaciones cruzadas, el artículo no será
aceptado incluso si lo permite un incluir declaración. Sólo uno patrón per tóxico
Se permite el comando.

ayuda Genere un pequeño mensaje de ayuda que describa brevemente cada comando. Hay un
implícitamente salir con el comando de ayuda, por lo que no tiene sentido colocar comandos después
el comando de ayuda. Alias: "h".

lista enumerar todos los actuales incluir y excluir patrones en el archivo de `` grupos '' de sitios.
La salida está en un formato adecuado para retroalimentar chisme en una etapa posterior si
necesita ser. Alias: "l".

elimínelo patrón
Eliminar todos incluir, excluir y tóxico patrones en el archivo de `` grupos '' del sitio que
coincidir con el patrón. `` eliminar * '' es una forma eficaz de borrar todos los
.

grupos de noticias patrón
Este comando enumera todos los grupos de noticias disponibles del archivo activo que coinciden
patrón. La lista incluye la descripción del archivo de grupos de noticias, así como una
indica si el sitio está actualmente suscrito a ese grupo. Sólo uno patrón per
grupos de noticias Se permite el comando. Alias: "noticias".

Tratamiento

Chisme tiene varias etapas de procesamiento. La etapa de inicialización consiste en cambiar a
el directorio de inicio (ver la opción -d) y abrir el archivo de registro (ver la opción -l). A
esta vez, chisme establece la dirección de correo de respuesta tentativa a la dirección de correo electrónico `` backstop ''
definido cuando chisme se compiló (normalmente el administrador de noticias local).

La siguiente etapa consiste en escanear el correo entrante, observando interesante encabezados de correo. los
los más interesantes son "Para:" y "Responder a:". Cuando se encuentra un encabezado "Para:", se convierte en
la dirección de correo de respuesta provisional. Si se encuentra un encabezado "Responder a:", anula cualquier
Dirección "Para:" para que se convierta en la nueva dirección de correo de respuesta provisional. Se señalan algunos otros
y registrado para ayudar a realizar un seguimiento de los cambios.

Una vez procesados ​​todos los encabezados, se examina el cuerpo del correo en busca de comandos.
El primer comando deben ser la site mando. Cualquier otro dato da como resultado un correo de error enviado
a la dirección de correo de respuesta tentativa. Si el site El comando contiene un nombre que coincide
una entrada en el archivo `` config '', luego la dirección de correo de respuesta tentativa se reemplaza con
la dirección de correo en el archivo `` config ''.

La razón de estas contorsiones con las direcciones de correo de respuesta tentativas es simplemente para tratar
con el problema de averiguar a quién enviar un correo en caso de error. Idealmente
todos deberían volver a la dirección de correo en el archivo `` config '', pero esa información
no se conoce en una parte bastante significativa de chismeprocesamiento inicial.

Una vez válido site el comando ha sido aceptado, chisme cambios en el directorio de ese sitio en
Sites_directory (consulte la opción -s) haciendo que Sites_directory y el directorio del sitio sean
necesario. El nombre del directorio del sitio es el mismo que el del sitio. En ausencia del
-s opción esta será:

$ HOME / sitios / $ sitio

Donde está $ HOME chisme's home directory y $ site es el nombre del sitio que se está procesando.
Chisme bloquea el sitio y luego carga el archivo de `` grupos '' actual del sitio y cualquier lista de exclusión si
presente (ver EXCLUSIONES para más detalles).

A partir de ahora chisme acepta cualquier comando en cualquier orden hasta el final del correo,
un comando de salida, un comando de ayuda o un error grave durante el procesamiento. Después de todos los comandos
han sido procesados, chisme update es el archivo de `` grupos '' del sitio si se han realizado cambios.
Esta actualización incluye la poda de cualquier patrón superfluo (a menos que se use la opción -P). Chisme
escribe los nuevos patrones en `` groups.new ''. Luego cambia el nombre de `` grupos '' a `` group.old '' y
finalmente cambia el nombre de `` grupos.nuevo '' a `` grupos ''. El resultado de todo este procesamiento se envía por correo
al administrador del sitio definido en el archivo `` config ''.

CONFIG

Acceso a chisme está controlado por el archivo `` config '' en chismedirectorio de inicio de (ver el -d
opción). Este archivo contiene una línea por sitio. Cada línea contiene tres espacios en blanco
fichas separadas. El nombre del sitio, la contraseña y la dirección de correo electrónico del administrador. Blanco
Se permiten líneas y los comentarios siguen al carácter `` # ''. Chisme usa un muy simple
tokenizer, por lo que no se permite citar o continuar en este archivo.

El nombre del sitio y la contraseña se utilizan para verificar una entrada site mando. La contraseña puede ser
encriptado o en Texto sin formato por lo que los permisos deben configurarse cuidadosamente para restringir el acceso. Aquí está
un ejemplo de un archivo `` config ''.

werple Fert5566a __ $ 1 [email protected]
torps 34fkr _ && 11) Zz [email protected]
uunet R_S_1 @@ * (A- \ [email protected]
.prueba de aleta marcada

Con suerte, esto es intuitivamente obvio ...

GRUPOS

Cada sitio tiene su propio archivo de patrones. Este archivo se llama `` grupos '' y se encuentra en
el propio directorio del sitio debajo de Sites_directory (consulte la opción -s). Este archivo
contiene un patrón por línea. Las listas de exclusión tienen un carácter ``! '' Precedente. Aquí hay un
ejemplo:

apana. *
! apana.lists. *
! apana.fido. *
! apana.vortex. *
alt.bbs.waffle
alt.peliculas-de-culto
alt.galáctica-guía
bolos.alt.sport
aus. *
! aus.ai
! aus.religion
! aus.radio
! aus.stats.s
...

Normalmente, este archivo solo debe cambiarse por chisme, pero suponiendo que se encargue del bloqueo,
no hay ninguna razón por la que algún otro proceso no pueda cambiarlo también. Cuando sea chisme tiene que aplicar
cambios, cambia el nombre de este archivo a `` groups.old '' antes de volver a escribir el archivo de `` grupos ''.
Esto le da cierta medida de recuperación.

EXCLUSIONES

Por el motivo que sea, es posible que desee excluir grupos particulares de la selección de un sitio.
lista. Puede hacer esto creando el archivo `` excluir '' en el directorio del sitio. Este archivo
contiene patrones de grupos de noticias, uno por línea, que se utilizan para filtrar el archivo `` activo ''
al verificar patrones de grupo. El efecto de esto es que chisme cree que tales grupos no
no existen realmente, por lo tanto, un sitio no puede incluirlos.

La diagnostica

Todas las condiciones de error se registran en el archivo de registro y posiblemente el correo resultante:
dependiendo de la naturaleza del error. Un problema particular que es difícil de detectar es cuándo
el archivo .forward invoca chisme incorrectamente. Si chisme no se invoca debido a tal error,
entonces la notificación depende del remitente. Esto solo debería ser un problema a tener en cuenta
al instalar por primera vez chisme.

RESTRICCIONES

Chisme no comprende los `` Patrones de distribución ''. Cualquiera de estos patrones debe generarse y
mantenido independientemente de chisme.

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