From dc6f3c3836d63a93ff5820aad902e7e76d5eedfb Mon Sep 17 00:00:00 2001 From: Ezra Peisach Date: Tue, 11 Apr 1995 18:25:12 +0000 Subject: [PATCH] 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 --- doc/api/ChangeLog | 10 +++++ doc/api/Makefile | 24 +++++------ doc/api/errors.tex | 104 ++++++++++++++++++++++++++++++--------------- 3 files changed, 90 insertions(+), 48 deletions(-) diff --git a/doc/api/ChangeLog b/doc/api/ChangeLog index df3ab57d7..57465f893 100644 --- 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 + + * 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 e74e44050..1438229bf 100644 --- 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 1aa393e5d..0f0dcf3f6 100644 --- 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} + -- 2.26.2