wait.h

7号信令功能代码,为开源代码

/*                               -*- Mode: C -*- 
 * wait.h --- waiting for events...
 * Author          : Francisco J. Ballesteros
 * Created On      : Tue May 31 21:40:37 1994
 * Last Modified By: David Grothe
 * RCS Id          : wait.h,v 1.1.1.1 2002/10/29 22:41:29 brian Exp
 * Purpose         : provide user waitentials
 * ----------------______________________________________________
 *
 *   Copyright (C) 1995  Francisco J. Ballesteros
 *   Copyright (C) 1997  David Grothe, Gcom, Inc <[e-mail]>
 *
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 * 
 * This library 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
 * Library General Public License for more details.
 * 
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Cambridge,
 * MA 02139, USA.
 * 
 *
 *    You can reach me by email to
 *    [e-mail]
 */


#ifndef _WAIT_H
#define _WAIT_H 1

#ident "@(#) LiS wait.h 2.3 10/29/02 22:41:29 "

#ifdef __KERNEL__
/*  -------------------------------------------------------------------  */
/*                               Dependencies                            */

#ifndef _HEAD_H
#include <sys/LiS/head.h>	/* stream head */
#endif


/*  -------------------------------------------------------------------  */
/*                         Shared global variables                       */

#define ONESEC (1000000/HZ)	/* ? */

/*  -------------------------------------------------------------------  */
/*			Exported functions & macros                      */


/* The functions below are to achieve mutual exclusion on the stream
 * head. They use the sd_wopen wait queue to sleep and the sd_lock char to
 * flag the lock.
 * The lock/unlock are the complete ones.
 * if you just want to wait you may use wait_on/wake_up.
 *
 * You can lock(L)/wait(W)/sleep(S) on the following events:
 * L/S wopen:  the 1st opener completes its job
 * W/S wwrite: there's room in the write queue to issue a downstream msg.
 * W/S wread: msg arrives at the stream head.
 * L/S wioc:  process completes it's ioctl()
 *   S wiocing: answer to ioc arrived
 * STATUS: complete(?), untested
 */
extern int lis_sleep_on_wopen(struct stdata * sd) ;
extern int lis_sleep_on_wioc(struct stdata * sd) ;
extern int lis_sleep_on_wwrite(struct stdata * sd);
extern int lis_sleep_on_wread(struct stdata * sd);
extern int lis_sleep_on_wiocing(struct stdata * sd);
extern int lis_sleep_on_read_sem(struct stdata * sd);


/*  -------------------------------------------------------------------  */

#define lis_wait_on_wwrite(sd)	lis_sleep_on_wwrite(sd)

#define lis_wait_on_wread(sd)	lis_sleep_on_wread(sd)

#define lis_lock_wioc(sd)	lis_sleep_on_wioc(sd)

/*  -------------------------------------------------------------------  */

extern void	lis_wake_up_wwrite(struct stdata * sd) ;     /* wait.c */
extern void	lis_wake_up_all_wwrite(struct stdata * sd) ; /* wait.c */
extern void	lis_wake_up_wread(struct stdata * sd) ;      /* wait.c */
extern void	lis_wake_up_all_wread(struct stdata * sd) ;  /* wait.c */
extern void	lis_wake_up_read_sem(struct stdata * sd);    /* wait.c */
extern void	lis_wake_up_all_read_sem(struct stdata * sd);    /* wait.c */

#define lis_wake_up_wiocing(sd)						\
				{					\
				    lis_up(&sd->sd_wiocing);		\
				}


/*  -------------------------------------------------------------------  */
#define lis_unlock_wioc(sd)						\
				{					\
				    lis_up(&sd->sd_wioc);		\
				}


/*  -------------------------------------------------------------------  */

/* Sched & cancel timeouts
 */
typedef	void	tmout_fcn_t(ulong) ;

extern void
lis_tmout(struct timer_list *tl, tmout_fcn_t *fn, long arg, long ticks) ;

extern void
lis_untmout( struct timer_list *tl) ;

#endif /* __KERNEL__ */

#endif /*!_WAIT_H*/

/*----------------------------------------------------------------------
# Local Variables:      ***
# change-log-default-name: "~/src/prj/streams/src/NOTES" ***
# End: ***
  ----------------------------------------------------------------------*/