Mailing-List: contact dev-help@apr.apache.org; run by ezmlm
Precedence: bulk
Received-SPF: pass (nike.apache.org: domain of trawick@gmail.com designates
 209.85.160.44 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type;
        b=MQHzVlYvEvRZnqMF6+8gWpFY2n7PpFwqcg+2eIET+/RPIXAM2qsJkSNa+3m5+IVGya
         D/RhgwRnPeEwr+bSU40HSrHTdkTrWkBqOPw3VPylNnLm7LXgD/UeSVCADXoxDVoU3At6
         +buoeY+U9UcXqguF5HzuJnIr8wgBxs6hrHCWk=
MIME-Version: 1.0
Date: Mon, 23 Nov 2009 09:48:27 -0500
Message-ID: <cc67648e0911230648i3275f4c4k6f620b80e3da2841@mail.gmail.com>
Subject: apr_global_mutex_names(), similar to apr_proc_mutex_name()?
From: Jeff Trawick <trawick@gmail.com>
To: APR Developer List <dev@apr.apache.org>
Content-Type: text/plain; charset=ISO-8859-1

APR_DECLARE(void) apr_global_mutex_names(apr_global_mutex_t *mutex,
                                         const char **proc_mech,
                                         const char **thread_mech)
{
    *proc_mech = apr_proc_mutex_name(mutex->proc_mutex);
    *thread_mech = NULL;
#if APR_HAS_THREADS
    if (mutex->thread_mutex) {
        *thread_mech = "pthread";
    }
#endif
}

I'd like to be able to retrieve the selected mechanism(s) from a
global mutex like I can for a proc mutex, but somehow this is not a
very satisfying interface.

Also, Win32 and others wouldn't be able to

#define apr_global_mutex_names  apr_proc_mutex_names

like they can for other global mutex functions.

--/--

Since thread mechanisms aren't configurable/selectable, there is
limited value in returning the name of the thread mechanism, so this
could just be

APR_DECLARE(const char *) apr_global_mutex_names(apr_global_mutex_t *mutex)
{
    return apr_proc_mutex_name(mutex->proc_mutex);
}

and

#define apr_global_mutex_names  apr_proc_mutex_names

--/--

Does anybody care?  (Otherwise I'll go with the second choice and
explain away the issue of the potential, non-selectable second mutex
in the doc.)