TLSRPT_CANCEL_DELIVERY_REQUEST(3)

πŸ’– tlsrpt_cancel_delivery_request β€” the manual, but make it cute πŸ’–

okay bestie so this is the page for tlsrpt_cancel_delivery_request(3) from the tlsrpt manual, and honestly? it's a short one, but it's a powerful one. let's get into it 🫢


✨ NAME ✨

tlsrpt_cancel_delivery_request β€” marks the delivery request as cancelled. that's it, that's the whole job, and she does it flawlessly πŸ’…


🌸 SYNOPSIS 🌸

#include <tlsrpt.h>

int tlsrpt_cancel_delivery_request(struct tlsrpt_dr_t** pdr)

like yes, include the header, call the function, pass her a struct tlsrpt_dr_t**, collect your result. we love a clean signature ✨


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea, bestie. tlsrpt_cancel_delivery_request marks the delivery request as cancelled. and the way it does that is so iconic: it uses an internal library "dummy error" called TLSRPT_ERR_TLSRPT_CANCELLED, and β€” just like every other error in this library β€” that error does the very important job of preventing the delivery request from being sent out. so it's not a real error, it's a subtle little "nope, we're not doing this" βœ‹

then, once that's handled, the function goes ahead and calls tlsrpt_finish_delivery_request, which does all the clean-up of used resources. so she tags out, and finish does the tidying. teamwork, fr fr πŸ§šπŸ’–

no cap: that "dummy error" is doing a lot of emotional labor here. all errors stop the send, so the cancel is basically an error with main character energy πŸ‘‘

πŸŽ€ RETURN VALUE πŸŽ€

tlsrpt_cancel_delivery_request returns 0 on success and a combined error code on failure. and if you get that combined error code? you can analyze it with the tlsrpt_strerror function. slay, we love a debuggable failure 🌈


πŸ‘‘ SEE ALSO πŸ‘‘

  • man:tlsrpt_init_delivery_request[3]
  • man:tlsrpt_finish_delivery_request[3]
  • man:tlsrpt_strerror[3]
  • man:tlsrpt_error_code_is_internal[3]

the whole bestie squad, honestly. go read them too πŸ’œ


πŸ’œ AUTHOR πŸ’œ

Boris Lohner


that's the whole page, bestie β€” short, sweet, and cancelled (the request, not your vibe). this was tlsrpt_cancel_delivery_request from the tlsrpt manual, source and version girlies clocking in at 2026-05-12, page TLSRPT_CA...Y_REQUEST(3). mwah, take care of her πŸ«ΆπŸ’–βœ¨

πŸ“¦ where this page comes from