that everything is really up to date

errors.tex: Removes isode (yay!!)
		Updated tables to reflect current reality
		Added asn.1 tables and magic number table

Makefile: Two pass latex processing of library file will now realize

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@5351 dc483132-0cff-0310-8789-dd5450dbe970

diff --git a/doc/api/ChangeLog b/doc/api/ChangeLog
index df3ab57d7d0161c91a2c3cf6e875976ae27b8ab9..57465f8937675c82c3c6da8d465fda87b221c54e 100644 (file)
--- a/doc/api/ChangeLog
+++ b/doc/api/ChangeLog
@@ -1,3 +1,13 @@
+Tue Apr 11 14:21:21 1995  Ezra Peisach  (epeisach@kangaroo.mit.edu)
+
+       * Makefile Cleaned up two pass processing through latex of library
+               document.
+
+Tue Apr  4 15:22:11 1995  Ezra Peisach  <epeisach@mit.edu>
+
+       * errors.tex Added missing entries in existing tables. Removed
+               isode table. Added asn.1 table and magic number table.
+
 Tue Feb 07 18:31:58 1995 Chris Provenzano (proven@mit.edu)
 
        * krb5.tex Documented API changes to krb5_get_in_tkt*() routines

diff --git a/doc/api/Makefile b/doc/api/Makefile
index e74e44050d6ffdb02e29d8694101f3643e5b70d2..1438229bf0eb202d51a856a16ebfef81e14ca1ea 100644 (file)
--- a/doc/api/Makefile
+++ b/doc/api/Makefile
@@ -1,8 +1,10 @@
 .SUFFIXES: .tex .dvi .ps
 
+SHELL=/bin/sh
+
 STYLES=changebar.sty fixunder.sty functions.sty
 LIBTEX= library.tex intro.tex tables.tex errors.tex krb5.tex ccache.tex \
-       rcache.tex keytab.tex libos.tex library.ind
+       rcache.tex keytab.tex libos.tex 
 
 DESTEX= libdes.tex
 
@@ -13,25 +15,21 @@ libdes.dvi: $(DESTEX) $(STYLES)
 
 library.ps: library.dvi
 
-# hard to capture two-pass semantics in Makefiles...
-# library.ind: library.dvi
-library.ind: library.idx
-       index library.idx
-
-library.idx: 
-       touch library.ind
-       latex library.tex
-       rm library.ind
-
 clean:
-       rm -f *.toc *.log *.idx *.ind *.aux
+       rm -f *.toc *.log *.idx *.ind *.aux lib1.stamp
 
 really-clean: clean
        rm -f *.dvi *.ps
 
 
-library.dvi:  $(LIBTEX) $(STYLES)
+library.dvi:  lib1.stamp $(LIBTEX) $(STYLES)
+       latex library
 
+lib1.stamp: $(LIBTEX) $(STYLES)
+       touch library.ind
+       latex library
+       index library.idx
+       date > lib1.stamp
 
 .tex.dvi:
        latex $*

diff --git a/doc/api/errors.tex b/doc/api/errors.tex
index 1aa393e5dec47bb083f8663ecc4cf2536209e8c3..0f0dcf3f6716a8e260f70d257ae51a3b3d8b3365 100644 (file)
--- a/doc/api/errors.tex
+++ b/doc/api/errors.tex
@@ -34,8 +34,10 @@ code number.  Other error codes start at ERROR_TABLE_BASE_krb5 + 128.
 {\sc krb5kdc_err_service_notyet }& Server not yet valid - try again later \\
 {\sc krb5kdc_err_key_exp }&     Password has expired \\
 {\sc krb5kdc_preauth_failed }&          Preauthentication failed \\
+{\sc krb5kdc_err_preauth_require }&    Additional pre-authentication required \\
+{\sc krb5kdc_err_server_nomatch }&     Requested server and ticket don't match \\
 
- & \multicolumn{1}{c}{error codes 25-30 are currently placeholders} \\
+ & \multicolumn{1}{c}{error codes 27-30 are currently placeholders} \\
 \end{tabular}
 
 \begin{tabular}{ll}
@@ -88,11 +90,16 @@ code number.  Other error codes start at ERROR_TABLE_BASE_krb5 + 128.
 {\sc krb5krb_ap_err_tkt_invalid }& Ticket has invalid flag set \\
 {\sc krb5_princ_nomatch }&      Requested principal and ticket don't match \\
 {\sc krb5_kdcrep_modified }& KDC reply did not match expectations \\
+{\sc krb5_kdcrep_skew }&       Clock skew too great in KDC reply \\
+{\sc krb5_in_tkt_realm_mismatch }&     Client/server realm mismatch in
+initial ticket requst \\
+
 {\sc krb5_prog_etype_nosupp }& Program lacks support for encryption type \\
 {\sc krb5_prog_keytype_nosupp }& Program lacks support for key type \\
 {\sc krb5_wrong_etype }&        Requested encryption type not used in message \\
 {\sc krb5_prog_sumtype_nosupp }& Program lacks support for checksum type \\
 {\sc krb5_realm_unknown }&      Cannot find KDC for requested realm \\
+{\sc krb5_service_unknown }&   Kerberos service unknown \\
 {\sc krb5_kdc_unreach }&        Cannot contact any KDC for requested realm \\
 {\sc krb5_no_localname }&       No local name found for principal name \\
 
@@ -227,45 +234,72 @@ The Kerberos v5 database library error code table
 \end{tabular}
 \end{small}
 
-\subsection{error_table isod}
-
 % $Source$
 % $Author$
 
- The Kerberos v5/ISODE 5.0 error table mappings --- see $<$isode/psap.h$>$
+\subsection{The Kerberos v5 magic numbers errircode table}
 
 \begin{small}
 \begin{tabular}{ll} 
-{\sc isode_50_ps_err_none}& isode (ps): No error \\
-{\sc isode_50_ps_err_overid}& isode (ps):Overflow in ID \\
-{\sc isode_50_ps_err_overlen}& isode (ps):Overflow in length \\
-{\sc isode_50_ps_err_nmem}& isode (ps):Out of memory \\
-{\sc isode_50_ps_err_eof}& isode (ps):End of file \\
-{\sc isode_50_ps_err_eofid}& isode (ps):End of file reading extended ID \\
-{\sc isode_50_ps_err_eoflen}& isode (ps):End of file reading extended length \\
-{\sc isode_50_ps_err_len}& isode (ps):Length mismatch \\
-{\sc isode_50_ps_err_trnc}& isode (ps):Truncated \\
-{\sc isode_50_ps_err_indf}& isode (ps):Indefinite length in primitive form \\
-{\sc isode_50_ps_err_io}& isode (ps):I/O error \\
-{\sc isode_50_ps_err_extra}& isode (ps): Extraneous octets \\
-{\sc isode_50_ps_err_xxx}& isode (ps):XXX \\
-{\sc isode_50_pe_err_none}& isode(pe):No error \\
-{\sc isode_50_pe_err_over}& isode(pe):Overflow \\
-{\sc isode_50_pe_err_nmem}& isode(pe):Out of memory \\
-{\sc isode_50_pe_err_bit}& isode(pe):No such bit \\
-{\sc isode_50_pe_err_utct}& isode(pe):Malformed universal timestring \\
-{\sc isode_50_pe_err_gent}& isode(pe):Malformed generalized timestring \\
-{\sc isode_50_pe_err_mber}& isode(pe):No such member \\
-{\sc isode_50_pe_err_prim}& isode(pe):Not a primitive form \\
-{\sc isode_50_pe_err_cons}& isode(pe):Not a constructor form \\
-{\sc isode_50_pe_err_type}& isode(pe):Class/ID mismatch in constructor \\
-{\sc isode_50_pe_err_oid}& isode(pe):Malformed object identifier \\
-{\sc isode_50_pe_err_bits}& isode(pe):Malformed bitstring \\
-{\sc isode_50_pe_err_nosupp}& isode(pe):Type not supported \\
-{\sc isode_50_pe_err_signed}& isode(pe):Signed integer not expected \\
-{\sc isode_50_local_err_baddecode}&    isode: ASN.1 decode failed \\
-{\sc isode_50_local_err_badmsgtype}&   isode: wrong message type after decoding \\
-{\sc isode_50_local_err_badcombo}&     isode: unacceptable combination of options \\
-{\sc isode_local_err_missing_part}&    isode: missing element during translation \\
+{\sc kv5m_none }&              Kerberos V5 magic number table \\
+{\sc kv5m_principal }& Bad magic number for krb5_principal structure \\
+{\sc kv5m_data }&              Bad magic number for krb5_data structure \\
+{\sc kv5m_keyblock }&  Bad magic number for krb5_keyblock structure \\
+{\sc kv5m_checksum }&  Bad magic number for krb5_checksum structure \\
+{\sc kv5m_encrypt_block }&     Bad magic number for krb5_encrypt_block structure \\
+{\sc kv5m_enc_data }&  Bad magic number for krb5_enc_data structure \\
+{\sc kv5m_cryptosystem_entry }&        Bad magic number for krb5_cryptosystem_entry structure \\
+{\sc kv5m_cs_table_entry }&    Bad magic number for krb5_cs_table_entry structure \\
+{\sc kv5m_checksum_entry }&    Bad magic number for krb5_checksum_entry structure \\
+
+{\sc kv5m_authdata }&  Bad magic number for krb5_authdata structure \\
+{\sc kv5m_transited }& Bad magic number for krb5_transited structure \\
+{\sc kv5m_enc_tkt_parT }&      Bad magic number for krb5_enc_tkt_part structure \\
+{\sc kv5m_ticket }&            Bad magic number for krb5_ticket structure \\
+{\sc kv5m_authenticator }&     Bad magic number for krb5_authenticator structure \\
+{\sc kv5m_tkt_authent }&       Bad magic number for krb5_tkt_authent structure \\
+{\sc kv5m_creds }&             Bad magic number for krb5_creds structure \\
+{\sc kv5m_last_req_entry }&    Bad magic number for krb5_last_req_entry structure \\
+{\sc kv5m_pa_data }&           Bad magic number for krb5_pa_data structure \\
+{\sc kv5m_kdc_req }&           Bad magic number for krb5_kdc_req structure \\
+{\sc kv5m_enc_kdc_rep_part }& Bad magic number for krb5_enc_kdc_rep_part structure \\
+{\sc kv5m_kdc_rep }&           Bad magic number for krb5_kdc_rep structure \\
+{\sc kv5m_error }&             Bad magic number for krb5_error structure \\
+{\sc kv5m_ap_req }&            Bad magic number for krb5_ap_req structure \\
+{\sc kv5m_ap_rep }&            Bad magic number for krb5_ap_rep structure \\
+{\sc kv5m_ap_rep_enc_part }&   Bad magic number for krb5_ap_rep_enc_part structure \\
+{\sc kv5m_response }&  Bad magic number for krb5_response structure \\
+{\sc kv5m_safe }&              Bad magic number for krb5_safe structure \\
+{\sc kv5m_priv }&              Bad magic number for krb5_priv structure \\
+{\sc kv5m_priv_enc_part }&     Bad magic number for krb5_priv_enc_part structure \\
+{\sc kv5m_cred }&              Bad magic number for krb5_cred structure \\
+{\sc kv5m_cred_info }& Bad magic number for krb5_cred_info structure \\
+{\sc kv5m_cred_enc_part }&     Bad magic number for krb5_cred_enc_part structure \\
+{\sc kv5m_pwd_data }&  Bad magic number for krb5_pwd_data structure \\
+{\sc kv5m_address }&   Bad magic number for krb5_address structure \\
+{\sc kv5m_keytab_entry }&      Bad magic number for krb5_keytab_entry structure \\
+{\sc kv5m_context }&   Bad magic number for krb5_context structure \\
+{\sc kv5m_os_context }&        Bad magic number for krb5_os_context structure \\
+
 \end{tabular}
 \end{small}
+
+\subsection{error_table asn1}
+
+The Kerberos v5/ASN.1 error table mappings
+
+\begin{small}
+\begin{tabular}{ll}
+{\sc asn1_bad_timeformat }&    ASN.1 failed call to system time library \\
+{\sc asn1_missing_field }&     ASN.1 structure is missing a required field \\
+{\sc asn1_misplaced_field }&   ASN.1 unexpected field number \\
+{\sc asn1_type_mismatch }&     ASN.1 type numbers are inconsistent \\
+{\sc asn1_overflow }&  ASN.1 value too large \\
+{\sc asn1_overrun }&   ASN.1 encoding ended unexpectedly \\
+{\sc asn1_bad_id }&    ASN.1 identifier doesn't match expected value \\
+{\sc asn1_bad_length }&        ASN.1 length doesn't match expected value \\
+{\sc asn1_bad_format }&        ASN.1 badly-formatted encoding \\
+{\sc asn1_parse_error }&       ASN.1 parse error \\
+\end{tabular}
+\end{small}
+