Overview

To sign a message under DomainKeys Identified Mail ("DKIM"), make the following calls:
  1. lib = dkim_init(...);
  2. dkim = dkim_sign(lib, ...);
  3. stat = dkim_header(dkim, ...);
  4. stat = dkim_eoh(dkim);
  5. stat = dkim_body(dkim, ...);
  6. stat = dkim_eom(dkim);
  7. stat = dkim_getsighdr(dkim, ...);
  8. stat = dkim_free(dk);

To verify a message under DKIM, make the following calls:
  1. lib = dkim_init(...);
  2. dkim = dkim_verify(lib, ...);
  3. stat = dkim_header(dkim, ...);
  4. stat = dkim_eoh(dkim);
  5. stat = dkim_body(dkim, ...);
  6. stat = dkim_eom(dkim);
  7. stat = dkim_free(dkim);

One application, having called dkim_init() once, can call dkim_sign() or dkim_verify() more than once each, and furthermore can have more than one signing/verifying handle in existence at any given time.