Linux 命令速查
系统管理 man setleds

setleds

设置键盘 NumLock、CapsLock、ScrollLock 指示灯状态

返回

补充说明

setleds 属于 kbd 套件,直接读写 Linux 虚拟控制台的键盘 LED 标志。它操作的是内核键盘驱动维护的三个开关量:NumLock、CapsLock 和 ScrollLock,而不是某个应用程序的输入状态。

三个标志各可以用 + 或 - 前缀表示打开或关闭;不带前缀时表示只设置“默认状态”,下次切换到该虚拟终端时生效,当前指示灯不变。加 -v 可以看到修改前后的状态。

该命令只在虚拟控制台(tty1–tty63)有效,在 X11、Wayland 的终端模拟器里执行通常会因为打不开 /dev/tty 而失败或毫无效果。服务器上常用它关闭 CapsLock,避免误触导致密码输入失败。

语法

setleds [-v] [-L] [{+|-}num] [{+|-}caps] [{+|-}scroll]

选项

  • -v:显示当前 LED 状态和修改结果
  • -L:只修改标志位,不改变 LED 指示灯
  • -D:把标志位和 LED 都恢复到默认状态
  • -num / +num:关闭 / 打开 NumLock
  • -caps / +caps:关闭 / 打开 CapsLock
  • -scroll / +scroll:关闭 / 打开 ScrollLock

实例

# 查看当前键盘指示灯状态
setleds -v

# 打开 NumLock
setleds +num

# 关闭 CapsLock,避免大小写输入错误
setleds -caps

# 同时关闭 ScrollLock 并打印结果
setleds -v -scroll

参考链接