doc/servers.texi

   1 @c Copyright (c) 1998 - 2000 Kungliga Tekniska Högskolan
   2 @c (Royal Institute of Technology, Stockholm, Sweden).
   3 @c All rights reserved.
   4
   5 @c $Id$
   6
   7 @c
   8 @c  This file contain random junk that should be ordered some day
   9 @c
  10
  11
  12 @section YDR
  13
  14 @cindex Ydr
  15 @cindex Rxgen
  16
  17 @code{Ydr} is a rxgen replacement that is generating a lot more stuff
  18 then rxgen (like headerfiles). It also does the same thing in one run
  19 instead of three (rxgen does one run for ss.c cs.c and .h, and each time
  20 passes the whole data thru cpp).
  21
  22 @code{Ydr} was created when there was no free rx package.
  23
  24 Things to remeber about ydr and ydr generated code:
  25
  26 @itemize @bullet
  27
  28 @item When a server function is done out mashalling and writing out data
  29 it will free all data that contains VARRAYs. The functions you are
  30 intressed in is @code{generate_server_stub} and @code{genfree}.
  31
  32 @item When a server functions fail (ie returns != 0), mashalling of
  33 out-data is not done, and out-data is not freed, instead rx_Error() is
  34 called with that error (See @code{generate_server_stub}.
  35
  36 @item To use ydr (to describe when is codeing a struct or running ydr on
  37 a file) is called ydra.
  38
  39 @end itemize
  40
  41
  42 @c Creations of a volume
  43 @c VOLSER_ListPartions
  44 @c      VL_GetEntryByNameN   -> VL_NOENT
  45 @c      VOLSER_CreateVolume
  46 @c      VOLSER_SetFlags
  47 @c      VOLSER_EndTrans    (rcode ignored ?)
  48 @c      VL_CreateEntryN
  49
  50