doc/prog.texi

   1 @c Copyright (c) 2002 Kungliga Tekniska Högskolan
   2 @c (Royal Institute of Technology, Stockholm, Sweden).
   3 @c All rights reserved.
   4
   5 @c $Id$
   6
   7 @node Programming, Oddities, Porting, Top
   8 @comment  node-name,  next,  previous,  up
   9 @chapter Programming
  10
  11 This chapter is programming documentation of arla's internal parts.
  12
  13 This is just to cover the ideas of the implemation, but documentation
  14 of the actual code, please see commends in the source code for that.
  15
  16 @menu
  17 * Arla pioctl's::       Documentation of arla pioctl's
  18 * Disco with arla::     Disconnected mode
  19 * afsUUID::             afs UUID
  20 @c * NNPFS interface::
  21 @end menu
  22
  23 @node Arla pioctl's, Disco with arla, Programming, Programming
  24 @comment  node-name,  next,  previous,  up
  25
  26 @include pioctl.texi
  27
  28 @node Disco with arla, afsUUID, Arla pioctl's, Programming
  29 @comment  node-name,  next,  previous,  up
  30
  31 @include prog-disco.texi
  32
  33 @node afsUUID, , Disco with arla, Programming
  34 @comment  node-name,  next,  previous,  up
  35
  36 @chapter afsUUID
  37
  38 @cindex afsUUID
  39 @cindex DCE UUID
  40
  41 @code{AFS} uses a @code{DCE UUID} (Microsoft GUID is a another version
  42 of a DCE UUID) is identify file servers and callback managers. The
  43 callback manager regenerate its @code{uuid} every time it restarts.
  44
  45 The fileserver stores its @code{uuid} on disk and uses it to identify
  46 it self when registering its addresses with the VLDB-server.
  47
  48 The @code{afsUUID} is special in some implementations since it uses
  49 the ip-address as the node identifier instead of the mac-address (IEEE
  50 OUI + node address).  Also the time in DCE is based on Unix epoch
  51 instead of DCE epoch. This will cause problems in about 287 years when
  52 the old generated afs UUID till start to collide with new genrated DCE
  53 UUIDs. Hopefully people have a solution to this problem then.
  54
  55 @c
  56 @c I have a promise from Derrick that they will solve the problem before
  57 @c I die, Love
  58 @c