ADC Home > Reference Library > Technical Q&As > Legacy Documents > Internet & Web >

Legacy Documentclose button

Important: This document is part of the Legacy section of the ADC Reference Library. This information should not be used for new development.

Current information on this Reference Library topic can be found here:

Additional URL Access Error Codes


Q: When calling URLDownload or URLOpen in Mac OS 9.x, I occasionally see error codes that aren't documented. What do these error codes mean?

A: Here are the meanings of some additional error codes that may be returned by URL Access when running on Mac OS 9.x:

The following errors are returned from the SSL code used by URL Access.

  • -10: The server requires 128-bit encryption, but URL Access doesn't support it. (URL Access began supporting 128-bit encryption in version 2.1, which shipped with Mac OS 9.1)
     
  • -15: The URL Access Manager does not have the server's root certificate and thus cannot validate the certificate received from the server. There is no mechanism to add new root certificates to URL Access when running on Mac OS 9.x, so to work around this limitation, you will need to add a certificate to your server that is known to URL Access.

  • -6986: Also known as X509CertChainInvalidErr. The certificate on the server has expired. In URL Access 2.4.1, the behavior was changed to allow expired certificates by default which should eliminate this error.

  • -6996: Also known as SSLProtocolErr. If you see this error, you may be able to fix it by adding a certificate to your server that's supported by URL Access. If that doesn't help, there is currently no other way to workaround this error. You should not see this error when running on Mac OS X 10.1 and later.
     
    For your reference, here are the root certificates contained in URL Access 2.0 which shipped with Mac OS 9.0:
     
    GTE CyberTrust Global Root
    GTE CyberTrust Root
    GTE CyberTrust Root 2
    GTE CyberTrust Root 3
    GTE CyberTrust Root 4
    GTE CyberTrust Root 5
    RSA Data Security, Inc.
    TC TrustCenter Class 0 CA
    TC TrustCenter Class 1 CA
    TC TrustCenter Class 2 CA
    TC TrustCenter Class 3 CA
    TC TrustCenter Class 4 CA
    Thawte Personal Basic CA
    Thawte Personal Freemail CA
    Thawte Personal Premium CA
    Thawte Premium Server CA
    Thawte Server CA
    Verisign, Inc. Class 1 G2
    Verisign, Inc. Class 1 Primary
    Verisign, Inc. Class 2 G2
    Verisign, Inc. Class 2 Primary
    Verisign, Inc. Class 3 G2
    Verisign, Inc. Class 3 Primary
    Verisign, Inc. Class 4 G2


    These additional certificates were shipped with Mac OS 9.1:

    Baltimore CyberTrust Code Signing Root
    Baltimore CyberTrust Mobile Root
    Baltimore CyberTrust Root


The following is an internal TCP-level error:

  • -23008: A connection used by URL Access no longer exists. This is usually a benign condition since HTTP provides for recovery if a connection is unexpectedly closed.

[Dec 18 2002]


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.