manual/linux-man9/original/man9/cli.9

   1 .\" -*- nroff -*-
   2 .TH cli 9 "$Date:$" "Linux DDI" "Kernel Functions"
   3 .SH NAME
   4 cli, sti \- disable/enable interrupts
   5 .SH SYNOPSIS
   6 .B #include  <asm/system.h>
   7 .sp
   8 .BI "extern void cli()"
   9 .br
  10 .BI "extern void sti()"
  11 .SH DESCRIPTION
  12 The
  13 .B cli
  14 function causes interrupts to be blocked on the host, so that
  15 following critical code may run uninterrupted. The
  16 .B sti
  17 function enables interrupts again.
  18 .PP
  19 Although it is possible to use cli/sti pairs to protect critical code,
  20 it is best to use
  21 .B cli
  22 with the
  23 .B save_flags
  24 macro. See
  25 .B save_flags "(9)."
  26 .SH "RETURN VALUE"
  27 none
  28 .SH AVAILABILITY
  29 Linux 1.0+
  30 .SH "SEE ALSO"
  31 .BR save_flags "(9)"
  32 .PP
  33 .IR "include/asm-*/system.h"
  34 .SH AUTHOR
  35 Stephen Williams (steve@icarus.com)
  36 .SH BUGS
  37 The i386 ancestry of the names can be slightly confusing.