"Fossies" - the Fresh Open Source Software Archive

Member "krb5-1.18/doc/kadm5/adb-unit-test.tex" (12 Feb 2020, 3207 Bytes) of package /linux/misc/krb5-1.18.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) TeX and LaTeX source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 % This document is included for historical purposes only, and does not
    2 % apply to krb5 today.
    3 
    4 \documentstyle[times,fullpage]{article}
    5 
    6 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    7 %% Make _ actually generate an _, and allow line-breaking after it.
    8 \let\underscore=\_
    9 \catcode`_=13
   10 \def_{\underscore\penalty75\relax}
   11 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   12 
   13 \newcommand{\test}[1]{\begin{description}
   14 \setlength{\itemsep}{0pt}
   15 #1
   16 \end{description}
   17 
   18 }
   19 
   20 \newcommand{\numtest}[2]{\begin{description}
   21 \setlength{\itemsep}{0pt}
   22 \Number{#1}
   23 #2
   24 \end{description}
   25 
   26 }
   27 
   28 \newcommand{\Number}[1]{\item[Number:] #1}
   29 \newcommand{\Reason}[1]{\item[Reason:] #1}
   30 %\newcommand{\Call}[1]{\item[Call:] #1}
   31 \newcommand{\Expected}[1]{\item[Expected:] #1}
   32 \newcommand{\Conditions}[1]{\item[Conditions:] #1}
   33 \newcommand{\Priority}[1]{\item[Priority:] #1}
   34 \newcommand{\Status}[1]{\item[Status:] #1}
   35 %\newcommand{\Number}[1]{}
   36 %\newcommand{\Reason}[1]{}
   37 \newcommand{\Call}[1]{}
   38 %\newcommand{\Expected}[1]{}
   39 %\newcommand{\Conditions}[1]{}
   40 %\newcommand{\Priority}[1]{}
   41 
   42 \title{OpenV*Secure Admin Database API\\
   43 Unit Test Description}
   44 \author{Jonathan I. Kamens}
   45 
   46 \begin{document}
   47 
   48 \maketitle
   49 
   50 %\tableofcontents
   51 
   52 \section{Introduction}
   53 
   54 The following is a description of a black-box unit test of the
   55 OpenV*Secure Admin Database API (osa_adb).  Each API function is
   56 listed, followed by the tests that shoud be performed on it.
   57 
   58 The tests described here are based on the ``OV*Secure Admin Server
   59 Implementation Design'' revision 1.14.
   60 
   61 \section{osa_adb_get_lock and osa_adb_release_lock}
   62 
   63 \numtest{1}{
   64 \Reason{A shared lock can be acquired.}
   65 \Status{Implemented}
   66 }
   67 
   68 \numtest{2}{
   69 \Reason{An exclusive lock can be acquired and released.}
   70 \Status{Implemented}
   71 }
   72 
   73 \numtest{3}{
   74 \Reason{A permanent lock can be acquired and released.}
   75 \Status{Implemented}
   76 }
   77 
   78 \numtest{4}{
   79 \Reason{Attempting to release a lock when none is held fails with
   80 NOTLOCKED.}
   81 \Status{Implemented}
   82 }
   83 
   84 \numtest{5}{
   85 \Reason{Two processes can both acquire a shared lock.}
   86 \Status{Implemented}
   87 }
   88 
   89 \numtest{6}{
   90 \Reason{An attempt to acquire a shared lock while another process holds an
   91 exclusive lock fails with CANTLOCK_DB.}
   92 \Status{Implemented}
   93 }
   94 
   95 \numtest{7}{
   96 \Reason{An attempt to acquire an exclusive lock while another process holds a
   97 shared lock fails with CANTLOCK_DB.}
   98 \Status{Implemented}
   99 }
  100 
  101 \numtest{8}{
  102 \Reason{An attempt to open the database while a process holds a
  103 permanent lock fails with NO_LOCKFILE.}
  104 \Status{Implemented}
  105 }
  106 
  107 \numtest{9}{
  108 \Reason{An attempt to acquire an exclusive lock while a process holds a
  109 permanent lock fails with NO_LOCKFILE.}
  110 \Status{Implemented}
  111 }
  112 
  113 \numtest{10}{
  114 \Reason{Acquiring a permanent lock deletes the lockfile.}
  115 \Status{Implemented}
  116 }
  117 
  118 \numtest{11}{
  119 \Reason{Releasing a permanent lock re-creates the lockfile.}
  120 \Status{Implemented}
  121 }
  122 
  123 \numtest{12}{
  124 \Reason{A process can perform a get operation while another process holds a
  125 shared lock.}
  126 \Status{Implemented}
  127 }
  128 
  129 \numtest{13}{
  130 \Reason{A process that is running and has opened the adb principal database
  131 can retrieve a principal created after the open occurred.}
  132 \Status{Implemented, but not working}
  133 }
  134 
  135 \end{document}