Blocking and non-blocking APIs

I recently received an email from a regular reader of this blog. I am always very happy to receive feedback, comments and suggestions. In this case, it was a suggestion for a topic to address, which was particularly welcome. The writer wanted me to talk about blocking and non-blocking APIs …

At the heart of a real time operating system [RTOS] is the kernel, which is comprised of the task scheduler and a bunch of services, which are available for application programs. Control of the scheduler and access to these services is by means of the kernel’s application program interface [API]. APIs differ from one RTOS to another [although there are some standards, like POSIX], but there are some characteristics which are common to many. One of those similarities is the concept of blocking and non-blocking calls.

The idea is fairly straightforward. A program may make an API call to request a specific resource or service. Such a call may normally return with the required result and/or a pointer to requested resources. There may also be the possibility for an error result. But, what if the call is valid, but the resource or service cannot be provided at this time. There are two ways to make such a call, which differ in their response to this unavailability: A blocking call results in the task being suspended [put to sleep]; the task will be woken when the request can be fulfilled. A non-blocking call results in an error code being returned; the task has the option of trying the call again later.

What if several tasks are blocked pending the availability of a resource, which then becomes available? Which task is woken up to have its request satisfied? This depends upon the specific RTOS. Typically tasks are either woken in priority order [i.e. a higher priority task will be woken first] or they are woken in the order in which they suspended [“first in, first out”- FIFO]. This may be a kernel configuration choice or may be selectable on a per-object basis.
The choice of using a blocking or non-blocking call is generally up to the applications programmer. Using a non-blocking call is simple to understand – typically the task would put itself to sleep for a while then try again. A blocking call is simpler to code and reduces the use of system resources, as the task remains suspended and not in contention for CPU time until the resource is available.

We can look at a real example. The Nucleus RTOS supports semaphores, which may be created with a call like this:

	STATUS NU_Create_Semaphore(NU_SEMAPHORE *semaphore, CHAR *name,
           UNSIGNED initial_count, OPTION suspend_type);

The last parameter determines how blocked tasks are woken up; the options are priority [NU_PRIORITY] or FIFO [NU_FIFO] order.

Obtaining a semaphore requires a call like this:

	STATUS NU_Obtain_Semaphore(NU_SEMAPHORE *semaphore,
           UNSIGNED suspend);

The blocking/non-blocking behavior is determined by the last parameter. This may be set to NU_SUSPEND [indefinite blocking], NU_NO_SUSPEND [non-blocking], or to a timeout value, which specifies how long [in clock ticks] the task will be suspended for pending the availability of the semaphore.

The Nucleus API offers the same flexibility for all relevant API calls.


0 thoughts about “Blocking and non-blocking APIs
  • Hi! it’s really a good detailed post. i’ve gone through many articles to know about this topic, but none of them given clear idea about that. but i got it here. Thankyou !!

Leave a Reply

This article first appeared on the Siemens Digital Industries Software blog at