Linux Manuals session 3

Section 3: library functions

  • |

    ne_ssl_dname_cmp (3) Linux Manual Page

    ne_ssl_readable_dname, ne_ssl_dname_cmp – SSL distinguished name handling Synopsis #include <ne_ssl.h> const char *ne_ssl_readable_dname(const ne_ssl_dname *dname); int ne_ssl_dname_cmp(const ne_ssl_dname *dn1, const ne_ssl_dname *dn2); Description The ne_ssl_readable_dname function creates a single-line, human-readable string out of an ne_ssl_dname object. The returned string is malloc()-allocated, and must be free()d by the caller. The ne_ssl_dname_cmp function compares two distinguished names,…

  • |

    ne_ssl_clicert_read (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_clicert_owner (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_clicert_name (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_clicert_free (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_clicert_encrypted (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_clicert_decrypt (3) Linux Manual Page

    ne_ssl_clicert_read, ne_ssl_clicert_name, ne_ssl_clicert_encrypted, ne_ssl_clicert_decrypt, ne_ssl_clicert_owner, ne_ssl_clicert_free – SSL client certificate handling Synopsis #include <ne_ssl.h> ne_ssl_client_cert *ne_ssl_clicert_read(const char *filename); const char *ne_ssl_clicert_name(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_encrypted(const ne_ssl_client_cert *ccert); int ne_ssl_clicert_decrypt(ne_ssl_client_cert *ccert, const char *password); const ne_ssl_certificate *ne_ssl_clicert_owner(const ne_ssl_client_cert *ccert); void ne_ssl_clicert_free(ne_ssl_client_cert *ccert); Description The ne_ssl_clicert_read function reads a client certificate from a PKCS#12-formatted file, and returns…

  • |

    ne_ssl_cert_write (3) Linux Manual Page

    ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export – functions to read or write certificates to and from files or strings Synopsis #include <ne_ssl.h> ne_ssl_certificate *ne_ssl_cert_read(const char *filename); int ne_ssl_cert_write(const ne_ssl_certificate *cert, const char *filename); ne_ssl_certificate *ne_ssl_cert_import(const char *data); char *ne_ssl_cert_export(const ne_ssl_certificate *cert); Description The ne_ssl_cert_write function writes a certificate to a file using the PEM encoding. The ne_ssl_cert_export…

  • |

    ne_ssl_cert_subject (3) Linux Manual Page

    ne_ssl_cert_identity, ne_ssl_cert_signedby, ne_ssl_cert_issuer, ne_ssl_cert_subject – functions to access certificate properties Synopsis #include <ne_ssl.h> const char *ne_ssl_cert_identity(const ne_ssl_certificate *cert); const ne_ssl_certificate *ne_ssl_cert_signedby(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_subject(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_issuer(const ne_ssl_certificate *cert); Description The function ne_ssl_cert_identity retrieves the “identity” of a certificate; for an SSL server certificate, this will be the hostname for which…

  • |

    ne_ssl_cert_signedby (3) Linux Manual Page

    ne_ssl_cert_identity, ne_ssl_cert_signedby, ne_ssl_cert_issuer, ne_ssl_cert_subject – functions to access certificate properties Synopsis #include <ne_ssl.h> const char *ne_ssl_cert_identity(const ne_ssl_certificate *cert); const ne_ssl_certificate *ne_ssl_cert_signedby(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_subject(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_issuer(const ne_ssl_certificate *cert); Description The function ne_ssl_cert_identity retrieves the “identity” of a certificate; for an SSL server certificate, this will be the hostname for which…

  • |

    ne_ssl_cert_read (3) Linux Manual Page

    ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export – functions to read or write certificates to and from files or strings Synopsis #include <ne_ssl.h> ne_ssl_certificate *ne_ssl_cert_read(const char *filename); int ne_ssl_cert_write(const ne_ssl_certificate *cert, const char *filename); ne_ssl_certificate *ne_ssl_cert_import(const char *data); char *ne_ssl_cert_export(const ne_ssl_certificate *cert); Description The ne_ssl_cert_write function writes a certificate to a file using the PEM encoding. The ne_ssl_cert_export…

  • |

    ne_ssl_cert_issuer (3) Linux Manual Page

    ne_ssl_cert_identity, ne_ssl_cert_signedby, ne_ssl_cert_issuer, ne_ssl_cert_subject – functions to access certificate properties Synopsis #include <ne_ssl.h> const char *ne_ssl_cert_identity(const ne_ssl_certificate *cert); const ne_ssl_certificate *ne_ssl_cert_signedby(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_subject(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_issuer(const ne_ssl_certificate *cert); Description The function ne_ssl_cert_identity retrieves the “identity” of a certificate; for an SSL server certificate, this will be the hostname for which…

  • |

    ne_ssl_cert_import (3) Linux Manual Page

    ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export – functions to read or write certificates to and from files or strings Synopsis #include <ne_ssl.h> ne_ssl_certificate *ne_ssl_cert_read(const char *filename); int ne_ssl_cert_write(const ne_ssl_certificate *cert, const char *filename); ne_ssl_certificate *ne_ssl_cert_import(const char *data); char *ne_ssl_cert_export(const ne_ssl_certificate *cert); Description The ne_ssl_cert_write function writes a certificate to a file using the PEM encoding. The ne_ssl_cert_export…

  • |

    ne_ssl_cert_identity (3) Linux Manual Page

    ne_ssl_cert_identity, ne_ssl_cert_signedby, ne_ssl_cert_issuer, ne_ssl_cert_subject – functions to access certificate properties Synopsis #include <ne_ssl.h> const char *ne_ssl_cert_identity(const ne_ssl_certificate *cert); const ne_ssl_certificate *ne_ssl_cert_signedby(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_subject(const ne_ssl_certificate *cert); const ne_ssl_dname *ne_ssl_cert_issuer(const ne_ssl_certificate *cert); Description The function ne_ssl_cert_identity retrieves the “identity” of a certificate; for an SSL server certificate, this will be the hostname for which…

  • |

    ne_ssl_cert_free (3) Linux Manual Page

    ne_ssl_cert_cmp, ne_ssl_cert_free – functions to operate on certificate objects Synopsis #include <ne_header.h> int ne_ssl_cert_cmp(const ne_ssl_certificate *c1, const ne_ssl_certificate *c2); void ne_ssl_cert_free(ne_ssl_certificate *cert); Description The ne_ssl_cert_cmp function can be used to compare two certificate objects; it returns zero if they refer to the same certificate, and non-zero otherwise. The ne_ssl_cert_free function can be used to destroy…

  • |

    ne_ssl_cert_export (3) Linux Manual Page

    ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export – functions to read or write certificates to and from files or strings Synopsis #include <ne_ssl.h> ne_ssl_certificate *ne_ssl_cert_read(const char *filename); int ne_ssl_cert_write(const ne_ssl_certificate *cert, const char *filename); ne_ssl_certificate *ne_ssl_cert_import(const char *data); char *ne_ssl_cert_export(const ne_ssl_certificate *cert); Description The ne_ssl_cert_write function writes a certificate to a file using the PEM encoding. The ne_ssl_cert_export…

  • |

    ne_ssl_cert_cmp (3) Linux Manual Page

    ne_ssl_cert_cmp, ne_ssl_cert_free – functions to operate on certificate objects Synopsis #include <ne_header.h> int ne_ssl_cert_cmp(const ne_ssl_certificate *c1, const ne_ssl_certificate *c2); void ne_ssl_cert_free(ne_ssl_certificate *cert); Description The ne_ssl_cert_cmp function can be used to compare two certificate objects; it returns zero if they refer to the same certificate, and non-zero otherwise. The ne_ssl_cert_free function can be used to destroy…

  • |

    ne_sock_init (3) Linux Manual Page

    ne_sock_init, ne_sock_exit – perform library initialization Synopsis #include <ne_socket.h> int ne_sock_init(void); void ne_sock_exit(void); Description In some platforms and configurations, neon may be using some socket or SSL libraries which require global initialization before use. To perform this initialization, the ne_sock_init function must be called before any other library functions are used. Once all use of…

  • |

    ne_sock_exit (3) Linux Manual Page

    ne_sock_init, ne_sock_exit – perform library initialization Synopsis #include <ne_socket.h> int ne_sock_init(void); void ne_sock_exit(void); Description In some platforms and configurations, neon may be using some socket or SSL libraries which require global initialization before use. To perform this initialization, the ne_sock_init function must be called before any other library functions are used. Once all use of…

  • |

    ne_shave (3) Linux Manual Page

    ne_shave – trim whitespace from a string Synopsis #include <ne_string.h> char *ne_shave(char *str, const char *whitespace); Description ne_shave returns a portion of str with any leading or trailing characters in the whitespace array removed. str may be modified. Note that the return value may not be equal to str. Examples The following code segment will…