Portmapper



Do spisu tresci tematu 9
9.2.2 Portmapper



Spis tresci
Wprowadzenie
Struktury
Funkcje
pmap_getmaps()
pmap_set()
pmap_unset()
pmap_getport()
rmt_call()
Dzialanie portmappera
Bibliografia


Wprowadzenie

Aby wywolac odlegla procedure (usluge) kllient powinien
otrzymac jej adres. W tym celu komunikuje sie z demonem portmappera dzialajacym
na zdalnym komputerze. Demon ten zawsze korzysta z portu o numerze 111.
Portmapper dysponuje lista zarejestrowanych uslug z odpowiadajacymi im
numerami portow. Dane te przechowuje w odpowiednich strukturach danych:


Struktury
- Glowna struktura portmappera jest lista, w ktorej trzymane sa numery
programow i wersji z przypisanymi im numerami portow

struct pmaplist {
struct pmap pml_map; /* struktura zawierajaca dane
struct pmaplist *pml_next; /* wskaznik do nastepnej
};

, gdzie struktura pmap wyglada nastepujaco:

struct pmap {
long unsigned pm_prog; /* numer programu
long unsigned pm_vers; /* numer wersji
long unsigned pm_prot; /* rodzaj protokolu
long unsigned pm_port; /* numer portu
};


Funkcje

Do komunikacji z portmapperem wykorzystujemy nastepujace
funkcje:

pmap_getmaps()

struct pmaplist *pmap_getmaps(addr)
struct sockaddr_in *addr; /* adres internetowy komputera

Funkcja ta zwraca liste zarejestrowanych uslug (program,wersja),
wraz z przypisanymi im numerami portow, na komputerze o podanym adresie
(moze to byc serwer zdalny lub lokalny). Wskaznik do tej struktury przechowywany
jest na zmiennej globalnej serwera "pmaplist".

pmap_set()

bool_t pmap_set(prognum,versnum,protocol,port)
u_long prognum /* numer programu
u_long versnum /* numer wersji
int protocol /* IPPROTO_UDP lub IPPROTO_TCP
u_short port /* numer portu

Dzieki tej funkcji mozemy przypisac numer portu do naszej
nowo rejestrowanej uslugi. Na poczatku pobieramy adres naszego komputera
przy uzyciu funkcji getmyaddress(), potem tworzymy klienta udp podane parametry
wpisujemy do struktury parms typu struct pmap i wywolujemy

CLNT_CALL(client,PMAPPROC_SET,xdr_pmap,&pmap,xdr_bool,&result,
tottimeout),

ktora to fukcja kmomunikuje sie z naszym lokalnym portmapperem. Sprawdza on czy
dana funkcja moze zostac zarejestrowana, jesli tak to zwraca kod sukcesu, wpp
kod bledu.

pmap_unset()

bool_t pmap_unset(prognum,versnum)
u_long prognum /* numer programu
u_long versnum /* numer wersji


Podobnie jak funkcja pmap_set z tym, ze funkcja CLNT_CALL
wywolywana jest z parametrem PMAPPROC_UNSET.

pmap_getport()

u_short pmap_getport(address,prognum,versnum,protocol)
struct sockaddr_in address /*adres serwera
u_long prognum /* numer programu
u_long versnum /* numer wersji
int protocol /* IPPROTO_UDP lub IPPROTO_TCP

Przy pomocy funkcji htons(PMAPPORT) ustawia zmmienna sin_port
w adresie serwera na numer portu portmapera, tworzy samego klienta przy
pomocy clntudp_bufcreate, wywoluje CLNT_CALL z parametrem
PMAPPROC_GETPORT i ta juz wszystko zalatwia.

rmt_call()

enum clnt_stat
pmap_rmtcall(addr,prog,vers,proc,xdrargs,argsp,xdrres,resp,tout,port_ptr)
struct sockaddr_in address /*a dres serwera
u_long prog,vers,proc /* numer programu,wersji,procedury
xdrproc_t xdrargs,xdrres /* filtry xdr do obslugi danych
/* nadawanych i przyjmowanych
caddr_t argsp,resp /* wskazniki do argumentow funkcji
/* i do bufora na wynik
struct timeval tout /* maksymalny czas oczekiwannia na odpowiedz


Funkcja do zdalnego wywolywania procedury, sama przeszukuje
mape zarejestrowanych portow, a nastepnie wywoluje zadana procedure, pozwala
ona programowi przejrzec liste portow i procedur, i automatycznie wywolac
zadana procedure w jednym kroku (funkcja dziala tylko dla protokolu udp).
Poczatek jak w getport, tworzy klienta clntudp_create i wywoluje
CLNT_CALL z PMAPPROC_CALLIT i ta znowu wszystko
zalatwia.

Wszystkie parametry typu PMAPPROC_xxx dla funkcji CLNT_CALL
sa zmiennymi typu u_long. Po nich to portmaper rozpoznaje jakiej uslugi
zyczy sobie od niego klient, z tych wywolan ciekawe jest
PMAPPROC_CALLIT.


Dzialanie portmappera

Demon portmappera zaimplementowany jest w pliku portmap.c.
Jest to serwer rpc wykonujacy funkcje reg_service(). Przydziela on sobie
111 numer portu oraz otwiera dwa wejscia jedno dla protokolu UDP drugie
dla protokolu TCP, nastepnie wywoluje funkcje svc_register() i rejestruje
jako swoja usluge funkcje reg_service, w ktorej to zaimplementowane sa
wywolania nastepujacych funkcji (jako numery uslug - typu u_long):


#define PMAPPROC_NULL ((u_long)0)
#define PMAPPROC_SET ((u_long)1)
#define PMAPPROC_UNSET ((u_long)2)
#define PMAPPROC_GETPORT ((u_long)3)
#define PMAPPROC_DUMP ((u_long)4)
#define PMAPPROC_CALLIT ((u_long)5)


Dla wywolania PMAPPROC_CALLIT wykonuje sie funkcje callit()
w ktorej to nastepuje pobranie argumentow do zdalnej procedury. O ile dana
procedura jest zarejestrowana to portmapper wywoluje ja na lokalnnym serwerze.
W tym celu tworzy nowego klienta i wywoluje funkcje fork. Proces potomny
zajmuje sie wykonaniem uslugi, a sam demon dziala dalej czekajac na kolejne
zadania. Jezeli wszystko poszlo dobrze to proces potomny wysyla wynik wykonania
procedury do kllienta korzystajacego z uslugi.

Bibliografia

Biblioteka LIBC, pliki: ./rpc/*

Plik: portmap.c

R. Stevens: ,,Programowanie zastosowan sieciowych''

M. Gabbasi, B. Dupouy: ,,Przetwarzanie rozproszone w systemie UNIX''






Autor: Pawel Glebocki