Convencions de noms

De Guifi.net - Wiki Català

A Guifi.net hi ha milers de nodes i tots han de tenir el seu nom únic dins la xarxa, per això es fan servir unes convencions a l'hora de posar els noms.

Aquesta pàgina es una proposta per a unificar sintaxis feta a partir del model històric de nombrar als nodes segons pràctica habitual dins de Guifi.net. Actualment no es tracta de una norma consensuada dins de Guifi, encara que ho pot arribar a ser.

Els noms tant de zones com de nodes dins de Guifi.net es fan servir per a qüestions administratives tals com servidors de noms, identificadors de xarxa, informes, etcétera.

Restriccions

Hi ha certes restriccions que vénen dels RFCs de sistemes informàtics i de xarxes que s'han de tenir en compte a l'hora algunes de les més importants:

Hostname

Els hostnames o noms de màquina UNIX imposa una llargada màxima de 255 caràcters, dintre dels quals poden haver-hi vàries etiquetes d'1 a 63 caràcters separades entre elles per un punt.

Els caràcters només poden ser lletres ASCII des de la 'a' a la 'z' (no discrimina entre majúscules i minúscules), números i el guió sempre i quan aquest no estigui al principi ni al final (actualment ja s'accepten números al principi) RFC 1123.

ESSID

Els identificadors de xarxa ESSID imposa una llargada màxima de 32 caràcters. Habitualment es fan servir habitualment alfanumèrics, encara que l'estàndard no ho especifica, ja que fer servir caràcters no alfanumèrics pot complicar les configuracions.

Zona

No existeix una estandardització global per a noms de zones com pobles o ciutats. A Guifi.net podem observar dos tipus històricament:

Nom complet o gairebé complert amb la primera en majúscula i la resta en minúscula

És l'exemple de Gurb, Olot o Tortosa. La majoria de zones i de nodes segueixen aquesta convenció, per lo que la proposta seria homogeneitzar en aquesta direcció. Excepcions com Barcelona que actualment es diu BCN passaria dir-se Barna.

Nom abreviat de tres o quatre xifres en majúscules

És una mena adaptació del codi d'aeroports IATA, que és un codi habitualment de tres xifres en majúscules que formen part del nom de la ciutat o un codi que es faci servir històrica o culturalment (tal com el codi històric d'estacions de ferrocarrils) o nom inventat a semblança.

El nom curt de zona o, tal com figura a la web: "Abreviació" doncs serà de 3 lletres i es representarà en majúscules, excepte si la lletra central pertany a una preposició que serà representada en minúscules (per exemple PdM per a Pineda de Mar). En cas que l'abreviació de tres xifres estigui agafada o resulti ambigua es podrà fer servir excepcionalment una abreviació de 4 xifres.

Node

A l'hora de ficar el "Nom curt" a un node tingues en compte les següents normes de cara a una bona estandardització.

Restriccions

Degudes a les restriccions imposades per hostname i ESSID aplicarem que el nom màxim total d'un node serà de 32 caràcters de la 'a' a la 'z' (no discrimina entre majúscules i minúscules) i números.

Nom del node

Es farà servir la següent nomenclatura:

[Ciutat][Carrer][numero]

o, en cas de no tenir nom de carrer o número o tenir més rellevància local un altre nom (com un mas, centre cultural, hospital,...) es farà servir

[Ciutat][NomLocal]

o, en cas de que la zona "Ciutat" sigui molt gran i tingui a dins subzones:

[Ciutat][Barri][Carrer][numero]

o

[Ciutat][Barri][NomLocal]

On:

  • [Ciutat] és el nom de la ciutat o poble en el que es troba el node i es representa tal com està indicat a l'apartat Zona
  • [Barri] és opcional i és el nom del barri en el que es troba el node (d'existir) i es representa tal com està indicat a l'apartat Zona
  • [Carrer] i [nomlocal]. Si l'identificador de zona acaba en majúscula, aquest començarà en minúscula per a separar-ho i si es tracta de un nom amb més d'una paraula les següents paraules comencen amb majúscula, tot sense accents, ni espais, ni guions.
  • [numero] és el número de la finca

Nom de l'ESSID

Partim del fet que hi ha nodes/supernodes que tenen més d'una ràdio (i a més no sempre en la mateixa ubicació i a vegades unes són mesh i d'altres són infraestructura), en tal cas és molt recomanable que l'identificador de l'essid afegeixi aquestes singularitats:

[protocol]-[Ciutat][Barri][Carrer][numero]-[ubicacio]

o

[protocol]-[Ciutat][Barri][NomLocal]-[ubicacio]

On la part central està explicada a l'apartat anterior i separada al principi de [protocol] per un guió i separada al final d'[ubicacio] per un altre. On:

  • [protocol] seria opcional, però recomanable sobretot en subxarxes mesh i correspon a un dels protocols actualment actius a Guifi.net, és a dir BMX6 o BATMAN si son mesh; o BGP o OSPF si son infraestructura, sempre completament amb majúscules, ja que són sigles.
  • [ubicacio] és opcional i correspon a la ubicació del node dins de l'edifici si aquesta informació és rellevant per a casos que són nodes mesh d'interiors per a marcar un pis o per a marcar que no es troben a la teulada si no una finestra d'una determinada façana.

Veure també

Eines de l'usuari