NeoStats 2.5.0
~~~~~~~~~~~~~~~
-----------------------------------------
POR FAVOR LEIA O FICHEIRO 'BETA' PRIMEIRO
-----------------------------------------
Obrigado por ter feito o download do NeoStats. O NeoStats é um poderoso e extensível
conjunto de serviços para o IRC. Com 'serviços' não queremos dizer NickServ/ChanServ/etc
(apesar destes estarem a ser desenvolvidos), mas serviços adicionais. Serviços como o
StatServ, os quais lhe dão informação do número de utilizadores/operadores/canais/servidores...
basicamente estatísticas de IRC, ou o MoraleServ, que é um serviço de lazer, para enviar
mensagens engraçadas para utilizadores, para módulos utilitários. Alguns módulos têm uma função
útil na sua rede, outros módulos foram desenvolvidos para lazer, e para tornar a sua rede de IRC
mais atractiva para os utilizadores (é disso que tudo isto se trata certo? utilizadores de IRC?)
Com a série 2.5 do NeoStats, várias mudanças ocorreram, comparativamente à versão antiga da série
NeoStats 2.0 (não me pergunte o que aconteceu às versões 2.1, 2.2, 2.3 ou 2.4, porque eu não sei!)
Uma lista detalhada de mudanças pode ser encontrada no ficheiro ChangeLog, mas um breve sumário é:
-Suporte para ServiceRoots
-Ficheiros MOTD externos
-Protecção contra Segfault de módulos
-Suporte para CrossIRCD. Agora suportamos outros IRCD's para além do Unreal.
-O StatServ suporta a exportação das estatísticas para um ficheiro HTML (a exportação do
ficheiro HTML é baseado num molde)
-Mudanças no ModuleAPI que o tornam mais eficiente
-Suporte para canais!
-O StatServ suporta agora estatísticas de canais!
-Muitos bugfixes e mudanças no núcleo interno do NeoStats
-Muitas actualizações nos diversos módulos
Bem, chega de detalhes, é hora de proseguir....
Tabela de Conteúdos:
[1] Instalação
[1.1] Iniciando.
[1.2] Correndo o configure
[1.3] Compilando o NeoStats
[1.4] Instalando o NeoStats
[1.5] Configurando o ficheiro neostats.cfg
[1.6] Fim!
[2] Ajuda ao Bot NeoStats
[2.1] Opções do neostats.cfg
[2.2] Comandos disponíveis
[2.3] INFO
[2.4] VERSION
[2.5] LEVEL
[2.6] SHUTDOWN
[2.7] RELOAD
[2.8] LOGS
[2.9] LOAD
[2.10] UNLOAD
[2.11] MODLIST
[2.12] JUPE
[2.13] RAW
[3] Ajuda ao Bot StatServ
[2.1] Opções do neostats.cfg
[2.2] Comandos disponíveis
[2.3] SERVER
[2.4] MAP
[2.5] NETSTATS
[2.6] DAILY
[2.7] TLD
[2.8] TLDMAP
[2.9] OPERLIST
[2.10] BOTLIST
[2.11] VERSION
[2.12] FORCEHTML
[2.13] RESET
[2.14] STATS
[2.15] A sintaxe HTML
[4] Informação de suporte
[4.1] Como conseguir suporte
[4.2] Que informação deverá ter disponível para receber suporte
[1] Instalação:
-------------
[1.1] Iniciando.
Primeiro, vai querer descomprimir o NeoStats, para o fazer, escreva o seguinte:
tar xvfz NeoStats2.0.tar.gz (is pode variar conforme a versão do NeoStats que vai correr
mude NeoStats2.0.tar.gz para o nome do ficheiro em questão)
** Nota: Em alguns sistemas que não tenham a nova versão do 'tar' a correr poderá necessitar de fazer o seguinte:
gzip -d NeoStats2.0.tar.gz
tar xvf NeoStats2.0.tar
[1.2] Correndo o configure
O script de configuração foi alterado comparativamente ao antigo 2.0.x
e terá que se cerificar que apresenta os argumentos correctos para configurar.
O que é necessário:
-----------------
Supporte para IRCD:
Para especificar o IRCD para o qual está a compilar. Por exemplo:
--enable-unreal para UnrealIRCD
--enable-ultimate2 para as séries UltimateIRCD 2.x.x
--enable-ultimate3 para as séries UltimateIRCD 3.x.x (Nota: na data de lançamento desta versão do NeoStats, o Ultimate 3.x.x estava ainda em versão alpha, é possível que a compatibilidade com o Ultimate3 possa ser quebrada em futuros lançamentos do Ultimate aquando do seu desenvolvimento)
O que é opcional:
-----------------
Sistema de previlégios:
Originalmente, o NeoStats era baseado em flags de Operador numa rede.
Se fosse TechAdmin no Unreal, era-lhe dado praticamente controlo total do
Neostats. Mas agora você pode activar a chamada autenticação externa.
Isto permite diferentes modos do sistema de previlégio do NeoStats.
As opções de momento disponíveis são:
--enable-auth=sr Isto activa a opção ServiceRoots, na qual o utilizador necessita de estar identificado aos serviços (com a flag +r) e terá controlo total do NeoStats.
se não especificar --enable-auth então ele usará as flags do IRCD para aceder ao NeoStats.
A predefinição é IRCD Isto regride ao antigo sistema de previlégio do antigo NeoStats, onde a autenticação é baseada nas flags do utilizador (+oOANs etc etc)
Suporte de módulos:
O NeoStats tem um expansível conjunto de módulos. Alguns módulos têm as suas próprias opções --enable enquanto que outros módulos não.
Para activar um módulo na compilação (ou múltiplos módulos) use a seguinte opção:
--enable-modules="statserv spam" isto iria activar os módulos StatServ e Spam.
A predefinição é sem módulos. O NeoStats vem com os módulos StatServ e Spam (assim como a versão module, a qual é de facto um módulo inútil. É um exemplo do API para os programadores de módulos usarem).
Se fez o download de módulos adicionais do website do NeoStats, NÃO os especifique na opção enable-modules. Cada módulo tem o seu próprio script de configuração, e tem que ser configurado e instalado após o NeoStats estar instalado.
Modo debugging:
A maior parte dos utilizadores nunca irão necessitar desta opção. Ela compila o NeoStats
com o modo debugging activado. Eu apenas sugeriria utilizar isto se tiver problemas e estiver
disposto a preencher um formulário de erros.
--enable-debug Activa modo debugging.
[1.3] Compilando o NeoStats
Ok, agora deverá estar de volta à prompt da shell. Agora escreva:
make
ele irá através do código fonte e compilá-lo num ficheiro binário executável.
Se obtiver avisos (warnings), ignore-os -- nós estamos a tratar deles.
[1.4] Instalando o NeoStats
Com a versão 2.5.0 e superior, o NeoStats precisa agora de ser "instalado" no seu próprio directório se desejar usar módulos adicionais.
O NeoStats irá instalar como predefinição, dentro de ~/NeoStats/ (no seu directório principal, ex: /home/fish/NeoStats/)
Se desejar mudar o directório de instalação, por favor veja a secção 2.
Para instalar o NeoStats escreva:
make install
Isto irá criar os ficheiros necessários, e copiá-los-á para o directório de instalação.
[1.5] Configurando o ficheiro neostats.cfg
Agora deverá mudar para o directório de instalação (~/NeoStats/ ou o que especificou no ./configure)
Uma vez neste directório, necessitará de editar o ficheiro de configuração. Um molde é fornecido,
neostats.cfg.dist mude o nome deste ficheiro para neostats.cfg e edite-o. Todas as opções estão
explicadas de forma suficientemente clara. Se tiver alguma pergunta, esteja à vontade para ma
perguntar.. Uma vez terminada a edição do ficheiro, pressionel CTRL + X
NOTA: alguns módulos adicionais, como o StatServ ou o ScriptServ têm opções de configuração adicionais
que têm que ser especificadas no ficheiro stats.cfg. Por favor veja a documentação para cada um dos
módulos individuais relativamente a opções de configuração.
As opções disponíveis são:
SERVER_NAME - Especifica o nome do servidor do NeoStats como aparecerá na rede.
eg: SERVER_NAME stats.neostats.net - Quando o servidor se ligar, ele irá aparecer como stats.neostats.net.
SERVER_PORT - Especifica a porta a ligar no servidor IRC.
eg: SERVER_PORT 6667 - Aquando da ligação, o NeoStats irá-se ligar à porta 6667.
CONNECT_TO - Especifica o endereço IP a ligar.
eg: CONNECT_TO 127.0.0.1 - Isto irá forçar o NeoStats a ligar-se ao IP 127.0.0.1
CONNECT_PASS - Especifica a password para a ligação. Isto terá que estar de acordo com as C/N-lines na configuração do seu IRCD.
eg: CONNECT_PASS linkpass - Usará "linkpass" como password de ligação.
SERVER_INFOLINE - Especifica a descrição do servidor quando um utilizador faz uso do comando /links
eg: SERVER_INFOLINE Serviços Auxiliares de Rede
SERVICES_CHAN - Especifica o canal ao qual os bots do NeoStats irão entrar automaticamente, e fornecer qualquer informação importante.
eg: SERVICES_CHAN #services - Força o NeoStats e todos os outros bots a entrarem no canal #services aquando do seu arranque
WANT_PRIVMSG - Especifica o modo de envio de mensagens dos bots: mensagens privadas ou notices (a maioria dos serviços usam notices)
eg: WANT_PRIVMSG - Se presente, irá enviar todas as mensagens como mensagens privadas (se comentado, irá enviar notices)
RECONNECT_TIME - Se o servidor do NeoStats sofrer um netsplit da rede, qual o tempo de espera para ele se tentar reconectar
eg RECONNECT_TIME 10 - O NeoStats esperará 10 segundos antes de se tentar reconectar
LOAD_MODULE - Qual o módulo a carregar no arranque. Múltiplas linhas de LOAD_MODULE podem ser especificadas
eg LOAD_MODULE statserv - Irá carregar StatServ no arranque.
Se activou o módulo de autenticação ServiceRoots, as seguintes opções adicionais de configuração estão disponíveis:
SERVICE_ROOTS - Quem deverá ter acesso ao NeoStats independentemente das flags da sua o-line (excepto ter o user mode +r, que significa que eles estão identificados ao NickServ). Poderá repetir esta opção até 10 vezes, para especificar nicks diferentes.
eg SERVICE_ROOTS fish - Irá dar acesso ao utilizador "fish" aos comandos previlegiados do NeoStats, se o utilizador tiver o user mode +r
SERVICE_ROOTS_AUTH - Deverá ser dado acesso aos comandos previlegiados do NeoStats aos nicks listados na opção SERVICE_ROOTS e ignorar as flags da o-line ?
eg: SERVICE_ROOTS_AUTH 1 -Activar e permitir o acesso do utilizador "fish" ao NeoStats, independentemente das flags da sua o-line
[1.6] Fim!
Ok, está feito.
** Nota: Verifique se o(s) seu(s) servidor(es) têm u-lines para o servidor de estatísticas.
** Por favor, por favor, por favor! Lembre-se de adicionar as C/N-lines correctas no
seu servidor!
Uma vez as C/N e u-lines configuradas, necessitará de iniciar o NeoStats. Tão simples quanto escrever
./neostats
Se algo correr mal, *talvez* haja uma mensagem de erro nos ficheiros de log. Dê uma vista de olhos em ~/NeoStats/logs/stats.log este ficheiro poderá dar-lhe uma pista do que possa estar errado!
** ORBSERVAÇÃO FINAL ** ** OBSERVAÇÃO FINAL ** ** OBSERVAÇÃO FINAL **
EU NÃO O IREI AJUDAR A ADICIONAR AS C/N E U-LINES AO SEU SERVIDOR,
VOCÊ DEVERÁ LER A DOCUMENTAÇÃO DO SEU IRCD SE NÃO SABE COMO O FAZER!!!
[2] Ajuda ao Bot NeoStats
[2.1] Opções do neostats.cfg
As opções seguintes estão disponíveis para o bot NeoStats no neostats.cfg:
NEOSTATS_HOST - Especifica a hostname que o NeoStats aparenta ter
eg: NEOSTATS_HOST stats.neostats.net - Significa que o bot irá ter a host: NeoStats!user@stats.neostats.net
NEOSTATS_USER - Especifica a identd do bot NeoStats
eg: NEOSTATS_USER neo - Significa que o bot irá ter a host: NeoStats!neo@stats.neostats.net
[2.2] Comandos Disponíveis
Disponíveis para todos, independentemente dos níveis de acesso.
INFO -Mostra informações básicas acerca do NeoStats e o seu uptime
VERSION -Mostra a versão do NeoStats
LEVEL -Mostra o seu nível de permissão relativamente ao NeoStats. 0 é o mínimo, 200 é o máximo.
Disponível para ServiceRoots (nível 180 ou superior)
SHUTDOWN -Permite terminar o NeoStats
RELOAD -Reinicia o NeoStats. Termina todos os módulos, disconecta-se e reconecta-se
LOGS -Mostra o ficheiro de log do NeoStats (~/NeoStats/logs/stats.log)
LOAD -Carrega um módulo
UNLOAD -Termina um módulo
MODLIST -Lista os módulos carregados
JUPE -Faz 'Jupiter' a um servidor
RAW -Envia comandos 'raw' a partir do NeoStats
Outros comandos estão disponíveis, mas são úteis apenas para debugging, use o código fonte, para os encontrar!
[2.3] O comando INFO
/msg neostats info
Devolve:
=NeoStats= Statistics Information:
=NeoStats= Statistics up 1 minute, 48 seconds
=NeoStats= Sent 49 Messages Totaling 2526 Bytes
=NeoStats= Recieved 69 Messages, Totaling 1887 Bytes
=NeoStats= Reconnect Time: 10
=NeoStats= Statistic Requests: 4
=NeoStats= Use SMO for Debug?: Disabled
=NeoStats= Debugging Mode is Disabled!
=NeoStats= End of Information.
[2.4] O comando VERSION
/msg neostats version
Devolve:
=NeoStats= NeoStats Version Information
=NeoStats= NeoStats Version: NeoStats-2.5_Beta1
=NeoStats= http://www.neostats.net
[2.5] O comando LEVEL
/msg neostats level
Devolve:
=NeoStats= Your Level is 185
[2.6] O comando SHUTDOWN
/msg neostats shutdown para upgrade
Devolve:
=Server.IRC.net= *** Global -- from stats.dynam.ac: StatServ Module Unloaded
=Server.IRC.net= *** Global -- from NeoStats: Fish requested SHUTDOWN for for upgrade
=Server.IRC.net= *** LocOps -- Received SQUIT stats.dynam.ac from stats.dynam.ac[127.0.0.1] (stats.dynam.ac)
[2.7] O comando RELOAD
/msg neostats reload estás com lag
Devolve:
=Server.IRC.net= *** Global -- from NeoStats: Fish requested RELOAD for your lagged out
=Server.IRC.net= *** Global -- from stats.dynam.ac: StatServ Module Unloaded
=Server.IRC.net= *** LocOps -- Received SQUIT stats.dynam.ac from stats.dynam.ac[127.0.0.1] (stats.dynam.ac)
=Server.IRC.net= *** Notice -- (link) Link Server.IRC.net -> stats.dynam.ac[@127.0.0.1.54872] established
=Server.IRC.net= *** Notice -- Link stats.dynam.ac -> Server.IRC.net is now synced [secs: 0 recv: 0.1015 sent: 1.431]
=Server.IRC.net= *** Global -- from stats.dynam.ac: Link with Network Complete!
[2.8] O comando LOG
/msg neostats logs
Devolve:
=NeoStats= (11:02[03/21/2002]) RemoveLock() called: We must be segging!
=NeoStats= (11:02[03/21/2002]) Statistics Started (NeoStats-2.5_Alpha6).
=NeoStats= (11:02[03/21/2002]) New Server: stats.dynam.ac
=NeoStats= (11:02[03/21/2002]) Connecting to 127.0.0.1:6001
=NeoStats= (11:02[03/21/2002]) Sendings pings...
(etc)
[2.9] O comando LOAD
/msg neostats load <módulo>
Devolve:
*** StatServ (Neo@NeoStats.net) has joined #services
*** Mode change [+oa StatServ StatServ] on #services by stats.dynam.ac
=NeoStats= Module statserv Loaded, Description: Statistical Bot For NeoStats
<NeoStats> Fish Loaded Module statserv
[2.10] O comando UNLOAD
/msg neostats unload <módulo>
Devolve:
<NeoStats> Unloading Module statserv
<NeoStats> Module statserv has timer DelOldStatServChans Registered. Deleting..
<NeoStats> Module statserv has timer Save_Stats_DB Registered. Deleting..
<NeoStats> Module statserv has timer Daily_Stats_Reset Registered. Deleting..
<NeoStats> Module statserv has timer TimerWeb Registered. Deleting..
<NeoStats> Module statserv had bot StatServ Registered. Deleting..
*** StatServ (Neo@NeoStats.net) has left IRC [Module Unloaded]
<NeoStats> Fish Unloaded Module statserv
[2.11] O comando MODLIST
/msg neostats modlist
Devolve:
=NeoStats= Module: statserv (3.1)
=NeoStats= Module Description: Statistical Bot For NeoStats
=NeoStats= End of Module List
[2.12] O comando JUPE
/msg neostats jupe blah.com
Devolve:
<NeoStats> Fish Wants to JUPE this Server blah.com
[2.13] O comando RAW
/msg neostats raw <comando raw>
Returns:
<NeoStats> RAW COMMAND Fish Issued a Raw Command!(:neostats invite fish #blah)
*** NeoStats (Neo@NeoStats.net) invites you to #blah
[3] Ajuda ao Bot StatServ
[3.1] Opções do neostats.cfg
STATSERV_NICK -Define o nickname do bot StarServ. Se não for especificado, o default é StatServ.
eg: STATSERV_NICK stats -Define o nickname do bot StatServ como 'stats'
STATSERV_USER -Define a identd do bot StatServ
eg: STATSERV_USER stats -Define a identd to bot StatServ para stats
STATSERV_HOST -Define a hostname do bot StatServ
eg: STATSERV_HOST stats.microsoft.com -Define a hostname do bot StatServ para stats.microsoft.com
LAG_NOTICE -Especifica o tempo em segundos em que se um servidor não responder a um ping, para difundir uma mensagem.
eg: LAG_NOTICE 60 -Para qualquer servidor que não responda a ping dentro de 60 segundos, uma mensagem é difundida.
HTML_STATS -Activa a exportação das estatísticas para HTML
eg HTML_STATS -Se definido, activa esta opção
HTML_PATH -Para onde exportar o ficheiro HTML. Inclua o caminho e o nome do ficheiro. Verifique que tem as permissões necessárias para gravar ficheiros neste caminho/ficheiro.
eg: HTML_PATH /var/www/html/stats/index.html -Exportar as estatísticas para esta localização.
[3.2] Comandos Disponíveis
SERVER -Mostra a lista de todos os servidores presentes na rede, ou informação individual de cada servidor
MAP -Mostra um mapa de todos os servidores ligados à rede
NETSTATS -Mostra estatísticas acerca da rede
DAILY -Mostra estatísticas acerca da rede no corrente dia
TLD -Descubra que país uma TLD representa
TLDMAP -Mostra uma contabilização dos utilizadores e de que países estes são provenientes
OPERLIST -Mostra uma lista de operadores
BOTLIST -Mostra uma lista dos bots online (apenas se o seu IRCD suportar uma flag de bot)
VERSION -Mostra a versão do bot StatServ em uso
Comandos disponíveis para Administradores:
FORCEHTML -Força uma actualização do ficheiro HTML
RESET -Apaga todas as estatísticas e recomeça do ponto zero
STATS -Apaga/copia informação de servidores
[3.3] O commando SERVER
/msg statserv server
Devolve:
=StatServ= Error, the Syntax is Incorrect. Please Specify a Server
=StatServ= Server Listing:
=StatServ= Server: stats.dynam.ac (*)
=StatServ= Server: services.dynam.ac (*)
=StatServ= Server: Server.IRC.net (*)
=StatServ= Server: blha.com (*)
=StatServ= Server: Server2.IRC.net (*)
=StatServ= ***** End of List (* indicates Server is online at the moment) *****
/msg statserv server <servername>
Devolve:
=StatServ= Statistics for services.dynam.ac since [Mar (Thu 21) 2002 08:47 [PM/SGT]]
=StatServ= Current Users: 7 (70%)
=StatServ= Maximum Users: 7 at [Mar (Thu 21) 2002 08:47 [PM/SGT]]
=StatServ= Current Opers: 5
=StatServ= Maximum Opers: 5 at [Mar (Thu 21) 2002 08:47 [PM/SGT]]
=StatServ= IRCop Kills: 0
=StatServ= Server Kills: 0
=StatServ= Lowest Ping: 0 at [Jan (Thu 01) 1970 07:30 [AM/SGT]]
=StatServ= Higest Ping: 0 at [Jan (Thu 01) 1970 07:30 [AM/SGT]]
=StatServ= Current Ping: 0
=StatServ= services.dynam.ac has never split from the Network.
=StatServ= ***** End of Statistics *****
[3.4] O comando MAP
/msg statserv map
Devolve:
=StatServ= [NAME] [USERS/MAX] [OPERS/MAX] [LAG/MAX]
=StatServ= stats.dynam.ac [ 2/2 ] [ 0/0 ] [ 0/0 ]
=StatServ= \_Server.IRC.net [ 1/1 ] [ 0/1 ] [ 0/0 ]
=StatServ= | \_services.dynam.ac [ 7/7 ] [ 5/5 ] [ 0/0 ]
=StatServ= | | \_blha.com [ 0/0 ] [ 0/0 ] [ 0/1 ]
=StatServ= | \_Server2.IRC.net [ 0/0 ] [ 0/0 ] [ 0/1 ]
=StatServ= --- End of Listing ---
[3.5] O comando NETSTATS
/msg statserv netstats
Devolve:
=StatServ= Network Statistics:-----
=StatServ= Current Users: 10
=StatServ= Maximum Users: 10 [[Mar (Thu 21) 2002 08:47 [PM/SGT]]]
=StatServ= Current Channels 0
=StatServ= Maximum Channels 2 [[Mar (Fri 22) 2002 09:46 [PM/SGT]]]
=StatServ= Current Opers: 5
=StatServ= Maximum Opers: 6 [[Mar (Thu 21) 2002 08:47 [PM/SGT]]]
=StatServ= Users Set Away: 0
=StatServ= Current Servers: 5
=StatServ= Maximum Servers: 5 [[Mar (Thu 21) 2002 08:47 [PM/SGT]]]
=StatServ= --- End of List ---
[3.6] O comando DAILY
/msg statserv daily
Devolve:
=StatServ= Daily Network Statistics:
=StatServ= Maximum Servers: 5 [Mar (Wed 27) 2002 12:31 [PM/SGT]]
=StatServ= Maximum Users: 10 [Mar (Wed 27) 2002 12:31 [PM/SGT]]
=StatServ= Maximum Chans: 0 [Jan (Thu 01) 1970 07:30 [AM/SGT]]
=StatServ= Maximum Opers: 5 [Mar (Wed 27) 2002 12:31 [PM/SGT]]
=StatServ= All Daily Statistics are reset at Midnight
=StatServ= End of Information.
[3.7] O comando TLD
/msg statserv tld <domain>
Devolve:
-> *statserv* tld sg
=StatServ= Singapore (sg)
[3.8] O comando TLDMAP
/msg statserv tldmap
Devolve:
=StatServ= Top Level Domain Statistics:
=StatServ= net 9 (90%) -> Generic Top Level Domain (net) ---> Daily Total: 33
=StatServ= num 1 (10%) -> UnResolved (num) ---> Daily Total: 25
=StatServ= End of List
[3.9] O comando OPERLIST
/msg statserv operlist
Devolve:
=StatServ= For Help: /msg StatServ HELP OPERLIST
=StatServ= On-Line IRCops:
=StatServ= [ 1] OperServ +ioSqd services.dynam.ac 200
=StatServ= [ 2] SS +iSqd services.dynam.ac 200
=StatServ= [ 3] ChanServ +oSqd services.dynam.ac 200
=StatServ= [ 4] StatServ +d stats.dynam.ac 200
=StatServ= [ 5] HelpServ +Sqd services.dynam.ac 200
=StatServ= [ 6] MemoServ +oSqd services.dynam.ac 200
=StatServ= [ 7] NeoStats +d stats.dynam.ac 200
=StatServ= [ 8] Global +ioSqd services.dynam.ac 200
=StatServ= [ 9] NickServ +oSqd services.dynam.ac 200
=StatServ= [10] Fish -a Server.IRC.net 185
=StatServ= End of Listing.
/msg statserv operlist noaway
Devolve:
=StatServ= On-Line IRCops (Not Away):
=StatServ= [ 1] OperServ +ioSqd services.dynam.ac 200
=StatServ= [ 2] SS +iSqd services.dynam.ac 200
=StatServ= [ 3] ChanServ +oSqd services.dynam.ac 200
=StatServ= [ 4] StatServ +d stats.dynam.ac 200
=StatServ= [ 5] HelpServ +Sqd services.dynam.ac 200
=StatServ= [ 6] MemoServ +oSqd services.dynam.ac 200
=StatServ= [ 7] NeoStats +d stats.dynam.ac 200
=StatServ= [ 8] Global +ioSqd services.dynam.ac 200
=StatServ= [ 9] NickServ +oSqd services.dynam.ac 200
=StatServ= End of Listing.
/msg statserv operlist <server>
Devolve:
=StatServ= On-Line IRCops on Server server.irc.net
=StatServ= [ 1] Fish -a Server.IRC.net 185
=StatServ= End of Listing.
[3.10] O comando BOTLIST
/msg statserv botlist
Devolve:
=StatServ= On-Line Bots:
=StatServ= End of Listing.
[3.11] O comando VERSION
/msg statserv version
Devolve:
=StatServ= StatServ Version Information
=StatServ= -------------------------------------
=StatServ= StatServ Version: 3.1 Compiled Mar 27 2002 at 12:22:27
=StatServ= http://www.neostats.net
=StatServ= -------------------------------------
=StatServ= HTML Stats is: /var/www/html/stats/index.html
[3.12] O comando FORCEHTML
/msg statserv forcehtml
Devolve:
<StatServ> Fish Forced the NeoStats Statistics HTML file to be updated with the most current statistics
[3.13] O comando RESET
/msg statserv reset
Devolve:
<StatServ> Fish Wants me to RESET the databases.. here goes..
[3.14] O comando STATS
/msg statserv stats list
Devolve:
=StatServ= Statistics Database:
=StatServ= [1 ] stats.dynam.ac
=StatServ= [2 ] services.dynam.ac
=StatServ= [3 ] Server.IRC.net
=StatServ= [4 ] blha.com
=StatServ= [5 ] Server2.IRC.net
=StatServ= End of List.
/msg statserv stats del <servername>
Devolve:
=StatServ= Removed blha.com from the database.
/msg statserv stats copy <name> <newname>
=StatServ= Copied Server data from <name> to <newname>
[3.15] A sintaxe HTML
Por predefinição, o StatServ usa um ficheiro chamado index.tpl na directoria data como o molde para a exportação.
De momento, o sistema de moldes é muito básico, e exportará tabelas contendo a informação pedida.
Todas as variáveis do molde estão incluidas em "!"
As variáveis de molde disponíveis são:
!MAP! -Exporta um mapa da rece similar a /msg statserv map num formato de tabela
!SRVLIST! -Exporta uma lista completa de todos os servidores que o StatServ 'viu', acompanhados de informação detalhada, fornecida pela variável !SRVLISTDET!
!NETSTATS! -Exporta estatísticas da rede similares a /msg statserv netstats
!DAILYSTATS! -Exporta estatísticas diárias similares a /msg statserv daily
!DAILYTOPCHAN! -Exporta os 10 canais mais usados, baseado no número de utilizadores
!TOP10CHAN! -Exporta os 10 canais onde se verificou maior número de 'entradas' (joins)
!TOP10KICKS! -Exporta os 10 canais onde se verifiou maior número de kicks
!TOP10TOPICS! -Exporta os 10 canais onde se verificou maior alteração de tópico
!VERSION! -Exporta a versão do StatServ/NeoStats em uso
O StatServ também exporta alguma informação acerca de quando a página foi criada, e qual o software que a criou, como predefinição no fim da página HTML. Esta opção não pode ser desactivada. (Desculpe, mas é a nossa pequena publicidade por todo o trabalho árduo que tivemos para criar o NeoStats para você o usar!)
Um molde exemplar é-lhe fornecido para não necessitar de perder tempo a fazer o seu próprio molde. Se desejar criar o seu próprio molde, substitua o ficheiro index.tpl no directório data pela sua versão.
[4] Informação de suporte
[4.1] Como conseguir suporte
Poderá conseguir suporte para o NeoStats de diversas formas. A primeira maneira é através dos nossos forums, disponíveis em:
http://www.neostats.net/boards/
Também pode tentar o nosso canal no IRC, irc://irc.irc-chat.net/neostats mas note que nem sempre estamos disponíveis no canal para o ajudar.
Lá existe um bot, o NeoServ, que contém informação acerca dos últimos bugs/suporte (duplicado dos forums NeoStats)
Por fim, poderá enviar um email para support@neostats.net
[4.2] Que informação deverá ter disponível para receber suporte
É sempre benéfico fornecer o maior número de informação quando procurar por ajuda. Certifique-se que inclui a seguinte informação:
Versão do sistema operativo (ex: Redhat, Mandrake, etc)
Versão do gcc (através do comando gcc -v)
Versão do NeoStats que está a usar e se o problema é com um módulo, a versão do módulo (através do comando /msg neostats modlist)
O tipo de IRCD que está a usar com o NeoStats (e a versão do mesmo)
Poderemos pedir que active a opção debugging e nos fornecer os resultados. Se é este o caso, você precisará de reconfigurar o NeoStats com a seguinte opção:
./configure --enable-debug (e quaisquer outras opções que possa necessitar, como o tipo de IRCD e lista de módulos)
"make"
./neostats
Quando o NeoStats crashar, ou o problema se reproduzir, por favor envie-nos os ficheiros:
logs/stats.log
logs/recv.log
e isso ajudar-nos-á a reproduzir o problema
De qualquer forma, é este o manual, obrigado por ter tido tempo para o ler (levou-me algumas horas a fazê-lo!) e divirta-se com o NeoStats. Se desejar submeter um pedido para nova funcionalidade, por favor visite os nossos fórums em http://www.neostats.net/boards/
A equipa NeoStats é composta por:
Shmad (Shmad@neostats.net)
^Enigma^ (enigma@neostats.net)
Fish (fish@neostats.net)
Traduzido por ErroR|51
