Zdalne wywołania procedur Jarosław Kuchta Programowanie Współbieżne
Podstawy RPC Remote Procedure Call Wywołanie procedur jednego procesu z innego procesu. Proces wywoływany serwer Proces wywołujący - klient Wywoływana procedura jest wykonywana w przestrzeni adresowej wywoływanego procesu (serwera). RPC 2
RPC w sieci protokół opracowany przez firmę Sun popularny w systemie Unix obsługiwany w bibliotekach języka Java współcześnie obsługiwany przez protokoły: SOAP CORBA XML-RPC JSON-RPC RPC 3
XDR External Data Representation standard jednolitej reprezentacji danych w sieci między komputerami o różnych architekturach warunki podstawowe wszystkie typy danych mają rozmiar będący wielokrotnością 4 bajtów, liczby całkowite kodowane w standardzie BigEndian (najpierw starsze bajty) liczby rzeczywiste w formacie IEEE. nadawca i odbiorca muszą znać struktury danych (nie są przekazywane) RPC 4
Filtry XDR xdr_int xdr_float xdr_char xdr_wrapstring (dla typu char *) RPC 5
Filtry XDR dla struktur struktura struct s int i, float x filtr int xdr_s (XDR *xptr, struct s *sptr) return (xdr_int(xptr, &sptr->i) && xdr_float(xptr, &sptr->x); RPC 6
Identyfikacja procedury trzy liczby całkowite: numer programu numer wersji numer procedury RPC 7
Rejestracja procedury int registerrpc( unsigned long PROG, unsigned long VERS, unsigned long PROC, char * ( * proc)(), // adres procedury int (* xdr_arg)(), // adres filtra argumentów int (* xdr_res)()); // adres filtra wyników RPC 8
Przykład procedura udostępniająca czas systemowy #include <rpc/rpc.h> #define PRZYKLAD 0x20000000 #define WERSJA 1 #define CZAS 1 typedef struct tt; void main (void) registerrpc ( PRZYKŁAD, WERSJA, CZAS, czas, xdr_void, xdr_t); svc_run(); extern void podaj_czas (tt *) char *czas (void) static tt t; podaj_czas (&t); return (char *)&t; RPC 9
Wywołanie procedury zdalnej int callrpc( char *server, // nazwa serwera unsigned long PROG, unsigned long VERS, unsigned long PROC, int (* xdr_arg)(), char *arg, // struktura argumentów int (* xdr_res)(), char *res); // struktura wyników RPC 10
Przykład wywołanie procedury udostępniającej czas systemowy #include <rpc/rpc.h> #define PRZYKLAD 0x20000000 #define WERSJA 1 #define CZAS 1 typedef struct tt; void main (void) tt t; callrpc("servername", PRZYKŁAD, WERSJA, CZAS, xdr_void, NULL, xdr_t, &t); int xdr_t (XDR *xptr, tt *tp) extern void korzystaj (tt *); korzystaj (&t); RPC 11
RPC a wykonanie równoległe zwykłe wywołanie RPC wywołanie przez rozgłaszanie main proc main proc proc callrpc registerrpc clnt_broadcast registerrpc proces wywołujący jest wstrzymywany procesy wywoływane są równolegle RPC 12
Wykonanie równoległe int clnt_broadcast( unsigned long PROG, unsigned long VERS, unsigned long PROC, int (* xdr_arg)(), char *arg, int (* xdr_res)(), char *res, int (* res_proc)()); przez rozgłaszanie RPC 13
Przykład wywołanie procedury przez rozgłaszanie #include <rpc/rpc.h> #define PRZYKLAD 0x20000000 #define WERSJA 1 #define CZAS 1 typedef struct tt; int xdr_t (XDR *xptr, tt *tp) extern void korzystaj (tt *); void main (void) tt t; clnt_broadcast( PRZYKŁAD, WERSJA, CZAS, xdr_void, NULL, xdr_t, &t, po_rozgloszeniu); korzystaj (&t); int po_rozgloszeniu (char *t, struct socketaddr_in *addr) return true; RPC 14
Ograniczenia Brak mechanizmu wstrzymywania procesów rozwiązanie: wysokopoziomowe mechanizmy synchronizacji w Unix RPC blokowanie procesu wywoływanego konieczność jawnego podawania nazwy serwera rozwiązanie: rpc_bind zdalne rozgłaszanie przynajmniej jedna procedura musi być wykonywana RPC 15
Asynchroniczne RPC deklaracja procedury (IDL) [ uuid (7f6c4340-eb67-11d1-b9d7-00c04fad9a3b), version(1.0), pointer_default(unique) ] interface AsyncRPC const long DEFAULT_ASYNC_DELAY = 10000; const short APP_ERROR = -1; const char* DEFAULT_PROTOCOL_SEQUENCE = "ncacn_ip_tcp"; const char* DEFAULT_ENDPOINT = "8765"; void NonAsyncFunc(handle_t hbinding, [in, string] unsigned char * pszmessage); void AsyncFunc(handle_t hbinding, [in] unsigned long nasychdelay); void Shutdown(handle_t hbinding); RPC 16
IDL IDL Interface Description Language MIDL kompilator IDL RPC 17
Alternatywa atrybuty ACF ACF Application Configuration File IDL + ACF: interface AsyncRPC [async] AsyncFunc(); RPC 18
Wywołanie asynchroniczne (1) RPC_ASYNC_STATE Async; RPC_STATUS status; // Initialize the handle. status = RpcAsyncInitializeHandle(&Async, sizeof(rpc_async_state)); if (status) // Code to handle the error goes here. Async.UserInfo = NULL; Async.NotificationType = RpcNotificationTypeEvent; Async.u.hEvent = CreateEvent(NULL, FALSE, FALSE, NULL); if (Async.u.hEvent == 0) // Code to handle the error goes here. RPC 19
Wywołanie asynchroniczne (2) // Call an asynchronous RPC routine here RpcTryExcept printf("\ncalling the remote procedure 'AsyncFunc'\n"); AsyncFunc(&Async, AsyncRPC_ClientIfHandle, nasychdelay); RpcExcept(1) ulcode = RpcExceptionCode(); printf("asyncfunc: Run time reported exception 0x%lx = %ld\n", ulcode, ulcode); RpcEndExcept RPC 20
Wywołanie synchroniczne tej samej procedury // Call a synchronous routine while the asynchronous procedure is still running RpcTryExcept printf("\ncalling the remote procedure 'NonAsyncFunc'\n"); NonAsyncFunc(AsyncRPC_ClientIfHandle, pszmessage); fprintf(stderr, "While 'AsyncFunc' is running asynchronously,\n" "we still can send message to the server in the mean time.\n\n"); RpcExcept(1) ulcode = RpcExceptionCode(); printf("nonasyncfunc: Run time reported exception 0x%lx = %ld\n", ulcode, ulcode); RpcEndExcept RPC 21
Oczekiwanie na odpowiedź bez blokowania własnego wątku: // This code fragment assumes that Async is a valid asynchronous RPC handle. if (WaitForSingleObject(Async.u.hEvent, INFINITE) == WAIT_FAILED) RpcRaiseException(APP_ERROR); z blokowaniem własnego wątku: if (SleepEx(INFINITE, TRUE)!= WAIT_IO_COMPLETION) RpcRaiseException(APP_ERROR); RPC 22
Obsługa wywołania przez serwer (1) void AsyncFunc(IN PRPC_ASYNC_STATE pasync, IN RPC_BINDING_HANDLE hbinding, IN OUT unsigned long nasychdelay) int nreply = 1; RPC_STATUS status; unsigned long ntmpasychdelay; int i; if (nasychdelay < 0) nasychdelay = DEFAULT_ASYNC_DELAY; else if (nasychdelay < 100) nasychdelay = 100; RPC 23
Obsługa wywołania przez serwer (2) // We only call RpcServerTestCancel if the call // takes longer than ASYNC_CANCEL_CHECK ms if (nasychdelay > ASYNC_CANCEL_CHECK) ntmpasychdelay = nasychdelay/100; for (i = 0; i < 100; i++) Sleep(nTmpAsychDelay); if (i%5 == 0) fprintf(stderr, "\rrunning AsyncFunc (%lu ms) (%d%c)... ", nasychdelay, i+5, PERCENT); status = RpcServerTestCancel( RpcAsyncGetCallHandle(pAsync)); if (status == RPC_S_OK) fprintf(stderr, "\nasyncfunc has been canceled!!!\n"); break; else if (status!= RPC_S_CALL_IN_PROGRESS) printf("rpcasyncinitializehandle returned 0x%x\n", status); exit(status); else Sleep(nAsychDelay); RPC 24
Wysłanie odpowiedzi przez serwer printf("\ncalling RpcAsyncCompleteCall\n"); status = RpcAsyncCompleteCall(pAsync, &nreply); printf("rpcasynccompletecall returned 0x%x\n", status); if (status) exit(status); RPC 25
Przyjęcie odpowiedzi przez klienta status = RpcAsyncCompleteCall( &Async, &Reply); // W tym momencie wynik jest zwracany w Reply RPC 26