/* * futex.spin: Promela code to validate n wakers to 1 waiter selective * futex wakeup algorithm. * * In this model, waker threads are told whether they are still being * waited on, and skip the futex wakeup if not. The waiter progresses * each time it sees data in both queues. * Algorithm verified : * * queue[n] = 0; * futex = 0; * futex_wake = 0; * * n wakers (2 loops) * * queue[pid] = 1; * if (futex == -1) { * if (waker[pid].waiting == 1) { * waker[pid].waiting = 0; * futex = 0; * futex_wake = 1; * } * } * * 1 waiter * * while (1) { * futex = -1; * waker[0].waiting = 1; * waker[1].waiting = 1; * while (!(queue[0] == 1 && queue[1] == 1)) { * if (futex == -1) { * futex_wake = (futex == -1 ? 0 : 1); (atomic) * while (futex_wake == 0) { }; * } * } * } * futex = 0; * waker[0].waiting = 0; * waker[1].waiting = 0; * progress: * queue[0] = 0; * queue[1] = 0; * } * * if queue = 1, then !_np * * By testing progress, i.e. [] <> ((!np_) || (!queue_has_entry)), we * check that we can never block forever if there is an entry in the * any of the queues. * * The waker performs only 2 loops (and NOT an infinite number of loops) * because we really want to see what happens when the waker stops * enqueuing. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * * Copyright (c) 2009-2011 Mathieu Desnoyers */ #define get_pid() (_pid) int queue[2] = 0; int waiting[2] = 0; int futex = 0; int futex_wake = 0; active [2] proctype waker() { assert(get_pid() < 2); /* loop 1 */ queue[get_pid()] = 1; if :: (futex == -1) -> if :: (waiting[get_pid() == 1]) -> waiting[get_pid()] = 0; futex = 0; futex_wake = 1; :: else -> skip; fi; :: else -> skip; fi; /* loop 2 */ queue[get_pid()] = 1; if :: (futex == -1) -> if :: (waiting[get_pid() == 1]) -> waiting[get_pid()] = 0; futex = 0; futex_wake = 1; :: else -> skip; fi; :: else -> skip; fi; #ifdef INJ_QUEUE_NO_WAKE /* loop 3 */ queue[get_pid()] = 1; #endif } active proctype waiter() { do :: 1 -> #ifndef INJ_LATE_DEC futex = -1; waiting[0] = 1; waiting[1] = 1; #endif do :: 1 -> if :: (queue[0] == 1 || queue[1] == 1) -> break; :: else -> skip; fi; #ifdef INJ_LATE_DEC futex = -1; waiting[0] = 1; waiting[1] = 1; #endif if :: (futex == -1) -> atomic { if :: (futex == -1) -> futex_wake = 0; :: else -> futex_wake = 1; fi; } /* block */ do :: 1 -> if :: (futex_wake == 0) -> skip; :: else -> break; fi; od; :: else -> skip; fi; od; futex = 0; waiting[0] = 0; waiting[1] = 0; progress: /* progress on dequeue */ queue[0] = 0; queue[1] = 0; od; }