freefunc - name clash with Python.h

Viktor Dukhovni openssl-users at dukhovni.org
Tue Apr 19 23:58:39 UTC 2022


> On 21 Jun 2020, at 1:20 pm, Dan Kegel <dank at kegel.com> wrote:
> 
> Openssl should probably stop using generic identifiers like freefunc
> in its header files, out of sheer self-defense.

I'd long held an apparently minority opinion among OpenSSL team members
that prototypes in header files MUST NOT name any variables, and should
only mention their types, precisely to avoid this sort of issue.  Thus,
e.g.:

	int foo(char *, int);

rather than:

	int foo(char *buf, int len);

Variable names in header files are no substitute for documentation, and
are all too prone to precisely this sort of conflict.

-- 
	Viktor.



More information about the openssl-users mailing list