From 98de87ffa287fb3a283497b9f2dffc98d78fba60 Mon Sep 17 00:00:00 2001 From: liutong Date: Sun, 2 Jul 2023 14:53:53 +0800 Subject: [PATCH] change help longdoc format --- bash-5.1/builtins_rust/break_1/src/lib.rs | 3 +- bash-5.1/builtins_rust/common/src/lib.rs | 3 +- bash-5.1/builtins_rust/exec_cmd/src/lib.rs | 5 +- bash-5.1/builtins_rust/getopts/src/lib.rs | 21 +- bash-5.1/builtins_rust/help/src/lib.rs | 15 +- bash-5.1/builtins_rust/history/src/lib.rs | 18 +- bash-5.1/resources/en-US/message.ftl | 4 +- bash-5.1/resources/zh-CN/message.ftl | 2399 ++++++++++---------- bash-5.1/resources/zh-HK/message.ftl | 2399 ++++++++++---------- record.txt | 1 + 10 files changed, 2509 insertions(+), 2359 deletions(-) diff --git a/bash-5.1/builtins_rust/break_1/src/lib.rs b/bash-5.1/builtins_rust/break_1/src/lib.rs index d49fca3e..5329c03c 100644 --- a/bash-5.1/builtins_rust/break_1/src/lib.rs +++ b/bash-5.1/builtins_rust/break_1/src/lib.rs @@ -52,6 +52,7 @@ extern "C" { static mut breaking : i32; static mut continuing : i32; static mut loop_level : i32; + fn builtin_error(err:*const libc::c_char,...); } #[no_mangle] @@ -118,7 +119,7 @@ pub extern "C" fn r_continue_builtin (mut list :*mut WordList) -> i32 { pub extern "C" fn check_loop_level () -> i32 { unsafe { if loop_level == 0 && posixly_correct == 0 { - println! ("only meaningful in a `for`, `while`, or until `loop` "); + builtin_error (b"only meaningful in a `for`, `while`, or until `loop` \0" as *const u8 as *const libc::c_char); return 0; } loop_level diff --git a/bash-5.1/builtins_rust/common/src/lib.rs b/bash-5.1/builtins_rust/common/src/lib.rs index 332e7e23..cc91ea97 100644 --- a/bash-5.1/builtins_rust/common/src/lib.rs +++ b/bash-5.1/builtins_rust/common/src/lib.rs @@ -1155,7 +1155,7 @@ pub extern "C" fn r_get_numeric_arg(mut list:*mut WordList,fatal:i32,count:*mut if !list.is_null(){ arg = (*(*list).word).word; - if !arg.is_null() || legal_number(arg,count) == 0{ + if arg.is_null() || legal_number(arg,count) == 0{ if !(*(*list).word).word.is_null(){ r_sh_neednumarg((*(*list).word).word); } @@ -1174,7 +1174,6 @@ pub extern "C" fn r_get_numeric_arg(mut list:*mut WordList,fatal:i32,count:*mut jump_to_top_level(DISCARD!()); } } - r_no_args((*list).next); } return 1; diff --git a/bash-5.1/builtins_rust/exec_cmd/src/lib.rs b/bash-5.1/builtins_rust/exec_cmd/src/lib.rs index 23bb0478..3541d011 100644 --- a/bash-5.1/builtins_rust/exec_cmd/src/lib.rs +++ b/bash-5.1/builtins_rust/exec_cmd/src/lib.rs @@ -760,7 +760,7 @@ unsafe fn get_cmd_type (command : *mut libc::c_char) -> CMDType{ else if libc::strcmp(command, b"compgen\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0{ types = CMDType::CompgenCmd; } - else if libc::strcmp(command,b"declare\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0{ + else if libc::strcmp(command,b"declare\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 || libc::strcmp(command,b"typeset\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 { types = CMDType::DeclareCmd; } else if libc::strcmp(command,b"local\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0{ @@ -844,8 +844,7 @@ unsafe fn get_cmd_type (command : *mut libc::c_char) -> CMDType{ else if libc::strcmp(command,b"return\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 { types = CMDType::ReturnCmd; } - else if libc::strcmp(command,b"set\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 - || libc::strcmp(command,b"typeset\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 { + else if libc::strcmp(command,b"set\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 { types = CMDType::SetCmd; } else if libc::strcmp(command,b"unset\0" as *const u8 as *const libc::c_char as *mut libc::c_char) == 0 { diff --git a/bash-5.1/builtins_rust/getopts/src/lib.rs b/bash-5.1/builtins_rust/getopts/src/lib.rs index 1878b816..25373fbc 100644 --- a/bash-5.1/builtins_rust/getopts/src/lib.rs +++ b/bash-5.1/builtins_rust/getopts/src/lib.rs @@ -343,10 +343,10 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 } /* argv[0] is "getopts". */ - optstr = *((argvv as usize +8) as *mut*mut c_char); - name = *((argvv as usize +16) as *mut*mut c_char); + optstr = *(argvv.offset(1)); + name = *(argvv.offset(2)); argcc -= 2; - argvv = (argvv as usize +16) as *mut*mut c_char; + argvv = argvv.offset(2); if *optstr == ':' as c_char { special_error = 1; @@ -356,7 +356,7 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 if special_error != 0 { old_opterr = sh_opterr; - optstr=(optstr as usize + 4) as * mut c_char; + optstr= optstr.offset(1); sh_opterr = 0; /* suppress diagnostic messages */ } @@ -382,18 +382,18 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 v = strvec_create(i + 1); i=0; while i < 10 && dollar_vars[i as usize] !=std::ptr::null_mut() { - *((v as usize +8*i as usize) as *mut*mut c_char) = dollar_vars[i as usize]; + *(v.offset(i as isize)) = dollar_vars[i as usize]; i+=1; } words = rest_of_args; while words != std::ptr::null_mut() { - *((v as usize +8*i as usize) as *mut*mut c_char) = (*(*words).word).word; + *(v.offset(i as isize)) = (*(*words).word).word; words = (*words).next; i+=1; } - *((v as usize +8*i as usize) as *mut*mut c_char) = std::ptr::null_mut(); + *(v.offset(i as isize)) = std::ptr::null_mut(); sh_getopt_restore_state(&mut(*v)); ret = sh_getopt(i, v, optstr); libc::free(v as * mut c_void); @@ -421,9 +421,7 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 numval[i as usize] = (n % 10) as c_char + '0' as c_char; } } - - bind_variable(CString::new ("OPTIND").unwrap().as_ptr(), & mut numval[i as usize], 0); - + bind_variable(CString::new ("OPTIND").unwrap().as_ptr(), &mut numval[i as usize], 0); /* If an error occurred, decide which one it is and set the return code appropriately. In all cases, the option character in error is in OPTOPT. If an invalid option was encountered, OPTARG is @@ -454,7 +452,6 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 } else { r_getopts_unbind_variable(CString::new ("OPTARG").unwrap().as_ptr() as * mut c_char); } - return ret; } @@ -465,7 +462,7 @@ pub extern "C" fn r_dogetopts(argc:i32, argv:*mut*mut c_char)->i32 strval[0] = sh_optopt as c_char; strval[1] = '\0' as c_char; - bind_variable(CString::new ("OPTARG").unwrap().as_ptr() as * mut c_char, &mut strval[1], 0); + bind_variable(CString::new ("OPTARG").unwrap().as_ptr() as * mut c_char, &mut strval[0], 0); } else { ret = r_getopts_bind_variable(name, CString::new ("?").unwrap().as_ptr() as * mut c_char); r_getopts_unbind_variable(CString::new ("OPTARG").unwrap().as_ptr() as * mut c_char); diff --git a/bash-5.1/builtins_rust/help/src/lib.rs b/bash-5.1/builtins_rust/help/src/lib.rs index f1f28737..99e69f84 100644 --- a/bash-5.1/builtins_rust/help/src/lib.rs +++ b/bash-5.1/builtins_rust/help/src/lib.rs @@ -227,8 +227,18 @@ pub extern "C" fn r_help_builtin(mut list:*mut WordList)->i32 { } } if match_found == 0{ - println! ("no help topics match {:?} .Try 'help help' or 'man -k {:?}' or info {:?}", pattern , pattern, pattern); - return EXECUTION_FAILURE!(); + let mgr = ResourceManager::new("/usr/share/utshell/resources/{locale}/{res_id}".into()); + let resources = vec![ "message.ftl".into()]; + let mut args = FluentArgs::new(); + let s1 = String::from("command"); + args.set("name",format!("{:?}",CStr::from_ptr(pattern))); + let bundle = mgr.get_bundle(get_local_str(), resources); + let mut value = bundle.get_message("helperr").unwrap(); + let mut pattern = value.value().expect("partern err"); + let mut errors = vec![]; + let mut msg1 = bundle.format_pattern(&pattern, Some(&args), &mut errors); + println!("utshell: help: {}", msg1); + return EXECUTION_FAILURE!(); } } unsafe { @@ -457,7 +467,6 @@ fn show_builtin_command_help (){ let mut width : usize; let mut t :*mut libc::c_char; let mut blurb:[libc::c_char;128] = ['0' as libc::c_char;128]; - println!("help command edit by huanhuan."); let mgr = ResourceManager::new("/usr/share/utshell/resources/{locale}/{res_id}".into()); let resources = vec!["message.ftl".into()]; let bundle = mgr.get_bundle(get_local_str(), resources); diff --git a/bash-5.1/builtins_rust/history/src/lib.rs b/bash-5.1/builtins_rust/history/src/lib.rs index 12b3a906..e1d9fd7d 100644 --- a/bash-5.1/builtins_rust/history/src/lib.rs +++ b/bash-5.1/builtins_rust/history/src/lib.rs @@ -77,19 +77,17 @@ unsafe { push_history(list); } return EXECUTION_SUCCESS; - } else if (flags & PFLAG) != 0 { + } + else if (flags & PFLAG) != 0 { if !list.is_null() { return expand_and_print_history(list); } return r_sh_chkwrite(EXECUTION_SUCCESS); - } else if (flags & DFLAG) != 0 { + } + else if (flags & DFLAG) != 0 { let c_tmp = if *delete_arg == b'-' as c_char {delete_arg.offset(1 as isize ) as *mut c_char} else {delete_arg}; range = libc::strchr(c_tmp, b'-' as c_int); - - printf(b"AAAAAAArange=%u, c_tmp=%s\n" as *const u8 as *const libc::c_char, range, c_tmp); if !range.is_null() { - printf(b"AAAAAAArange=%s\n" as *const u8 as *const libc::c_char, range); - let mut delete_start: c_long = 0; let mut delete_end: c_long = 0; @@ -161,7 +159,8 @@ unsafe { } return if result != 0 {EXECUTION_FAILURE} else {EXECUTION_SUCCESS}; } -} else if (flags & (AFLAG | RFLAG | NFLAG | WFLAG | CFLAG)) == 0 { +} + else if (flags & (AFLAG | RFLAG | NFLAG | WFLAG | CFLAG)) == 0 { result = display_history(list); return r_sh_chkwrite(result); } @@ -241,7 +240,7 @@ unsafe fn display_history(list: *mut WordList) -> c_int let mut timestr: *mut c_char; if !list.is_null() { - if r_get_numeric_arg(list, 0, std::mem::transmute(&limit)) == 0 { + if r_get_numeric_arg(list, 0,&mut limit)== 0 { return EXECUTION_FAILURE; } if limit < 0 { @@ -292,17 +291,14 @@ unsafe fn display_history(list: *mut WordList) -> c_int i += 1; } } - return EXECUTION_SUCCESS; } fn push_history(list: *mut WordList) { - println!("push_history!!!!"); unsafe { if remember_on_history != 0 && hist_last_line_pushed == 0 && (hist_last_line_added != 0 || (current_command_line_count > 0 && current_command_first_line_saved != 0 && command_oriented_history != 0)) && bash_delete_last_history() == 0 { - return; } diff --git a/bash-5.1/resources/en-US/message.ftl b/bash-5.1/resources/en-US/message.ftl index 4db71531..05caabd9 100644 --- a/bash-5.1/resources/en-US/message.ftl +++ b/bash-5.1/resources/en-US/message.ftl @@ -1707,4 +1707,6 @@ information = These shell commands are defined internally. Type `help' to s Type `help name' to find out more about the function `name'. Use `info bash' to find out more about the shell in general. Use `man -k' or `info' to find out more about commands not in this list. - A star (*) next to a name means that the command is disabled. \ No newline at end of file + A star (*) next to a name means that the command is disabled. + +helperr = "no help topics match {$name} .Try 'help help' or 'man -k {$name}' or info {$name}" \ No newline at end of file diff --git a/bash-5.1/resources/zh-CN/message.ftl b/bash-5.1/resources/zh-CN/message.ftl index 79055394..6971cd97 100644 --- a/bash-5.1/resources/zh-CN/message.ftl +++ b/bash-5.1/resources/zh-CN/message.ftl @@ -10,11 +10,13 @@ $cmdName -> 退出状态： 返回被继续的任务的状态。 -[command1] 估值条件表达式。 +[command1] + 估值条件表达式。 是内建命令 test 的同义词，但是最后一个参数必须是 字符 `]'，以匹配起始的 `['。 -[command2] 在当前 shell 中执行一个文件中的命令。 +[command2] + 在当前 shell 中执行一个文件中的命令。 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS @@ -23,18 +25,21 @@ $cmdName -> 退出状态： 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 -[command3] 空的命令。 +[command3] + 空的命令。 没有效果； 此命令不做任何操作。 退出状态： 总是成功。 -[command4] 估值条件表达式。 +[command4] + 估值条件表达式。 是内建命令 test 的同义词，但是最后一个参数必须是 字符 `]'，以匹配起始的 `['。 -[command5] 执行条件命令。 +[command5] + 执行条件命令。 根据条件表达式 EXPRESSION 的估值返回状态0或1。表达式按照 `test' 内建的相同条件组成，或者可以有下列操作符连接而成： @@ -55,7 +60,8 @@ $cmdName -> 退出状态： 根据 EXPRESSION 的值为0或1。 -[command6] 算术 for 循环。 +[command6] + 算术 for 循环。 等价于 (( EXP1 )) @@ -68,7 +74,8 @@ $cmdName -> 退出状态： 返回最后执行的命令的状态。 -[command7] 将命令组合为一个单元。 +[command7] + 将命令组合为一个单元。 运行组中的命令集合。这是对整个命令集合 做重定向的方法之一。 @@ -77,7 +84,7 @@ $cmdName -> 返回最后一个执行的命令的状态。 [set] - 设定或取消设定 shell 选项和位置参数的 + 设定或取消设定 shell 选项和位置参数的 改变 shell 选项和位置参数的值，或者显示 shell 变量的 名称和值。 @@ -154,1223 +161,1287 @@ $cmdName -> 退出状态： 返回成功除非使用了无效的参数。 - [read] 从标准输入读取一行并将其分为不同的域。 - - 从标准输入读取单独的一行，或者如果使用了 -u 选项，从文件描述符 FD 中读 - 取。 - 该行被分割成域，如同词语分割一样，并且第一个词被赋值给第一个 NAME 变量， - 第二 - 个词被赋值给第二个 NAME 变量，如此继续，直到剩下所有的词被赋值给最后一个 - NAME - 变量。只有 $IFS 变量中的字符被认作是词语分隔符。 - - 如果没有提供 NAME 变量，则读取的行被存放在 REPLY 变量中。 - - 选项： - -a array 将词语赋值给 ARRAY 数组变量的序列下标成员，从零开始 - -d delim 持续读取直到读入 DELIM 变量中的第一个字符，而不是换行符 - -e 使用 Readline 获取行 - -i text 使用 TEXT 文本作为 Readline 的初始文字 - -n nchars 读取 nchars 个字符之后返回，而不是等到读取换行符。 - 但是分隔符仍然有效，如果遇到分隔符之前读取了不足 nchars 个字符。 - -N nchars 在准确读取了 nchars 个字符之后返回，除非遇到文件结束符或者读 - 超时， - 任何的分隔符都被忽略 - -p prompt 在尝试读取之前输出 PROMPT 提示符并且不带 - 换行符 - -r 不允许反斜杠转义任何字符 - -s 不回显终端的任何输入 - -t timeout 如果在 TIMEOUT 秒内没有读取一个完整的行则超时并且返回失 - 败。 - TMOUT 变量的值是默认的超时时间。TIMEOUT 可以是小数。 - 如果 TIMEOUT 是 0，那么仅当在指定的文件描述符上输入有效的时候， - read 才返回成功；否则它将立刻返回而不尝试读取任何数据。 - 如果超过了超时时间，则返回状态码大于 128 - -u fd 从文件描述符 FD 中读取，而不是标准输入 - - 退出状态： - 返回码为零，除非遇到了文件结束符、读超时（且返回码不大于128）、 - 出现了变量赋值错误或者无效的文件描述符作为参数传递给了 -u 选项。 - - [type] 显示命令类型的信息。 - - 对于每一个 NAME 名称，指示如果作为命令它将如何被解释。 - - 选项： - -a 显示所有包含名称为 NAME 的可执行文件的位置； - 包括别名、内建和函数。仅当 `-p' 选项没有使用时 - -f 抑制 shell 函数查询 - -P 为每个 NAME 名称惊醒 PATH 路径搜索，即使它是别名、 - 内建或函数，并且返回将被执行的磁盘上文件的名称。 - -p 返回将被执行的磁盘上文件的名称，或者当 `type -t NAME' - 不返回 `file' 时，不返回任何值。 - -t 返回下列词中的任何一个 `alias'、`keyword'、 - `function'、`builtin'、`file' 或者 `'，相应地如果 NAME 是 - 一个别名、shell 保留字、shell 函数、shell 内建、 - 磁盘文件或没有找到。 - - 参数： - NAME 将要解析的命令。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - - [trap] 对信号和其他事件设陷阱。 - - 定义一个处理器，在 shell 接收到信号和其他条件下执行。 - - ARG 参数是当 shell 接收到 SIGNAL_SPEC 信号时读取和执行的命令。 - 如果没有指定 ARG 参数 (并且只给出一个 SIGNAL_SPEC 信号) 或者 - ARG 参数为 - `-'，每一个指定的参数会被重置为原始值。如果 ARG 参数是一个空串，则每一 - 个 - SIGNAL_SPEC 信号会被 shell 和它启动的命令忽略。 - - 如果一个 SIGNAL_SPEC 信号是 EXIT (0) ，则 ARG 命令会在 shell 退出时被 - 执行。如果一个 SIGNAL_SPEC 信号是 DEBUG，则 ARG命令会在每一个简单命 - 令之前执行。 - - 如果不提供参数，trap 打印列表显示每一个与每一个信号相关联的命令。 - - 选项： - -l 打印一个信号名称和它们对应的编号的列表 - -p 打印与每个 SIGNAL_SPEC 信号相关联的陷阱命令 - - 每一个 SIGNAL_SPEC 信号可以是 中的信号名称或者信号编号。 - 信号名称大小写敏感且可以使用 SIG 前缀。信号可用 \kill -信号 $$\ - 发送给 shell。 - - 返回成功，除非使用了无效的选项或者 SIGSPEC。 - - [alias] 定义或显示别名。 - - 不带参数时，`alias' 以可重用的格式 - `alias 名称=值'在标准输出设备上打印别名列表。 - - 否则，对于每个给定值的名称定义一个别名。 - 值末尾的空格会使下一个词被检测作为别名替换展开。 - - 选项： - -p 以可重用的格式打印所有的已定义的别名 - - 退出状态： - 除非一个没有定义的名字被作为参数提供，否则 alias - 返回值为真。 - - [unalias] 从别名定义列表中删除每一个“名字”。 - - 选项： - -a 删除所有的别名定义 - - 返回成功，除非“名字”不是一个已存在的别名。 - - [break] 退出 for、while 或 until 循环 - - 退出一个 FOR、WHILE 或 UNTIL 循环。如果指定了N，则跳出N重 - 循环 - - 退出状态： - 退出状态为0除非 N 不大于或等于 1。 - - [continue] 继续 for、while 或 until 循环。 - - 继续当前 FOR、WHILE 或 UNTIL 循环的下一步。 - 如果指定了 N， 则继续当前的第 N 重循环。 - - 退出状态： - 退出状态为 0 除非 N 不大于或等于1。 - - [builtin] 执行 shell 内建。 - - 带参数 ARGs 执行 SHELL-BUILTIN 内建，并且不做命令查询 - 在希望以 shell 函数的形式来重新实现 shell 内建， - 并且希望在函数之内执行该 shell 内建的情况下有用处。 - - 退出状态： - 以 SHELL-BUILTIN 内建的退出状态为准，或者如果 SHELL-BUILTIN 不是一个 - shell 内建时为假。 - - [caller] 返回当前子调用的上下文。 - - 不带有 EXPR 时，返回 \$line $filename\。带有 EXPR 时，返回 - \$line $subroutine $filename\；这个额外的信息可以被用于提供 - 栈追踪。 - - EXPR 的值 显示了到当前调用帧需要回去多少个调用帧；顶部帧 - 是第 0 帧。 - - 退出状态： - 除非 shell 不在执行一个 shell 函数或者 EXPR 无效，否则返回结 - 果为0。 - - [cd]改变 shell 工作目录。 - - 改变当前目录至 DIR 目录。默认的 DIR 目录是 shell 变量 HOME - 的值。 - - 变量 CDPATH 定义了含有 DIR 的目录的搜索路径，其中不同的目录名称由冒号 (:) - 分隔。 - 一个空的目录名称表示当前目录。如果要切换到的 DIR 由斜杠 (/) 开头，则 - CDPATH - 不会用上变量。 - - 如果路径找不到，并且 shell 选项 `cdable_vars' 被设定，则参数词被假定为一 - 个 - 变量名。如果该变量有值，则它的值被当作 DIR 目录。 - - 选项： - -L 强制跟随符号链接: 在处理 `..' 之后解析 DIR 中的符号链接。 - -P 使用物理目录结构而不跟随符号链接: 在处理 `..' 之前解析 DIR 中的符 - 号链接。 - -e 如果使用了 -P 参数，但不能成功确定当前工作目录时，返回非零的返回 - 值。 - -@ 在支持拓展属性的系统上，将一个有这些属性的文件当作有文件属性的目 - 录。 - - 默认情况下跟随符号链接，如同指定 `-L'。 - `..' 使用移除向前相邻目录名成员直到 DIR 开始或一个斜杠的方式处理。 - - 退出状态： - 如果目录改变，或在使用 -P 选项时 $PWD 修改成功时返回 0，否则非零。 - - [pwd]打印当前工作目录的名字。 - - 选项： - -L 打印 $PWD 变量的值，如果它包含了当前的工作目录 - -P 打印当前的物理路径，不带有任何的符号链接 - - 默认情况下，`pwd' 的行为和带 `-L' 选项一致 - - 退出状态： - 除非使用了无效选项或者当前目录不可读，否则返回状态为0。 - - [true]空的命令。 - - 没有效果； 此命令不做任何操作。 - - 退出状态： - 总是成功。 - [shopt] 设定和取消设定 shell 选项。 - - 改变每个 shell 选项 OPTNAME 的设定。不带参数时， - 列出每个提供的 OPTNAME，否则列出所有 shell 选项； - 同时标注每一个选项是否被设定。 - - 选项： - -o 限制 OPTNAME 为定义用于`set -o' 的选项 - -p 打印每个 shell 选项并标注它的状态。 - -q 抑制输出 - -s 启用(设定)每个 OPTNAME 选项 - -u 禁用(取消设定)每个 OPTNAME 选项 - - 退出状态： - 如果 OPTNAME 选项被启用则返回成功；如果是 - 无效的选项或 OPTNAME 被禁用则失败。 - - [false] 返回一个不成功的结果。 - - 退出状态： - 总是失败。 - - [command] 执行一个简单命令或者显示命令的相关信息。 - - 带 ARGS 参数运行 COMMAND 命令且抑制 shell 函数查询，或显示 - 指定的 COMMAND 命令的信息。可以在存在相同名称的函数定义的 - 情况下用于启动磁盘上的命令。 - - 选项： - -p 使用 PATH 变量的一个默认值以确保所有的标准工具都能被找到。 - -v 打印 COMMAND 命令的描述，和 `type' 内建相似 - -V 打印每个 COMMAND 命令的详细描述 - - 退出状态 - 返回 COMMAND 命令的返回状态，或者当找不到 COMMAND 命令时失败。 - - [echo] 将参数写到标准输出。 - - 在标准输出上，显示用空格分割的 ARG 参数后跟一个换行。 - - 选项： - -n 不要追加换行 - -e 启用下列反斜杠转义的解释 - -E 显式地抑制对于反斜杠转义的解释 - - `echo' 对下列反斜杠字符进行转义： - \a 警告(响铃) - \\b 退格 - \\c 抑制更多的输出 - \\e 转义字符 - \\f 换页字符 - \\t换行 - \\r\t回车 - \\t\t横向制表符 - \\v\t纵向制表符 - \\\\\t反斜杠 - \\0nnn 以 NNN（八进制）为 ASCII 码的字符。NNN 可以是 0 到 3 个八进制 - 位 - \\xHH 以 HH（十六进制）为值的八比特字符。HH 可以是一个或两个十六进制 - 位 - \\uHHHH 以 HHHH（十六进制）为值的 Unicode 字符。HHHH 可以是一个到 - 四个十六进制位。 - \\UHHHHHHHH 以 HHHHHHHH（十六进制）为值的 Unicode 字符。 - HHHHHHHH 可以是一到八个十六进制位。 - - 退出状态： - 返回成功除非有写错误发生。 - - 写参数至标准输出设备。 - - 在标准输出设备上显示 ARGs 参数和一个换行。 - - 选项： - -n 不附加换行 - - 退出状态： - 除非写错误发生，否则返回成功。 - - [enable] 启用和禁用 shell 内建。 - - 启用和禁用 shell 的内建命令。禁用使您能够执行一个和内建 - 命令同名的磁盘上的命令，而无须使用完整的路径名。 - - - 选项： - -a 打印一个内建的列表，并显示其中每一个是否启用 - -n 禁用每一个 NAME 内建或者显示一个被禁用的内建的列表 - -p 以可重用的格式打印一个内建的列表 - -s 仅打印Posix `special' 内建的名称 - - 控制动态加载的选项： - -f 从共享对象 FILENAME 文件中加载 NAME 内建 - -d 删除以 -f 选项加载的内建 - - 不带选项时，每一个 NAME 内建都被启用。 - - 如果要使用 $PATH 中找到的 `test' 而不是 shell 内建的版本， - 输入 `enable -n test'。 - - 退出状态： - 返回成功，除非 NAME 不是一个 shell 内建或者有错误发生。 - - [getopts] 解析选项参数。 - - getopts 被 shell 过程用于解析可定位的参数作为选项。 - +[read] + 从标准输入读取一行并将其分为不同的域。 - OPTSTRING 字符串包含待识别的选项字母；如果一个字母后面跟 - 着分号，则该选项需要一个参数，而该参数应用空格与选项分开。 + 从标准输入读取单独的一行，或者如果使用了 -u 选项，从文件描述符 FD 中读 + 取。 + 该行被分割成域，如同词语分割一样，并且第一个词被赋值给第一个 NAME 变量， + 第二 + 个词被赋值给第二个 NAME 变量，如此继续，直到剩下所有的词被赋值给最后一个 + NAME + 变量。只有 $IFS 变量中的字符被认作是词语分隔符。 + 如果没有提供 NAME 变量，则读取的行被存放在 REPLY 变量中。 - 每次启动时，getopts 会将下一个选项放到 shell 变量 $name - 中，如果 name 变量不存在则先将其初始化，而下一个待处 - 理的参数序号放入 shell 变量 OPTIND 中。OPTIND 变量在每 - 次 shell 或者 shell 脚本启动时都被初始化为1。当一个选项要 - 求有一个参数时，getopts 将参数放入 shell 变量 OPTARG - 中。 - - getopts 有两种报告错误的方法。如果 OPTSTRING 变量的第 - 一个字符是冒号，getopts 使用沉默错误报告。在这种模式 - 下，不会打印错误消息。如果看到了一个无效的选项， - getopts 将找到的选项字符放至 OPTARG 变量中。如果一个必 - 须的选项没有找到，getopts 放一个 ':' 到 NAME 变量中并且设 - 置 OPTARG 变量为找到的选项字符。如果 getopts 不在沉默模 - 式中，并且遇到了一个无效的选项，getopts 放置一个 '?' 到 NAME - 变量中并且取消设定 OPTARG变量。如果必须的选项没有找到， - 一个'?'会被放入 NAME变量中，OPTARG 将被取消设定，并且会 - 打印一个诊断信息。 - - 如果 shell 变量 OPTERR 的值为0，getopts 禁用 - 错误信息的打印，即使 OPTSTRING 变量的第一个字符不是一 - 个冒号。OPTERR 的默认值为1. + 选项： + -a array 将词语赋值给 ARRAY 数组变量的序列下标成员，从零开始 + -d delim 持续读取直到读入 DELIM 变量中的第一个字符，而不是换行符 + -e 使用 Readline 获取行 + -i text 使用 TEXT 文本作为 Readline 的初始文字 + -n nchars 读取 nchars 个字符之后返回，而不是等到读取换行符。 + 但是分隔符仍然有效，如果遇到分隔符之前读取了不足 nchars 个字符。 + -N nchars 在准确读取了 nchars 个字符之后返回，除非遇到文件结束符或者读 + 超时，任何的分隔符都被忽略 + -p prompt 在尝试读取之前输出 PROMPT 提示符并且不带换行符 + -r 不允许反斜杠转义任何字符 + -s 不回显终端的任何输入 + -t timeout 如果在 TIMEOUT 秒内没有读取一个完整的行则超时并且返回失 + 败。TMOUT 变量的值是默认的超时时间。TIMEOUT 可以是小数。 + 如果 TIMEOUT 是 0，那么仅当在指定的文件描述符上输入有效的时候， + read 才返回成功；否则它将立刻返回而不尝试读取任何数据。 + 如果超过了超时时间，则返回状态码大于 128 + -u fd 从文件描述符 FD 中读取，而不是标准输入 + + 退出状态： + 返回码为零，除非遇到了文件结束符、读超时（且返回码不大于128）、 + 出现了变量赋值错误或者无效的文件描述符作为参数传递给了 -u 选项。 + +[type] + 显示命令类型的信息。 + + 对于每一个 NAME 名称，指示如果作为命令它将如何被解释。 - getopts 通常解析可定位的参数($0 - $9)，不过如果提供了 - 更多的参数，它们反而会被解析。 + 选项： + -a 显示所有包含名称为 NAME 的可执行文件的位置； + 包括别名、内建和函数。仅当 `-p' 选项没有使用时 + -f 抑制 shell 函数查询 + -P 为每个 NAME 名称惊醒 PATH 路径搜索，即使它是别名、 + 内建或函数，并且返回将被执行的磁盘上文件的名称。 + -p 返回将被执行的磁盘上文件的名称，或者当 `type -t NAME' + 不返回 `file' 时，不返回任何值。 + -t 返回下列词中的任何一个 `alias'、`keyword'、 + `function'、`builtin'、`file' 或者 `'，相应地如果 NAME 是 + 一个别名、shell 保留字、shell 函数、shell 内建、 + 磁盘文件或没有找到。 + + 参数： + NAME 将要解析的命令。 - 退出状态： - 如果一个选项被找到则返回成功；如果遇到了选项的结尾或者 - 有错误发生则返回失败。 + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - [exec] 使用指定命令替换 shell。 - - 执行 COMMAND 命令，以指定的程序替换这个 shell。 - ARGUMENTS 参数成为 COMMAND命令的参数。如果 - 没有指定COMMAND 命令，则任何的重定向在当前 shell 中生效。 - - 选项： - -a 名称 作为第0个参数传递给 COMMAND 命令 - -c 在一个空环境中执行 COMMAND 命令 - -l 在COMMAND 命令的第0个参数中加一个短线 - - 如果命令不能被执行，则退出一个非交互式的 shell，除非 - shell 选项`execfail' 已经设定。 - - 退出状态： - 返回成功除非 COMMAND 命令没有找到或者出现一个重定向错误。 +[trap] + 对信号和其他事件设陷阱。 + + 定义一个处理器，在 shell 接收到信号和其他条件下执行。 + + ARG 参数是当 shell 接收到 SIGNAL_SPEC 信号时读取和执行的命令。 + 如果没有指定 ARG 参数 (并且只给出一个 SIGNAL_SPEC 信号) 或者 + ARG 参数为 + `-'，每一个指定的参数会被重置为原始值。如果 ARG 参数是一个空串，则每一 + 个 + SIGNAL_SPEC 信号会被 shell 和它启动的命令忽略。 + + 如果一个 SIGNAL_SPEC 信号是 EXIT (0) ，则 ARG 命令会在 shell 退出时被 + 执行。如果一个 SIGNAL_SPEC 信号是 DEBUG，则 ARG命令会在每一个简单命 + 令之前执行。 + + 如果不提供参数，trap 打印列表显示每一个与每一个信号相关联的命令。 + + 选项： + -l 打印一个信号名称和它们对应的编号的列表 + -p 打印与每个 SIGNAL_SPEC 信号相关联的陷阱命令 + + 每一个 SIGNAL_SPEC 信号可以是 中的信号名称或者信号编号。 + 信号名称大小写敏感且可以使用 SIG 前缀。信号可用 \kill -信号 $$\ + 发送给 shell。 + + 返回成功，除非使用了无效的选项或者 SIGSPEC。 - [exit] 退出shell。 - - 以状态 N 退出 shell。 如果 N 被省略，则退出状态 - 为最后一个执行的命令的退出状态。 +[alias] + 定义或显示别名。 + + 不带参数时，`alias' 以可重用的格式 + `alias 名称=值'在标准输出设备上打印别名列表。 + + 否则，对于每个给定值的名称定义一个别名。 + 值末尾的空格会使下一个词被检测作为别名替换展开。 + + 选项： + -p 以可重用的格式打印所有的已定义的别名 + + 退出状态： + 除非一个没有定义的名字被作为参数提供，否则 alias + 返回值为真。 - [logout] 退出一个登录 shell. - - 以状态 N 退出一个登录 shell。如果不在登录 shell 中执行，则 - 返回一个错误。 +[unalias] + 从别名定义列表中删除每一个“名字”。 + + 选项： + -a 删除所有的别名定义 + + 返回成功，除非“名字”不是一个已存在的别名。 - [fc] 从历史列表中显示或者执行命令。 - - fc 被用于从历史列表中列出或者重新编辑并执行命令。 - FIRST 和 LAST 变量可以是数字用于指定范围，或者 FIRST 可以是 - 字符串，意味着以这个字符串打头的最近的一个命令。 - - - 选项： - -e ENAME 选择使用哪个编辑器。默认的是 FCEDIT, 然后是 EDITOR， - 然后是 vi - -l 列出行而不编辑 - -n 列举时省略行号 - -r 反转行的顺序(最新行在前) - - 用 `fc -s [模式=替换 ...] [命令]' 的格式，COMMAND 命令会在 OLD=NEW - 替换之后被重新执行。 - - r='fc -s' 是一个有用的别名，这样的话输入 `r cc'会执行最后一个以 `cc' - 开头的命令，输入 `r'会重新执行最后一个命令。 - - - 退出状态： - 返回成功，或者执行的命令的状态；如果错误发生则返回非零。 +[break] + 退出 for、while 或 until 循环 + + 退出一个 FOR、WHILE 或 UNTIL 循环。如果指定了N，则跳出N重 + 循环 + + 退出状态： + 退出状态为0除非 N 不大于或等于 1。 - [fg] 将任务移至前台。 - - 将以 JOB_SPEC 标识的任务放至前台，使其成为 - 当前任务。如果 JOB_SPEC 不存在，shell 观念中的当前任务 - 将被使用。 - - 退出状态： - 放至前台的命令状态，或者当错误发生时为失败。 +[continue] + 继续 for、while 或 until 循环。 + + 继续当前 FOR、WHILE 或 UNTIL 循环的下一步。 + 如果指定了 N， 则继续当前的第 N 重循环。 + + 退出状态： + 退出状态为 0 除非 N 不大于或等于1。 - [bg] 移动任务至后台。 - - 将 JOB_SPEC 标识的任务放至后台，就像它们 - 是带 `&' 启动的一样。如果 JOB_SPEC 不存在，shell 观念中的 - 当前任务将会被使用。 - - 退出状态： - 返回成功除非任务管理没有启用或者错误发生。 +[builtin] + 执行 shell 内建。 + + 带参数 ARGs 执行 SHELL-BUILTIN 内建，并且不做命令查询 + 在希望以 shell 函数的形式来重新实现 shell 内建， + 并且希望在函数之内执行该 shell 内建的情况下有用处。 + + 退出状态： + 以 SHELL-BUILTIN 内建的退出状态为准，或者如果 SHELL-BUILTIN 不是一个 + shell 内建时为假。 - [hash] 记住或显示程序位置。 - - 确定并记住每一个给定 NAME 名称的命令的完整路径。 - 如果不提供参数，则显示已经记住的命令的信息。 - - 选项： - -d 忘记每一个已经记住的 NAME 的位置 - -l 以可作为输入重用的格式显示 - -p pathname 使用 pathname 路径作为 NAME 命令的全路径 - -r 忘记所有记住的位置 - -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 - NAME 名称，则每个位置前面会加上相应的 NAME 名称 - - 参数： - NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 - 令 - 列表中。 - - 退出状态： - 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 +[caller] + 返回当前子调用的上下文。 + + 不带有 EXPR 时，返回 $line $filename。带有 EXPR 时，返回 + $line $subroutine $filename；这个额外的信息可以被用于提供 + 栈追踪。 + + EXPR 的值 显示了到当前调用帧需要回去多少个调用帧；顶部帧 + 是第 0 帧。 + + 退出状态： + 除非 shell 不在执行一个 shell 函数或者 EXPR 无效，否则返回结 + 果为0。 - [help] 显示内建命令的相关信息。 - - 显示内建命令的简略信息。如果指定了 PATTERN 模式， - 给出所有匹配 PATTERN 模式的命令的详细帮助，否则打 - 印一个帮助主题列表 - - 选项： - -d 输出每个主题的简短描述 - -m 以伪 man 手册的格式显示使用方法 - -s 为每一个匹配 PATTERN 模式的主题仅显示一个用法 - 简介 - - 参数： - PATTERN 指定帮助主题的模式 - - 退出状态： - 返回成功，除非未找到 PATTERN 模式没有找到或者使用了无效选项。 +[cd] + 改变 shell 工作目录。 + + 改变当前目录至 DIR 目录。默认的 DIR 目录是 shell 变量 HOME + 的值。 + + 变量 CDPATH 定义了含有 DIR 的目录的搜索路径，其中不同的目录名称由冒号 (:) + 分隔。 + 一个空的目录名称表示当前目录。如果要切换到的 DIR 由斜杠 (/) 开头，则 + CDPATH + 不会用上变量。 + + 如果路径找不到，并且 shell 选项 `cdable_vars' 被设定，则参数词被假定为一 + 个 + 变量名。如果该变量有值，则它的值被当作 DIR 目录。 + + 选项： + -L 强制跟随符号链接: 在处理 `..' 之后解析 DIR 中的符号链接。 + -P 使用物理目录结构而不跟随符号链接: 在处理 `..' 之前解析 DIR 中的符 + 号链接。 + -e 如果使用了 -P 参数，但不能成功确定当前工作目录时，返回非零的返回 + 值。 + -@ 在支持拓展属性的系统上，将一个有这些属性的文件当作有文件属性的目 + 录。 + + 默认情况下跟随符号链接，如同指定 `-L'。 + `..' 使用移除向前相邻目录名成员直到 DIR 开始或一个斜杠的方式处理。 + + 退出状态： + 如果目录改变，或在使用 -P 选项时 $PWD 修改成功时返回 0，否则非零。 + +[pwd] + 打印当前工作目录的名字。 + + 选项： + -L 打印 $PWD 变量的值，如果它包含了当前的工作目录 + -P 打印当前的物理路径，不带有任何的符号链接 + + 默认情况下，`pwd' 的行为和带 `-L' 选项一致 + + 退出状态： + 除非使用了无效选项或者当前目录不可读，否则返回状态为0。 - [history] 显示或操纵历史列表。 - - 带行号显示历史列表，将每个被修改的条目加上 `*' 前缀。 - 参数 N 会仅列出最后的 N 个条目。 - - 选项： - -c 删除所有条目从而清空历史列表。 - -d 偏移量 从指定位置删除历史列表。负偏移量将从历史条目末尾 - 开始计数 - - -a 将当前会话的历史行追加到历史文件中 - -n 从历史文件中读取所有未被读取的行 - 并且将它们附加到历史列表 - -r 读取历史文件并将内容追加到历史列表中 - -w 将当前历史写入到历史文件中 - - -p 对每一个 ARG 参数展开历史并显示结果，而不存储到历史列表中 - -s 以单条记录追加 ARG 到历史列表中 - - 如果给定了 FILENAME 文件名，则它将被作为历史文件。否则 - 如果 $HISTFILE 变量有值的话使用之，不然使用 ~/.bash_history 文件。 - - 如果 $HISTTIMEFORMAT 变量被设定并且不为空，它的值会被用于 - strftime(3) 的格式字符串来打印与每一个显示的历史条目想关联的 - 时间戳，否则不打印时间戳。 - - 退出状态： - 返回成功，除非使用了无效的选项或者发生错误。 - [jobs] 显示任务状态。 - - 列出活动的任务。JOBSPEC 限制仅输出指定的任务。 - 不带选项时，所有活动任务的状态都会显示。 - - 选项： - -l 在正常信息基础上列出进程号 - -n 仅列出上次通告之后改变了状态的进程 - -p 仅列出进程号 - -r 限制仅输出运行中的任务 - -s 限制仅输出停止的任务 - - 如果使用了 -x 选项，ARG 参数中的所有任务声明会被替换为该任务 - 的进程组头领的进程号，然后执行 COMMAND 命令。 - - 退出状态： - 返回成功，除非使用了无效的选项或者有错误发生。 - 如果使用 -x 选项，则返回 COMMAND 命令的退出状态。 +[true] + 空的命令。 + + 没有效果； 此命令不做任何操作。 + + 退出状态： + 总是成功。 + +[shopt] + 设定和取消设定 shell 选项。 + + 改变每个 shell 选项 OPTNAME 的设定。不带参数时， + 列出每个提供的 OPTNAME，否则列出所有 shell 选项； + 同时标注每一个选项是否被设定。 + + 选项： + -o 限制 OPTNAME 为定义用于`set -o' 的选项 + -p 打印每个 shell 选项并标注它的状态。 + -q 抑制输出 + -s 启用(设定)每个 OPTNAME 选项 + -u 禁用(取消设定)每个 OPTNAME 选项 + + 退出状态： + 如果 OPTNAME 选项被启用则返回成功；如果是 + 无效的选项或 OPTNAME 被禁用则失败。 - [disown] 从当前 shell 中删除任务。 - - 从活动任务表中删除每一个 JOBSPEC 参数。不带任何 - JOBSPEC 参数时，shell 使用观念中的当前任务。 - - 选项： - -a 如果不提供 JOBSPEC 参数，则删除所有任务 - -h 标识每个 JOBSPEC 任务，从而当 shell 接收到 SIGHUP - 信号时不发送 SIGHUP 给指定任务 - -r 仅删除运行中的任务 - - 退出状态： - 返回成功除非使用了无效的选项或者 JOBSPEC 声明。 +[false] + 返回一个不成功的结果。 + + 退出状态： + 总是失败。 + +[command] + 执行一个简单命令或者显示命令的相关信息。 + + 带 ARGS 参数运行 COMMAND 命令且抑制 shell 函数查询，或显示 + 指定的 COMMAND 命令的信息。可以在存在相同名称的函数定义的 + 情况下用于启动磁盘上的命令。 + + 选项： + -p 使用 PATH 变量的一个默认值以确保所有的标准工具都能被找到。 + -v 打印 COMMAND 命令的描述，和 `type' 内建相似 + -V 打印每个 COMMAND 命令的详细描述 + + 退出状态 + 返回 COMMAND 命令的返回状态，或者当找不到 COMMAND 命令时失败。 + +[echo] + 将参数写到标准输出。 + + 在标准输出上，显示用空格分割的 ARG 参数后跟一个换行。 + + 选项： + -n 不要追加换行 + -e 启用下列反斜杠转义的解释 + -E 显式地抑制对于反斜杠转义的解释 + + `echo' 对下列反斜杠字符进行转义： + \a 警告(响铃) + \\b 退格 + \\c 抑制更多的输出 + \\e 转义字符 + \\f 换页字符 + \\t换行 + \\r\t回车 + \\t\t横向制表符 + \\v\t纵向制表符 + \\\\\t反斜杠 + \\0nnn 以 NNN（八进制）为 ASCII 码的字符。NNN 可以是 0 到 3 个八进制 + 位 + \\xHH 以 HH（十六进制）为值的八比特字符。HH 可以是一个或两个十六进制 + 位 + \\uHHHH 以 HHHH（十六进制）为值的 Unicode 字符。HHHH 可以是一个到 + 四个十六进制位。 + \\UHHHHHHHH 以 HHHHHHHH（十六进制）为值的 Unicode 字符。 + HHHHHHHH 可以是一到八个十六进制位。 + + 退出状态： + 返回成功除非有写错误发生。 + + 写参数至标准输出设备。 + + 在标准输出设备上显示 ARGs 参数和一个换行。 + + 选项： + -n 不附加换行 + + 退出状态： + 除非写错误发生，否则返回成功。 + +[enable] + 启用和禁用 shell 内建。 + + 启用和禁用 shell 的内建命令。禁用使您能够执行一个和内建 + 命令同名的磁盘上的命令，而无须使用完整的路径名。 + + + 选项： + -a 打印一个内建的列表，并显示其中每一个是否启用 + -n 禁用每一个 NAME 内建或者显示一个被禁用的内建的列表 + -p 以可重用的格式打印一个内建的列表 + -s 仅打印Posix `special' 内建的名称 + + 控制动态加载的选项： + -f 从共享对象 FILENAME 文件中加载 NAME 内建 + -d 删除以 -f 选项加载的内建 + + 不带选项时，每一个 NAME 内建都被启用。 + + 如果要使用 $PATH 中找到的 `test' 而不是 shell 内建的版本， + 输入 `enable -n test'。 + + 退出状态： + 返回成功，除非 NAME 不是一个 shell 内建或者有错误发生。 - [kill] 向一个任务发送一个信号。 - - 向以 PID 进程号或者 JOBSPEC 任务声明指定的进程发送一个以 - SIGSPEC 信号声明或 SIGNUM 信号编号命名的信号。如果没有指定 - SIGSPEC 或 SIGNUM，那么假定发送 SIGTERM 信号。 - - 选项： - -s sig SIG 是信号名称 - -n sig SIG 是信号编号 - -l 列出信号名称；如果参数后跟 `-l'则被假设为信号编号， - 而相应的信号名称会被列出 - - Kill 成为 shell 内建有两个理由：它允许使用任务编号而不是进程号， - 并且在可以创建的进程数上限达到是允许进程被杀死。 - - 退出状态： - 返回成功，除非使用了无效的选项或者有错误发生。 - - [let] 估值算术表达式。 - - 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 - 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 - 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 - 优先级从高至低。 - - - \tid++, id--\t变量后置加，后置减 - \t++id, --id\t变量前置加，前置减 - \t-, +\t\t一元减法，一元加法 - \t!, ~\t\t逻辑和位取反 - \t**\t\t指数 - \t*, /, %\t\t乘法，除法，取余数 - \t+, -\t\t增加，减少 - \t<<, >>\t\t向左和向右按位移位 - \t<=, >=, <, >\t比较 - \t==, !=\t\t等于，不等于 - \t&\t\t按位与 - \t^\t\t按位异或 - \t|\t\t按位或 - \t&&\t\t逻辑与 - \t||\t\t逻辑或 - \texpr ? expr : expr - \t\t\t条件操作符 - \t=, *=, /=, %=, - \t+=, -=, <<=, >>=, - \t&=, ^=, |=\t赋值 - - Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 - (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 - - 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 - 规则。 +[getopts] + 解析选项参数。 + + getopts 被 shell 过程用于解析可定位的参数作为选项。 + + + OPTSTRING 字符串包含待识别的选项字母；如果一个字母后面跟 + 着分号，则该选项需要一个参数，而该参数应用空格与选项分开。 + + + 每次启动时，getopts 会将下一个选项放到 shell 变量 $name + 中，如果 name 变量不存在则先将其初始化，而下一个待处 + 理的参数序号放入 shell 变量 OPTIND 中。OPTIND 变量在每 + 次 shell 或者 shell 脚本启动时都被初始化为1。当一个选项要 + 求有一个参数时，getopts 将参数放入 shell 变量 OPTARG + 中。 + + getopts 有两种报告错误的方法。如果 OPTSTRING 变量的第 + 一个字符是冒号，getopts 使用沉默错误报告。在这种模式 + 下，不会打印错误消息。如果看到了一个无效的选项， + getopts 将找到的选项字符放至 OPTARG 变量中。如果一个必 + 须的选项没有找到，getopts 放一个 ':' 到 NAME 变量中并且设 + 置 OPTARG 变量为找到的选项字符。如果 getopts 不在沉默模 + 式中，并且遇到了一个无效的选项，getopts 放置一个 '?' 到 NAME + 变量中并且取消设定 OPTARG变量。如果必须的选项没有找到， + 一个'?'会被放入 NAME变量中，OPTARG 将被取消设定，并且会 + 打印一个诊断信息。 + + 如果 shell 变量 OPTERR 的值为0，getopts 禁用 + 错误信息的打印，即使 OPTSTRING 变量的第一个字符不是一 + 个冒号。OPTERR 的默认值为1. + + getopts 通常解析可定位的参数($0 - $9)，不过如果提供了 + 更多的参数，它们反而会被解析。 + + 退出状态： + 如果一个选项被找到则返回成功；如果遇到了选项的结尾或者 + 有错误发生则返回失败。 - [shift] 移位位置参数。 - - 重命名位置参数 $N+1、$N+2 ... 到 $1、$2 ... 如果没有给定 N， - 则假设为1. - - 退出状态： - 返回成功，除非 N 为负或者大于 $#。 - 返回 N，或者如果 shell 不在执行一个函数或引用脚本时，失败。 +[exec] + 使用指定命令替换 shell。 + + 执行 COMMAND 命令，以指定的程序替换这个 shell。 + ARGUMENTS 参数成为 COMMAND命令的参数。如果 + 没有指定COMMAND 命令，则任何的重定向在当前 shell 中生效。 + + 选项： + -a 名称 作为第0个参数传递给 COMMAND 命令 + -c 在一个空环境中执行 COMMAND 命令 + -l 在COMMAND 命令的第0个参数中加一个短线 + + 如果命令不能被执行，则退出一个非交互式的 shell，除非 + shell 选项`execfail' 已经设定。 + + 退出状态： + 返回成功除非 COMMAND 命令没有找到或者出现一个重定向错误。 - [suspend] 挂起 shell 执行。 - - 挂起 shell 的执行直到收到 SIGCONT 信号。 - 登录 shell 不可以被挂起，除非强制执行。 - - 选项： - -f 强制挂起，即使是登录 shell。 - - 退出状态： - 返回成功，除非没有启用任务控制或者有错误发生。 +[exit] + 退出shell。 + + 以状态 N 退出 shell。 如果 N 被省略，则退出状态 + 为最后一个执行的命令的退出状态。 - [eval] 对条件表达式进行估值。 - - 根据 EXPR 表达式的估值以状态 0 (真) 或 1 (伪) 退出。 - 表达式可以是一元或者二元的。一元表达式通常用于检测 - 文件状态。同时还有字符串操作符和数字比较操作符。 - - 文件操作符： - - -a 文件 如果文件存在则为真。 - -b 文件 如果文件为块特殊文件则为真。 - -c 文件 如果文件为字符特殊文件则为真。 - -d 文件 如果文件为目录则为真。 - -e 文件 如果文件存在则为真。 - -f 文件 如果文件存在且为常规文件则为真。 - -g 文件 如果文件的组属性设置打开则为真。 - -h 文件 如果文件为符号链接则为真。 - -L 文件 如果文件为符号链接则为真。 - -k 文件 如果文件的粘滞 (sticky) 位设定则为真。 - -p 文件 如果文件为命名管道则为真。 - -r 文件 如果文件对于您是可读的则为真。 - -s 文件 如果文件存在且不为空则为真。 - -S 文件 如果文件是套接字则为真。 - -t 文件描述符 如果文件描述符在一个终端上打开则为真。 - -u 文件 如果文件的用户数行设置打开则为真。 - -w 文件 如果文件对您是可写的则为真 - -x 文件 如果文件对您是可执行的则为真。 - -O 文件 如果文件是被您所有的则为真。 - -G 文件 如果文件被您的组所有则为真。 - -N 文件 如果文件上次被读取之后修改过则为真。 - - FILE1 -nt FILE2 如果 file1 文件新于 file2 文件则为真(根据 - 修改日期)。 - - FILE1 -ot FILE2 如果 file1 文件旧于 file2 文件则为真。 - - FILE1 -ef FILE2 如果 file1 文件是 file2 文件的硬链接则为真。 - - 字符串操作符 - - -z 字符串 如果字符串为空则为真。 - - -n 字符串 - 字符串 如果字符串不为空则为真。 - - STRING1 = STRING2 - 如果 string1 和 string2 字符串相同则为真。 - STRING1 != STRING2 - 如果 string1 和 string2 字符串不相同则为真。 - STRING1 < STRING2 - 如果按字典排序 string1 在 string2 串之前则为真。 - STRING1 > STRING2 - 如果按字典排序 string1 在 string2 串之前则为真。 - - 其他操作符： - - -o 选项 如果指定 shell 选项启用则为真。 - -v VAR 如果指定 Shell 变量 VAR 已赋值则为真。 - -R VAR 如果指定 Shell 变量 VAR 已赋值且为名称引用则为真。 - ! EXPR 如果表达式 expr 为假则为真。 - EXPR1 -a EXPR2 如果 expr1 和 expr2 都为真则为真。 - EXPR1 -o EXPR2 如果 expr1 和 expr2 有一个为真则为真。 - - arg1 OP arg2 算术测试。OP操作符可以是 -eq、-ne、 - -lt、-le、-gt、或 -ge 中的一个。 - - 二元算术操作返回真，如果 ARG1 参数等于、不等于、 - 小于、小于等于、大于、或者大于等于 ARG2 参数。 - - 退出状态： - 如果 EXPR 表达式估值为真则返回成功；如果 EXPR 表达式估值 - 为假或者使用了无效的参数则返回失败。 +[logout] + 退出一个登录 shell. + + 以状态 N 退出一个登录 shell。如果不在登录 shell 中执行，则 + 返回一个错误。 - [times] 显示进程时间 - - 打印 shell 及其所有子进程的累计用户空间和 - 系统空间执行时间。 - - 退出状态 - 总是成功。 +[fc] + 从历史列表中显示或者执行命令。 + + fc 被用于从历史列表中列出或者重新编辑并执行命令。 + FIRST 和 LAST 变量可以是数字用于指定范围，或者 FIRST 可以是 + 字符串，意味着以这个字符串打头的最近的一个命令。 + + + 选项： + -e ENAME 选择使用哪个编辑器。默认的是 FCEDIT, 然后是 EDITOR， + 然后是 vi + -l 列出行而不编辑 + -n 列举时省略行号 + -r 反转行的顺序(最新行在前) + + 用 `fc -s [模式=替换 ...] [命令]' 的格式，COMMAND 命令会在 OLD=NEW + 替换之后被重新执行。 + + r='fc -s' 是一个有用的别名，这样的话输入 `r cc'会执行最后一个以 `cc' + 开头的命令，输入 `r'会重新执行最后一个命令。 + + + 退出状态： + 返回成功，或者执行的命令的状态；如果错误发生则返回非零。 - [ulimit] 修改 shell 资源限制。 - - 在允许此类控制的系统上，提供对于 shell 及其创建的进程所可用的 - 资源的控制。 - - 选项： - -S 使用软 (`soft') 资源限制 - -H 使用硬 (`hard') 资源限制 - -a 所有当前限制都被报告 - -b 套接字缓存尺寸 - -c 创建的核文件的最大尺寸 - -d 一个进程的数据区的最大尺寸 - -e 最高的调度优先级 (`nice') - -f 有 shell 及其子进程可以写的最大文件尺寸 - -i 最多的可以挂起的信号数 - -k 分配给此进程的最大 kqueue 数量 - -l 一个进程可以锁定的最大内存尺寸 - -m 最大的内存进驻尺寸 - -n 最多的打开的文件描述符个数 - -p 管道缓冲区尺寸 - -q POSIX 信息队列的最大字节数 - -r 实时调度的最大优先级 - -s 最大栈尺寸 - -t 最大的CPU时间，以秒为单位 - -u 最大用户进程数 - -v 虚拟内存尺寸 - -x 最大的文件锁数量 - -P 最大伪终端数量 - -T 最大线程数量 - - 并非所有选项在所有系统上可用。 - - 如果提供了 LIMIT 变量，则它为指定资源的新的值；特别的 LIMIT 值为 - `soft'、`hard'和`unlimited'，分别表示当前的软限制，硬限制和无限制。 - 否则打印指定资源的当前限制值，不带选项则假定为 -f - - 取值都是 1024 字节为单位，除了 -t 以秒为单位，-p 以 512 字节递增， - -u 为无范围的进程数量。 - - 退出状态： - 返回成功，除非使用了无效的选项或者错误发生。 +[fg] + 将任务移至前台。 + + 将以 JOB_SPEC 标识的任务放至前台，使其成为 + 当前任务。如果 JOB_SPEC 不存在，shell 观念中的当前任务 + 将被使用。 + + 退出状态： + 放至前台的命令状态，或者当错误发生时为失败。 + +[bg] + 移动任务至后台。 + + 将 JOB_SPEC 标识的任务放至后台，就像它们 + 是带 `&' 启动的一样。如果 JOB_SPEC 不存在，shell 观念中的 + 当前任务将会被使用。 + + 退出状态： + 返回成功除非任务管理没有启用或者错误发生。 - [umask] 显示或设定文件模式掩码。 - - 设定用户文件创建掩码为 MODE 模式。如果省略了 MODE，则 - 打印当前掩码的值。 - - 如果 MODE 模式以数字开头，则被当作八进制数解析；否则是一个 - chmod(1) 可接收的符号模式串。 - - 选项： - -p 如果省略 MODE 模式，以可重用为输入的格式输入 - -S 以符号形式输出，否则以八进制数格式输出 - - 退出状态： - 返回成功，除非使用了无效的 MODE 模式或者选项。 +[hash] + 记住或显示程序位置。 + + 确定并记住每一个给定 NAME 名称的命令的完整路径。 + 如果不提供参数，则显示已经记住的命令的信息。 + + 选项： + -d 忘记每一个已经记住的 NAME 的位置 + -l 以可作为输入重用的格式显示 + -p pathname 使用 pathname 路径作为 NAME 命令的全路径 + -r 忘记所有记住的位置 + -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 + NAME 名称，则每个位置前面会加上相应的 NAME 名称 + + 参数： + NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 + 令 + 列表中。 + + 退出状态： + 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 + +[help] + 显示内建命令的相关信息。 + + 显示内建命令的简略信息。如果指定了 PATTERN 模式， + 给出所有匹配 PATTERN 模式的命令的详细帮助，否则打 + 印一个帮助主题列表 + + 选项： + -d 输出每个主题的简短描述 + -m 以伪 man 手册的格式显示使用方法 + -s 为每一个匹配 PATTERN 模式的主题仅显示一个用法 + 简介 + + 参数： + PATTERN 指定帮助主题的模式 + + 退出状态： + 返回成功，除非未找到 PATTERN 模式没有找到或者使用了无效选项。 - [return] 等待任务完成并返回退出状态。 - - 等待以 ID 编号识别的进程，其中 ID 可以是进程编号或者任务声明， - 并报告它的终止状态。如果 ID 没有给出，则等待所有的当前活跃子 - 进程，并且返回状态为零。如果 ID 是任务声明，等待任务管道中的 - 所有进程。 - - 若给定了 -n 选项，等待下一个任务完成并返回其状态。 - - 若给定了 -f 选项，且已启用了任务控制，则等待指定的 ID 终止 - 而非等待它改变状态。 - 退出状态： - 返回最后一个 ID 进程的状态；如果使用了无效的 ID 或者选项则失败。 +[history] + 显示或操纵历史列表。 + + 带行号显示历史列表，将每个被修改的条目加上 `*' 前缀。 + 参数 N 会仅列出最后的 N 个条目。 + + 选项： + -c 删除所有条目从而清空历史列表。 + -d 偏移量 从指定位置删除历史列表。负偏移量将从历史条目末尾 + 开始计数 + + -a 将当前会话的历史行追加到历史文件中 + -n 从历史文件中读取所有未被读取的行 + 并且将它们附加到历史列表 + -r 读取历史文件并将内容追加到历史列表中 + -w 将当前历史写入到历史文件中 + + -p 对每一个 ARG 参数展开历史并显示结果，而不存储到历史列表中 + -s 以单条记录追加 ARG 到历史列表中 + + 如果给定了 FILENAME 文件名，则它将被作为历史文件。否则 + 如果 $HISTFILE 变量有值的话使用之，不然使用 ~/.bash_history 文件。 + + 如果 $HISTTIMEFORMAT 变量被设定并且不为空，它的值会被用于 + strftime(3) 的格式字符串来打印与每一个显示的历史条目想关联的 + 时间戳，否则不打印时间戳。 + + 退出状态： + 返回成功，除非使用了无效的选项或者发生错误。 + +[jobs] + 显示任务状态。 + + 列出活动的任务。JOBSPEC 限制仅输出指定的任务。 + 不带选项时，所有活动任务的状态都会显示。 + + 选项： + -l 在正常信息基础上列出进程号 + -n 仅列出上次通告之后改变了状态的进程 + -p 仅列出进程号 + -r 限制仅输出运行中的任务 + -s 限制仅输出停止的任务 + + 如果使用了 -x 选项，ARG 参数中的所有任务声明会被替换为该任务 + 的进程组头领的进程号，然后执行 COMMAND 命令。 + + 退出状态： + 返回成功，除非使用了无效的选项或者有错误发生。 + 如果使用 -x 选项，则返回 COMMAND 命令的退出状态。 - [wait] 等待进程完成并且返回退出状态。 - - 等待指定进程并报告它的终止状态。如果没有提供 PID，则当前所有的活跃 - 子进程都会被等待，并且返回码为零。PID 必须为进程号。 - - 退出状态： - 返回进程 ID 的状态；如果 PID 是无效的进程号或者指定了无效的选项则失败。 +[disown] + 从当前 shell 中删除任务。 + + 从活动任务表中删除每一个 JOBSPEC 参数。不带任何 + JOBSPEC 参数时，shell 使用观念中的当前任务。 + + 选项： + -a 如果不提供 JOBSPEC 参数，则删除所有任务 + -h 标识每个 JOBSPEC 任务，从而当 shell 接收到 SIGHUP + 信号时不发送 SIGHUP 给指定任务 + -r 仅删除运行中的任务 + + 退出状态： + 返回成功除非使用了无效的选项或者 JOBSPEC 声明。 - [for] 为列表中的每个成员执行命令。 - - “for”循环为列表中的每个成员执行一系列的命令。如果没有 - “in <词语> ...;”则假定使用“in \$@\”。对于 <词语> 中的每 - 个元素，<名称> 变量被设定为该元素后执行 <命令>。 +[kill] + 向一个任务发送一个信号。 + + 向以 PID 进程号或者 JOBSPEC 任务声明指定的进程发送一个以 + SIGSPEC 信号声明或 SIGNUM 信号编号命名的信号。如果没有指定 + SIGSPEC 或 SIGNUM，那么假定发送 SIGTERM 信号。 + + 选项： + -s sig SIG 是信号名称 + -n sig SIG 是信号编号 + -l 列出信号名称；如果参数后跟 `-l'则被假设为信号编号， + 而相应的信号名称会被列出 + + Kill 成为 shell 内建有两个理由：它允许使用任务编号而不是进程号， + 并且在可以创建的进程数上限达到是允许进程被杀死。 + + 退出状态： + 返回成功，除非使用了无效的选项或者有错误发生。 - 退出状态： - 返回最后执行的命令的状态。 +[let] + 估值算术表达式。 + + 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 + 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 + 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 + 优先级从高至低。 + + + \tid++, id--\t变量后置加，后置减 + \t++id, --id\t变量前置加，前置减 + \t-, +\t\t一元减法，一元加法 + \t!, ~\t\t逻辑和位取反 + \t**\t\t指数 + \t*, /, %\t\t乘法，除法，取余数 + \t+, -\t\t增加，减少 + \t<<, >>\t\t向左和向右按位移位 + \t<=, >=, <, >\t比较 + \t==, !=\t\t等于，不等于 + \t&\t\t按位与 + \t^\t\t按位异或 + \t|\t\t按位或 + \t&&\t\t逻辑与 + \t||\t\t逻辑或 + \texpr ? expr : expr + \t\t\t条件操作符 + \t=, *=, /=, %=, + \t+=, -=, <<=, >>=, + \t&=, ^=, |=\t赋值 + + Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 + (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 + + 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 + 规则。 + +[shift] + 移位位置参数。 + + 重命名位置参数 $N+1、$N+2 ... 到 $1、$2 ... 如果没有给定 N， + 则假设为1. + + 退出状态： + 返回成功，除非 N 为负或者大于 $#。 + 返回 N，或者如果 shell 不在执行一个函数或引用脚本时，失败。 - [select] 从列表中选取词并且执行命令。 - - <词语...> 被展开，生成一个词的列表。展开的词集合被打印 - 在标准错误输出设备上，每个以一个数字做前缀。如果没有 `in WORDS' - 则假定使用`in \$@\'。PS3提示符会被显示并且从标准输入读入一行 - 如果该行由被显示的词对应的数字组成，则 NAME 变量被设定为相应 - 的词。如果行为空，则 WORDS 变量和提示符被重新显示。如果读取了 - 文件结束符，则命令完成。读入任何其他的值会导致 NAME 变量被设定 - 为空。读入的行被存放在变量 REPLY 中。COMMANDS 命令在每次选择 - 之后执行直到执行一个 break 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[suspend] + 挂起 shell 执行。 + + 挂起 shell 的执行直到收到 SIGCONT 信号。 + 登录 shell 不可以被挂起，除非强制执行。 + + 选项： + -f 强制挂起，即使是登录 shell。 + + 退出状态： + 返回成功，除非没有启用任务控制或者有错误发生。 + +[eval] + 对条件表达式进行估值。 + + 根据 EXPR 表达式的估值以状态 0 (真) 或 1 (伪) 退出。 + 表达式可以是一元或者二元的。一元表达式通常用于检测 + 文件状态。同时还有字符串操作符和数字比较操作符。 + + 文件操作符： + + -a 文件 如果文件存在则为真。 + -b 文件 如果文件为块特殊文件则为真。 + -c 文件 如果文件为字符特殊文件则为真。 + -d 文件 如果文件为目录则为真。 + -e 文件 如果文件存在则为真。 + -f 文件 如果文件存在且为常规文件则为真。 + -g 文件 如果文件的组属性设置打开则为真。 + -h 文件 如果文件为符号链接则为真。 + -L 文件 如果文件为符号链接则为真。 + -k 文件 如果文件的粘滞 (sticky) 位设定则为真。 + -p 文件 如果文件为命名管道则为真。 + -r 文件 如果文件对于您是可读的则为真。 + -s 文件 如果文件存在且不为空则为真。 + -S 文件 如果文件是套接字则为真。 + -t 文件描述符 如果文件描述符在一个终端上打开则为真。 + -u 文件 如果文件的用户数行设置打开则为真。 + -w 文件 如果文件对您是可写的则为真 + -x 文件 如果文件对您是可执行的则为真。 + -O 文件 如果文件是被您所有的则为真。 + -G 文件 如果文件被您的组所有则为真。 + -N 文件 如果文件上次被读取之后修改过则为真。 + + FILE1 -nt FILE2 如果 file1 文件新于 file2 文件则为真(根据 + 修改日期)。 + + FILE1 -ot FILE2 如果 file1 文件旧于 file2 文件则为真。 + + FILE1 -ef FILE2 如果 file1 文件是 file2 文件的硬链接则为真。 + + 字符串操作符 + + -z 字符串 如果字符串为空则为真。 + + -n 字符串 + 字符串 如果字符串不为空则为真。 + + STRING1 = STRING2 + 如果 string1 和 string2 字符串相同则为真。 + STRING1 != STRING2 + 如果 string1 和 string2 字符串不相同则为真。 + STRING1 < STRING2 + 如果按字典排序 string1 在 string2 串之前则为真。 + STRING1 > STRING2 + 如果按字典排序 string1 在 string2 串之前则为真。 + + 其他操作符： + + -o 选项 如果指定 shell 选项启用则为真。 + -v VAR 如果指定 Shell 变量 VAR 已赋值则为真。 + -R VAR 如果指定 Shell 变量 VAR 已赋值且为名称引用则为真。 + ! EXPR 如果表达式 expr 为假则为真。 + EXPR1 -a EXPR2 如果 expr1 和 expr2 都为真则为真。 + EXPR1 -o EXPR2 如果 expr1 和 expr2 有一个为真则为真。 + + arg1 OP arg2 算术测试。OP操作符可以是 -eq、-ne、 + -lt、-le、-gt、或 -ge 中的一个。 + + 二元算术操作返回真，如果 ARG1 参数等于、不等于、 + 小于、小于等于、大于、或者大于等于 ARG2 参数。 + + 退出状态： + 如果 EXPR 表达式估值为真则返回成功；如果 EXPR 表达式估值 + 为假或者使用了无效的参数则返回失败。 - [time] 报告管道执行的消耗时间。 - - 执行 PIPELINE 并且打印 PIPELINE 终结时实际时间、用户 CPU 时间和系统 - CPU 时间的总结。 - - 选项： - -p 用可迁移的 POSIX 格式打印用时总结。 - - TIMEFORMAT 变量的值被作为输出格式。 - - 退出状态： - 返回状态即PIPELINE 的返回状态。 +[times] + 显示进程时间 + + 打印 shell 及其所有子进程的累计用户空间和 + 系统空间执行时间。 + + 退出状态 + 总是成功。 + +[ulimit] + 修改 shell 资源限制。 + + 在允许此类控制的系统上，提供对于 shell 及其创建的进程所可用的 + 资源的控制。 + + 选项： + -S 使用软 (`soft') 资源限制 + -H 使用硬 (`hard') 资源限制 + -a 所有当前限制都被报告 + -b 套接字缓存尺寸 + -c 创建的核文件的最大尺寸 + -d 一个进程的数据区的最大尺寸 + -e 最高的调度优先级 (`nice') + -f 有 shell 及其子进程可以写的最大文件尺寸 + -i 最多的可以挂起的信号数 + -k 分配给此进程的最大 kqueue 数量 + -l 一个进程可以锁定的最大内存尺寸 + -m 最大的内存进驻尺寸 + -n 最多的打开的文件描述符个数 + -p 管道缓冲区尺寸 + -q POSIX 信息队列的最大字节数 + -r 实时调度的最大优先级 + -s 最大栈尺寸 + -t 最大的CPU时间，以秒为单位 + -u 最大用户进程数 + -v 虚拟内存尺寸 + -x 最大的文件锁数量 + -P 最大伪终端数量 + -T 最大线程数量 + + 并非所有选项在所有系统上可用。 + + 如果提供了 LIMIT 变量，则它为指定资源的新的值；特别的 LIMIT 值为 + `soft'、`hard'和`unlimited'，分别表示当前的软限制，硬限制和无限制。 + 否则打印指定资源的当前限制值，不带选项则假定为 -f + + 取值都是 1024 字节为单位，除了 -t 以秒为单位，-p 以 512 字节递增， + -u 为无范围的进程数量。 + + 退出状态： + 返回成功，除非使用了无效的选项或者错误发生。 + +[umask] + 显示或设定文件模式掩码。 + + 设定用户文件创建掩码为 MODE 模式。如果省略了 MODE，则 + 打印当前掩码的值。 + + 如果 MODE 模式以数字开头，则被当作八进制数解析；否则是一个 + chmod(1) 可接收的符号模式串。 + + 选项： + -p 如果省略 MODE 模式，以可重用为输入的格式输入 + -S 以符号形式输出，否则以八进制数格式输出 + + 退出状态： + 返回成功，除非使用了无效的 MODE 模式或者选项。 - [case] 基于模式匹配来执行命令。 - - 基于 PATTERN 模式匹配的词 WORD，有选择的执行 COMMANDS 命令。 - `|' 用于分隔多个模式。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[return] + 等待任务完成并返回退出状态。 + + 等待以 ID 编号识别的进程，其中 ID 可以是进程编号或者任务声明， + 并报告它的终止状态。如果 ID 没有给出，则等待所有的当前活跃子 + 进程，并且返回状态为零。如果 ID 是任务声明，等待任务管道中的 + 所有进程。 + + 若给定了 -n 选项，等待下一个任务完成并返回其状态。 + + 若给定了 -f 选项，且已启用了任务控制，则等待指定的 ID 终止 + 而非等待它改变状态。 + 退出状态： + 返回最后一个 ID 进程的状态；如果使用了无效的 ID 或者选项则失败。 - [if] 根据条件执行命令。 - - `if COMMANDS'列表被执行。如果退出状态为零，则执行`then COMMANDS' - 列表。否则按顺序执行每个 `elif COMMANDS'列表，并且如果它的退出状态为 - 零，则执行对应的 `then COMMANDS' 列表并且 if 命令终止。否则如果存在的 - 情况下，执行 `else COMMANDS'列表。整个结构的退出状态是最后一个执行 - 的命令的状态，或者如果没有条件测试为真的话，为零。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[wait] + 等待进程完成并且返回退出状态。 + + 等待指定进程并报告它的终止状态。如果没有提供 PID，则当前所有的活跃 + 子进程都会被等待，并且返回码为零。PID 必须为进程号。 + + 退出状态： + 返回进程 ID 的状态；如果 PID 是无效的进程号或者指定了无效的选项则失败。 + +[for] + 为列表中的每个成员执行命令。 + + “for”循环为列表中的每个成员执行一系列的命令。如果没有 + “in <词语> ...;”则假定使用“in \$@\”。对于 <词语> 中的每 + 个元素，<名称> 变量被设定为该元素后执行 <命令>。 + + 退出状态： + 返回最后执行的命令的状态。 - [while] 只要测试成功即执行命令。 - - 只要在 `while' COMMANDS 中的最终命令返回结果为0，则 - 展开并执行 COMMANDS 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[select] + 从列表中选取词并且执行命令。 + + <词语...> 被展开，生成一个词的列表。展开的词集合被打印 + 在标准错误输出设备上，每个以一个数字做前缀。如果没有 `in WORDS' + 则假定使用`in \$@\'。PS3提示符会被显示并且从标准输入读入一行 + 如果该行由被显示的词对应的数字组成，则 NAME 变量被设定为相应 + 的词。如果行为空，则 WORDS 变量和提示符被重新显示。如果读取了 + 文件结束符，则命令完成。读入任何其他的值会导致 NAME 变量被设定 + 为空。读入的行被存放在变量 REPLY 中。COMMANDS 命令在每次选择 + 之后执行直到执行一个 break 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [until] 当测试不同过时执行命令。 - - `until' COMMANDS 命令的最终命令返回状态不为 0 时， - 展开并执行 COMMANDS 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[time] + 报告管道执行的消耗时间。 + + 执行 PIPELINE 并且打印 PIPELINE 终结时实际时间、用户 CPU 时间和系统 + CPU 时间的总结。 + + 选项： + -p 用可迁移的 POSIX 格式打印用时总结。 + + TIMEFORMAT 变量的值被作为输出格式。 + + 退出状态： + 返回状态即PIPELINE 的返回状态。 - [coproc] 创建一个以 NAME 为名的副进程。 - - 异步执行 COMMANDS 命令，在执行 shell 中的数组变量 NAME - 的 0 号和 1 号元素作为文件描述符，以一个管道连接命令 - 分别作为命令的标准输出和输入设备。 - 默认的 NAME 是 \COPROC\。 - - 退出状态： - 副进程会返回退出状态 0。 +[case] + 基于模式匹配来执行命令。 + + 基于 PATTERN 模式匹配的词 WORD，有选择的执行 COMMANDS 命令。 + |' 用于分隔多个模式。 + + 退出状态： + 返回最后一个执行的命令的状态。 + +[if] + 根据条件执行命令。 + + `if COMMANDS'列表被执行。如果退出状态为零，则执行`then COMMANDS' + 列表。否则按顺序执行每个 `elif COMMANDS'列表，并且如果它的退出状态为 + 零，则执行对应的 `then COMMANDS' 列表并且 if 命令终止。否则如果存在的 + 情况下，执行 `else COMMANDS'列表。整个结构的退出状态是最后一个执行 + 的命令的状态，或者如果没有条件测试为真的话，为零。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [variables] 常用 shell 变量名称和使用。 - - BASH_VERSION 当前 Bash 的版本信息。 - CDPATH 用于 `cd' 命令参数搜索的分号分隔的目录列表 - GLOBIGNORE 路径扩展时忽略的文件名匹配模式列表， - 以分号分隔。 - HISTFILE 您的命令历史存放的文件名称。 - HISTFILESIZE 历史文件最多可以保存的行数。 - HISTSIZE 一个运行的 shell 最多可以访问的历史命令行数。 - HOME 您的登录目录的完整路径。 - HOSTNAME 当前主机的主机名。 - HOSTTYPE 当前版本的 BASH 在其之上运行的 CPU 类型。 - IGNOREEOF 控制 shell 收到文件结束符作为单一输入后的 - 动作。如果设定这个变量，则它的值是 shell 退出之前在 - 一个空行上可以连续看到的文件结束符数量(默认为10)。 - 未设定时，文件结束符标志着输入的结束。 - MACHTYPE 描述当前运行 Bash 的系统的字符串。 - MAILCHECK Bash 检测新邮件的频率，以秒为单位。 - MAILPATH Bash 从中检测新邮件的文件列表，以分号分隔。 - OSTYPE 运行 Bash 的 Unix 版本。 - PATH 当寻找命令时搜索的目录列表，以冒号分隔。 - PROMPT_COMMAND 打印每一个主提示符之前执行的命 - 令。 - PS1 主提示符字符串。 - PS2 从提示符字符串。 - PWD 当前目录的完整路径。 - SHELLOPTS 已启用的 shell 选项列表，以冒号分隔。 - TERM 当前终端类型的名称。 - TIMEFORMAT 以关键则 `time' 显示的时间统计信息的输出 - 格式。 - auto_resume 非空时，一个单独的命令词会首先被在当前 - 停止的任务列表中搜索。如果找到则该任务被置于前台。 - 如果值为 `exact' 则意味着命令词必须精确匹配停止任务 - 列表中的命令。如果值为 `substring' 则意味着命令词必 - 须匹配任务的一个子字符串。任何其他的值意味着命令词 - 必须是停止任务的一个前缀。 - histchars 控制历史展开和快速替换的字符。第一个字符是 - 历史替换字符，通常是 `!'。第二个字符是快速替换字符， - 通常是 `^'。第三个是历史注释字符，通常是 `#'。 - HISTIGNORE 用于决定哪些命令被存入历史文件的模式 - 列表，以冒号分隔。 +[while] + 只要测试成功即执行命令。 + + 只要在 `while' COMMANDS 中的最终命令返回结果为0，则 + 展开并执行 COMMANDS 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [pushd] 将目录添加到栈中。 - - 将目录添加到目录栈顶，或着旋转栈直到当前工作目录成为 - 新的栈顶。不带参数时，交换栈顶的两个目录。 - - 选项： - -n 抑制添加目录至栈时通常的改变目录操作，从而仅对栈 - 进行操作。 - - 参数： - +N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中左起，从零开始) - 将移动到栈顶。 - - -N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中右起，从零开始) - 将移动到栈顶。 - - dir 将 DIR 目录添加到栈顶，并且使其成为当前工作目录。 - - `dirs' 内建显示目录栈。 - - 退出状态： - - [popd] 从栈中删除目录。 - - 从目录栈中删除条目。不带参数时，删除栈顶目录，并改变至新的栈 - 顶目录。 - - 选项： - -n 抑制从栈中删除目录时通常的目录变换操作，从而仅对栈 - 进行操作。 - - 参数： - +N 删除第 N 个目录 (`dirs' 显示的目录列表中左起，从零开始)。 - 例如：`popd +0' 删除第一个目录，`popd +1' 删除第二个。 - - -N 删除第 N 个目录 (`dirs' 显示的目录列表中右起，从零开始)。 - 例如：`popd -0' 删除最后一个目录，，`popd -1' 删除倒数第二个。 - - `dirs' 内建显示目录栈。 - - 退出状态： - 返回成功，除非使用了无效的参数或者目录变换失败。 +[until] + 当测试不同过时执行命令。 + + `until' COMMANDS 命令的最终命令返回状态不为 0 时， + 展开并执行 COMMANDS 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 + +[coproc] + 创建一个以 NAME 为名的副进程。 + + 异步执行 COMMANDS 命令，在执行 shell 中的数组变量 NAME + 的 0 号和 1 号元素作为文件描述符，以一个管道连接命令 + 分别作为命令的标准输出和输入设备。 + 默认的 NAME 是 \COPROC\。 + + 退出状态： + 副进程会返回退出状态 0。 - [dirs] 显示目录栈。 - - 显示当前记住的目录列表。通过 `pushd' 命令可以将目录存入列表 - 中；`popd' 命令可用于遍历弹出列表。 - - 选项： - -c 删除所有元素以清空目录栈 - -l 不打印与主目录相关的波浪号前缀的目录 - -p 每行一个条目打印目录栈 - -v 每行一个条目，以栈中位置为前缀打印目录栈 - - 参数： - +N 显示 dirs 不带选项启动时显示的目录列表左起中第 - N 个目录，从零开始。 - - -N 显示 dirs 不带选项启动时显示的目录列表右起中第 - N 个目录，从零开始。 +[variables] + 常用 shell 变量名称和使用。 + + BASH_VERSION 当前 Bash 的版本信息。 + CDPATH 用于 `cd' 命令参数搜索的分号分隔的目录列表 + GLOBIGNORE 路径扩展时忽略的文件名匹配模式列表， + 以分号分隔。 + HISTFILE 您的命令历史存放的文件名称。 + HISTFILESIZE 历史文件最多可以保存的行数。 + HISTSIZE 一个运行的 shell 最多可以访问的历史命令行数。 + HOME 您的登录目录的完整路径。 + HOSTNAME 当前主机的主机名。 + HOSTTYPE 当前版本的 BASH 在其之上运行的 CPU 类型。 + IGNOREEOF 控制 shell 收到文件结束符作为单一输入后的 + 动作。如果设定这个变量，则它的值是 shell 退出之前在 + 一个空行上可以连续看到的文件结束符数量(默认为10)。 + 未设定时，文件结束符标志着输入的结束。 + MACHTYPE 描述当前运行 Bash 的系统的字符串。 + MAILCHECK Bash 检测新邮件的频率，以秒为单位。 + MAILPATH Bash 从中检测新邮件的文件列表，以分号分隔。 + OSTYPE 运行 Bash 的 Unix 版本。 + PATH 当寻找命令时搜索的目录列表，以冒号分隔。 + PROMPT_COMMAND 打印每一个主提示符之前执行的命 + 令。 + PS1 主提示符字符串。 + PS2 从提示符字符串。 + PWD 当前目录的完整路径。 + SHELLOPTS 已启用的 shell 选项列表，以冒号分隔。 + TERM 当前终端类型的名称。 + TIMEFORMAT 以关键则 `time' 显示的时间统计信息的输出 + 格式。 + auto_resume 非空时，一个单独的命令词会首先被在当前 + 停止的任务列表中搜索。如果找到则该任务被置于前台。 + 如果值为 `exact' 则意味着命令词必须精确匹配停止任务 + 列表中的命令。如果值为 `substring' 则意味着命令词必 + 须匹配任务的一个子字符串。任何其他的值意味着命令词 + 必须是停止任务的一个前缀。 + histchars 控制历史展开和快速替换的字符。第一个字符是 + 历史替换字符，通常是 `!'。第二个字符是快速替换字符， + 通常是 `^'。第三个是历史注释字符，通常是 `#'。 + HISTIGNORE 用于决定哪些命令被存入历史文件的模式 + 列表，以冒号分隔。 + +[pushd] + 将目录添加到栈中。 + + 将目录添加到目录栈顶，或着旋转栈直到当前工作目录成为 + 新的栈顶。不带参数时，交换栈顶的两个目录。 + + 选项： + -n 抑制添加目录至栈时通常的改变目录操作，从而仅对栈 + 进行操作。 + + 参数： + +N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中左起，从零开始) + 将移动到栈顶。 + + -N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中右起，从零开始) + 将移动到栈顶。 + + dir 将 DIR 目录添加到栈顶，并且使其成为当前工作目录。 + + `dirs' 内建显示目录栈。 + + 退出状态： - 退出状态： - 返回成功，除非使用了无效的选项或者发生错误。 +[popd] + 从栈中删除目录。 + + 从目录栈中删除条目。不带参数时，删除栈顶目录，并改变至新的栈 + 顶目录。 + + 选项： + -n 抑制从栈中删除目录时通常的目录变换操作，从而仅对栈 + 进行操作。 + + 参数： + +N 删除第 N 个目录 (`dirs' 显示的目录列表中左起，从零开始)。 + 例如：`popd +0' 删除第一个目录，`popd +1' 删除第二个。 + + -N 删除第 N 个目录 (`dirs' 显示的目录列表中右起，从零开始)。 + 例如：`popd -0' 删除最后一个目录，，`popd -1' 删除倒数第二个。 + + `dirs' 内建显示目录栈。 + + 退出状态： + 返回成功，除非使用了无效的参数或者目录变换失败。 - [printf] 在 FORMAT 的控制下格式化并打印 ARGUMENTS 参数。 - - 选项： - -v var 将输出赋值给 shell 变量 VAR 而不显示在标准输出上 - - FORMAT 是包含三种对象的字符串：简单地被拷贝到标准输出的普通字符； - 被变换之后拷贝到标准输入的转义字符；以及每个都会影响到下个参数的打印的格 - 式化声明。 - - 在 printf(1) 中描述的标准控制声明之外，printf 解析： - - %b 扩展对应参数中的反斜杠转义序列 - %q 以可作为 shell 输入的格式引用参数 - %(fmt)T 以 FMT 为供给 strftime(3) 的格式输出日期时间字符串 - - 退出状态： - 返回成功，除非使用了无效的选项或者写或赋值错误发生。 +[dirs] + 显示目录栈。 + + 显示当前记住的目录列表。通过 `pushd' 命令可以将目录存入列表 + 中；`popd' 命令可用于遍历弹出列表。 + + 选项： + -c 删除所有元素以清空目录栈 + -l 不打印与主目录相关的波浪号前缀的目录 + -p 每行一个条目打印目录栈 + -v 每行一个条目，以栈中位置为前缀打印目录栈 + + 参数： + +N 显示 dirs 不带选项启动时显示的目录列表左起中第 + N 个目录，从零开始。 + + -N 显示 dirs 不带选项启动时显示的目录列表右起中第 + N 个目录，从零开始。 + + 退出状态： + 返回成功，除非使用了无效的选项或者发生错误。 + +[printf] + 在 FORMAT 的控制下格式化并打印 ARGUMENTS 参数。 + + 选项： + -v var 将输出赋值给 shell 变量 VAR 而不显示在标准输出上 + + FORMAT 是包含三种对象的字符串：简单地被拷贝到标准输出的普通字符； + 被变换之后拷贝到标准输入的转义字符；以及每个都会影响到下个参数的打印的格 + 式化声明。 + + 在 printf(1) 中描述的标准控制声明之外，printf 解析： + + %b 扩展对应参数中的反斜杠转义序列 + %q 以可作为 shell 输入的格式引用参数 + %(fmt)T 以 FMT 为供给 strftime(3) 的格式输出日期时间字符串 + + 退出状态： + 返回成功，除非使用了无效的选项或者写或赋值错误发生。 - [complete] 指定 Readline 如何补全参数。 - - 声明对于每一个 NAME 名称如何补全参数。如果不带选项， - 现有的补全声明会以可以重用为输入的格式打印出来。 - - 选项： - -p 以可重用的格式打印现有的补全声明。 - -r 对于每个 NAME 名称删除补全声明，或者如果没有提供 NAME - 名称，删除所有的补全声明。 - -D 对于没有补全声明定义的命令，设定默认的补全动作 - -E 对于 \empty\ 命令设定补全动作，—— 对于空行的补全。 - -I 将补全和动作应用在首单词（通常是所给命令）上 - - 尝试补全时，按照上述大写字母选项的顺序进行动作。 - 如果给出了多个选项，-D 选项优先级高于 -E 选项，且 - 这两个选项优先级均高于 -I。 - - 退出状态： - 返回成功，除非使用了无效的选项或者错误发生。 +[complete] + 指定 Readline 如何补全参数。 + + 声明对于每一个 NAME 名称如何补全参数。如果不带选项， + 现有的补全声明会以可以重用为输入的格式打印出来。 + + 选项： + -p 以可重用的格式打印现有的补全声明。 + -r 对于每个 NAME 名称删除补全声明，或者如果没有提供 NAME + 名称，删除所有的补全声明。 + -D 对于没有补全声明定义的命令，设定默认的补全动作 + -E 对于 \empty\ 命令设定补全动作，—— 对于空行的补全。 + -I 将补全和动作应用在首单词（通常是所给命令）上 + + 尝试补全时，按照上述大写字母选项的顺序进行动作。 + 如果给出了多个选项，-D 选项优先级高于 -E 选项，且 + 这两个选项优先级均高于 -I。 + + 退出状态： + 返回成功，除非使用了无效的选项或者错误发生。 - [compgen] 依据选项显示可能的补全。 - - 意图在能产生可能的补全的 shell 函数内部使用。 - 如果提供了可选的 WORD 参数，则产生按照 WORD - 进行的匹配。 - - 退出状态： - 除非使用了无效选项或者错误发生，否则返回成功。 +[compgen] + 依据选项显示可能的补全。 + + 意图在能产生可能的补全的 shell 函数内部使用。 + 如果提供了可选的 WORD 参数，则产生按照 WORD + 进行的匹配。 + + 退出状态： + 除非使用了无效选项或者错误发生，否则返回成功。 - [compopt] 修改或显示补全选项。 - - 修改每个 NAME 名称的补全选项，或如果没有提供 NAME 名称，执行当前的补 - 全。 - 如果不带选项，打印每个 NAME 名称的补全选项或当前的补全声明。 - - 选项： - -o option 为每个 NAME 名称设定补全选项 option - -D 为 \default\ 命令补全改变选项 - -E 为 \empty\ 命令补全改变选项 - -I 为首单词的补全改变选项 - - 使用 `+o' 而不是 `-o' 可以关闭指定的选项。 - - 参数： - - 每个 NAME 名称都对应一个之前以通过 `complete' 内建定义了的补全声明的 - 命令。如果不提供 NAME 名称，当前生成补全的函数必须调用 compopt， - 并且当前执行的补全生成器选项会被修改。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称没有定义补全声明。 +[compopt] + 修改或显示补全选项。 + + 修改每个 NAME 名称的补全选项，或如果没有提供 NAME 名称，执行当前的补 + 全。 + 如果不带选项，打印每个 NAME 名称的补全选项或当前的补全声明。 + + 选项： + -o option 为每个 NAME 名称设定补全选项 option + -D 为 \default\ 命令补全改变选项 + -E 为 \empty\ 命令补全改变选项 + -I 为首单词的补全改变选项 + + 使用 `+o' 而不是 `-o' 可以关闭指定的选项。 + + 参数： + + 每个 NAME 名称都对应一个之前以通过 `complete' 内建定义了的补全声明的 + 命令。如果不提供 NAME 名称，当前生成补全的函数必须调用 compopt， + 并且当前执行的补全生成器选项会被修改。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称没有定义补全声明。 - [mapfile] +[mapfile] 从标准输入读取行到下标数组变量中。 - - 从标准输入读取行到下标数组变量 ARRAY 中，或者如果使用了 -u 选项， - 从文件描述符 FD 中读取。MAPFILE 变量是默认的 ARRAY 变量。 - - 选项： - -d delim 使用 DELIM 而非换行符断行 - -n count 最多拷贝 COUNT 行，如果 COUNT 为 0，则拷贝所有行。 - -O origin 从下标 ORIGIN 开始 赋值给 ARRAY 变量。默认下标是0. - -s count 丢弃最先读取的 COUNT 行。 - -t 从读取的每行末尾删除一个换行符。 - -u fd 从文件描述符 FD 中读取行而不是标准输入。 - -C callback 每 QUANTUM 次读行之后对 CALLBACK 回调进行估值。 - -c quantum 定义每次调用 CALLBACK 回调之间读取的行数。 - - 参数： - ARRAY 存储数据使用的数组变量 - - 如果使用了 -C 而没有 -c，默认的量子是5000。当对 CALLBACK 估值时， - 下一个将被赋值的数组元素的下标作为额外参数被传递。 - - 如果没有显式指定起始下标，mapfile 将在赋值前清空 ARRAY 变量。 - - 退出状态： - 返回成功，除非使用了无效的选项，或者 ARRAY 变量只读或不是下标数组。 + + 从标准输入读取行到下标数组变量 ARRAY 中，或者如果使用了 -u 选项， + 从文件描述符 FD 中读取。MAPFILE 变量是默认的 ARRAY 变量。 + + 选项： + -d delim 使用 DELIM 而非换行符断行 + -n count 最多拷贝 COUNT 行，如果 COUNT 为 0，则拷贝所有行。 + -O origin 从下标 ORIGIN 开始 赋值给 ARRAY 变量。默认下标是0. + -s count 丢弃最先读取的 COUNT 行。 + -t 从读取的每行末尾删除一个换行符。 + -u fd 从文件描述符 FD 中读取行而不是标准输入。 + -C callback 每 QUANTUM 次读行之后对 CALLBACK 回调进行估值。 + -c quantum 定义每次调用 CALLBACK 回调之间读取的行数。 + + 参数： + ARRAY 存储数据使用的数组变量 + + 如果使用了 -C 而没有 -c，默认的量子是5000。当对 CALLBACK 估值时， + 下一个将被赋值的数组元素的下标作为额外参数被传递。 + + 如果没有显式指定起始下标，mapfile 将在赋值前清空 ARRAY 变量。 + + 退出状态： + 返回成功，除非使用了无效的选项，或者 ARRAY 变量只读或不是下标数组。 - [readarray] 从一个文件中读取行到数组变量中。 +[readarray] + 从一个文件中读取行到数组变量中。 一个 `mapfile'的同义词。 - [unset] 取消设定 shell 变量和函数的值和属性。 - 对每一个 NAME 名称，删除对应的变量或函数。 - - 选项： - -f 将每个 NAME 视为函数 - -v 将每个 NAME 视为变量 - -n 将每个 NAME 视为名称引用，只取消其本身而非其指向的变量 - - 不带选项时，unset 首先尝试取消设定一个变量，如果失败，再尝试取消设定一个 - 函数。 - - 某些变量不可以被取消设定；参见 `readonly'。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - - [local] 记住或显示程序位置。 - - 确定并记住每一个给定 NAME 名称的命令的完整路径。 - 如果不提供参数，则显示已经记住的命令的信息。 - - 选项： - -d 忘记每一个已经记住的 NAME 的位置 - -l 以可作为输入重用的格式显示 - -p pathname 使用 pathname 路径作为 NAME 命令的全路径 - -r 忘记所有记住的位置 - -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 - NAME 名称，则每个位置前面会加上相应的 NAME 名称 - - 参数： - NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 - 令 - 列表中。 +[unset] + 取消设定 shell 变量和函数的值和属性。 + 对每一个 NAME 名称，删除对应的变量或函数。 + + 选项： + -f 将每个 NAME 视为函数 + -v 将每个 NAME 视为变量 + -n 将每个 NAME 视为名称引用，只取消其本身而非其指向的变量 + + 不带选项时，unset 首先尝试取消设定一个变量，如果失败，再尝试取消设定一个 + 函数。 + + 某些变量不可以被取消设定；参见 `readonly'。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - 退出状态： - 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 +[local] + 记住或显示程序位置。 + + 确定并记住每一个给定 NAME 名称的命令的完整路径。 + 如果不提供参数，则显示已经记住的命令的信息。 + + 选项： + -d 忘记每一个已经记住的 NAME 的位置 + -l 以可作为输入重用的格式显示 + -p pathname 使用 pathname 路径作为 NAME 命令的全路径 + -r 忘记所有记住的位置 + -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 + NAME 名称，则每个位置前面会加上相应的 NAME 名称 + + 参数： + NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 + 令 + 列表中。 + + 退出状态： + 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - [export] 为 shell 变量设定导出属性。 +[export] + 为 shell 变量设定导出属性。 - 标记每个 NAME 名称为自动导出到后续命令执行的环境。如果提供了 VALUE - 则导出前将 VALUE 作为赋值。 - - 选项： - -f 指 shell 函数 - -n 删除每个 NAME 名称的导出属性 - -p 显示所有导出的变量和函数的列表 - - `--' 的参数禁用进一步的选项处理。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称。 + 标记每个 NAME 名称为自动导出到后续命令执行的环境。如果提供了 VALUE + 则导出前将 VALUE 作为赋值。 + + 选项： + -f 指 shell 函数 + -n 删除每个 NAME 名称的导出属性 + -p 显示所有导出的变量和函数的列表 + + `--' 的参数禁用进一步的选项处理。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称。 - [readonly] 标记 shell 变量为不可改变。 +[readonly] + 标记 shell 变量为不可改变。 - 标记每一个 NAME 名称为只读；这些 NAME 变量的值将不可以被后续的赋值 - 操作所改变。如果提供了 VALUE，则在标记为只读之前将 VALUE 值赋给变量。 - - 选项： - -a 指下标数组变量 - -A 指关联数组标量 - -f 指 shell 函数 - -p 显示只读变量或函数列表，取决于是否提供了 -f 选项 - - `--' 的参数禁用进一步的选项处理。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称。 + 标记每一个 NAME 名称为只读；这些 NAME 变量的值将不可以被后续的赋值 + 操作所改变。如果提供了 VALUE，则在标记为只读之前将 VALUE 值赋给变量。 + + 选项： + -a 指下标数组变量 + -A 指关联数组标量 + -f 指 shell 函数 + -p 显示只读变量或函数列表，取决于是否提供了 -f 选项 + + `--' 的参数禁用进一步的选项处理。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称。 - [declare] 设定变量值和属性。 - - 声明变量并且赋予它们属性。如果没有给定名称， - 则显示所有变量的属性和值。 - - 选项： - -f 限制动作或显示为仅函数名称和定义 - -F 限制仅显示函数名称 (以及调试时显示行号和源文件名) - -g 当用于 shell 函数内时创建全局变量; 否则忽略 - -p 显示每个 NAME 变量的属性和值 - - 设定属性的选项： - -a 使 NAME 成为下标数组 (如果支持) - -A 使 NAME 成为关联数组 (如果支持) - -i 使 NAME 带有 `integer' (整数)属性 - -l 将 NAME 在赋值时转为小写 - -n 使 NAME 成为指向一个以其值为名称的变量的引用 - -r 将 NAME 变为只读 - -t 使 NAME 带有 `trace' (追踪)属性 - -u 将每个 NAME 在赋值时转为大写 - -x 将 NAME 导出 - - 用 `+' 代替 `-' 会关闭指定选项。 - - 带有整数属性的变量在赋值时将使用算术估值(见 - `let' 命令) +[declare] + 设定变量值和属性。 - 在函数中使用时，`declare' 使 NAME 成为本地变量，和 `local' - 命令一致。`-g' 选项抑制此行为。 - - 退出状态： - 返回成功，除非提供了无效选项或者发生变量赋值错误 + 声明变量并且赋予它们属性。如果没有给定名称， + 则显示所有变量的属性和值。 + + 选项： + -f 限制动作或显示为仅函数名称和定义 + -F 限制仅显示函数名称 (以及调试时显示行号和源文件名) + -g 当用于 shell 函数内时创建全局变量; 否则忽略 + -p 显示每个 NAME 变量的属性和值 + + 设定属性的选项： + -a 使 NAME 成为下标数组 (如果支持) + -A 使 NAME 成为关联数组 (如果支持) + -i 使 NAME 带有 `integer' (整数)属性 + -l 将 NAME 在赋值时转为小写 + -n 使 NAME 成为指向一个以其值为名称的变量的引用 + -r 将 NAME 变为只读 + -t 使 NAME 带有 `trace' (追踪)属性 + -u 将每个 NAME 在赋值时转为大写 + -x 将 NAME 导出 + + 用 `+' 代替 `-' 会关闭指定选项。 + + 带有整数属性的变量在赋值时将使用算术估值(见 + `let' 命令) + + 在函数中使用时，`declare' 使 NAME 成为本地变量，和 `local' + 命令一致。`-g' 选项抑制此行为。 + + 退出状态： + 返回成功，除非提供了无效选项或者发生变量赋值错误 - [function] 定义 shell 函数。 - - 创建一个以 NAME 为名的 shell 函数。当作为一个简单的命令启用时， - NAME 函数执行调用 shell 的上下文中的 COMMANDs 命令。当 NAME - 被启用时，参数作为 $1...$n 被传递给函数，函数的名字储存在变量 - $FUNCNAME 中。 +[function] + 定义 shell 函数。 - 退出状态： - 返回成功除非 NAME 为只读。 + 创建一个以 NAME 为名的 shell 函数。当作为一个简单的命令启用时， + NAME 函数执行调用 shell 的上下文中的 COMMANDs 命令。当 NAME + 被启用时，参数作为 $1...$n 被传递给函数，函数的名字储存在变量 + $FUNCNAME 中。 + + 退出状态： + 返回成功除非 NAME 为只读。 - [typeset] 设置变量的值和属性。 +[typeset] + 设置变量的值和属性。 - `declare' 的等价形式。参见 `help declare'。 + `declare' 的等价形式。参见 `help declare'。 - - [source] 在当前 shell 中执行一个文件中的命令。 - - 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 - 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS - 参数，则它们将成为 FILENAME 文件执行时的位置参数。 +[source] + 在当前 shell 中执行一个文件中的命令。 - 退出状态： - 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 + 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 + 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS + 参数，则它们将成为 FILENAME 文件执行时的位置参数。 + + 退出状态： + 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 - [bind] 设定 Readline 键绑定和变量。 - - 绑定一个键序列到一个 Readline 函数或者宏，或者设定一个 - Readline 变量。非选项参数的语法和 ~/.inputrc 文件中的等 - 同，但是必须作为一个参数被传递， - 例如，bind '\\\C-x\\C-r\: re-read-init-file'. - - 选项： - -m 键映射 在此命令执行过程中使用指定的键映射。 - 可被接受的键映射名字有 emacs、emacs-standard、emacs- - meta、 - emacs-ctlx、vi、vi-move、vi-command、和 vi-insert。 - -l 列出函数名称。 - -P 列出函数名称和绑定。 - -p 以可以重新用作输入的格式列出函数名称和绑定。 - -S 列出可以启动宏的键序列以及它们的值 - -s 以可以重新用作输入的格式列出可以启动宏的键以及它们的 - 值。 - -V 列出变量名成和它们的值 - -v 以可以重新用作输入的格式列出变量的名称和它们的值 - -q 函数名 查询指定的函数可以由哪些键启动。 - -u 函数名 反绑定所有绑定至指定函数的键。 - -r 键序列 取消指定键序列的绑定。 - -f 文件名 从指定文件中读取键绑定。 - -x 键序列:shell命令\t当指定的键序列被输入时，执行指定的 shell 命令。 - -X 以可被重用的形式列出用 -x 绑定的键序列和命令。 +[bind] + 设定 Readline 键绑定和变量。 - 退出状态： - 除非使用了无法辨认的选项或者错误发生，否则返回0. + 绑定一个键序列到一个 Readline 函数或者宏，或者设定一个 + Readline 变量。非选项参数的语法和 ~/.inputrc 文件中的等 + 同，但是必须作为一个参数被传递， + 例如，bind '\\\C-x\\C-r\: re-read-init-file'. + + 选项： + -m 键映射 在此命令执行过程中使用指定的键映射。 + 可被接受的键映射名字有 emacs、emacs-standard、emacs- + meta、 + emacs-ctlx、vi、vi-move、vi-command、和 vi-insert。 + -l 列出函数名称。 + -P 列出函数名称和绑定。 + -p 以可以重新用作输入的格式列出函数名称和绑定。 + -S 列出可以启动宏的键序列以及它们的值 + -s 以可以重新用作输入的格式列出可以启动宏的键以及它们的 + 值。 + -V 列出变量名成和它们的值 + -v 以可以重新用作输入的格式列出变量的名称和它们的值 + -q 函数名 查询指定的函数可以由哪些键启动。 + -u 函数名 反绑定所有绑定至指定函数的键。 + -r 键序列 取消指定键序列的绑定。 + -f 文件名 从指定文件中读取键绑定。 + -x 键序列:shell命令\t当指定的键序列被输入时，执行指定的 shell 命令。 + -X 以可被重用的形式列出用 -x 绑定的键序列和命令。 + + 退出状态： + 除非使用了无法辨认的选项或者错误发生，否则返回0. - [test] 估值算术表达式。 - - 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 - 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 - 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 - 优先级从高至低。 - - - \tid++, id--\t变量后置加，后置减 - \t++id, --id\t变量前置加，前置减 - \t-, +\t\t一元减法，一元加法 - \t!, ~\t\t逻辑和位取反 - \t**\t\t指数 - \t*, /, %\t\t乘法，除法，取余数 - \t+, -\t\t增加，减少 - \t<<, >>\t\t向左和向右按位移位 - \t<=, >=, <, >\t比较 - \t==, !=\t\t等于，不等于 - \t&\t\t按位与 - \t^\t\t按位异或 - \t|\t\t按位或 - \t&&\t\t逻辑与 - \t||\t\t逻辑或 - \texpr ? expr : expr - \t\t\t条件操作符 - \t=, *=, /=, %=, - \t+=, -=, <<=, >>=, - \t&=, ^=, |=\t赋值 - - Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 - (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 +[test] + 估值算术表达式。 - 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 - 规则。 - - 退出状态： - 如果最后一个 ARG 参数估值为 0，则 let 返回 1； 否则 let 返回 0。 + 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 + 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 + 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 + 优先级从高至低。 + + + \tid++, id--\t变量后置加，后置减 + \t++id, --id\t变量前置加，前置减 + \t-, +\t\t一元减法，一元加法 + \t!, ~\t\t逻辑和位取反 + \t**\t\t指数 + \t*, /, %\t\t乘法，除法，取余数 + \t+, -\t\t增加，减少 + \t<<, >>\t\t向左和向右按位移位 + \t<=, >=, <, >\t比较 + \t==, !=\t\t等于，不等于 + \t&\t\t按位与 + \t^\t\t按位异或 + \t|\t\t按位或 + \t&&\t\t逻辑与 + \t||\t\t逻辑或 + \texpr ? expr : expr + \t\t\t条件操作符 + \t=, *=, /=, %=, + \t+=, -=, <<=, >>=, + \t&=, ^=, |=\t赋值 + + Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 + (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 + + 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 + 规则。 + + 退出状态： + 如果最后一个 ARG 参数估值为 0，则 let 返回 1； 否则 let 返回 0。 *[other] 显示其他命令帮助信息 . } @@ -1540,4 +1611,6 @@ $cmdName -> information = 这些 shell 命令是内部定义的。请输入 `help' 以获取一个列表。 输入 `help 名称' 以得到有关函数`名称'的更多信息。 使用 `info bash' 来获得关于 shell 的更多一般性信息。 - 使用 `man -k' 或 `info' 来获取不在列表中的命令的更多信息。 \ No newline at end of file + 使用 `man -k' 或 `info' 来获取不在列表中的命令的更多信息。 + +helperr = 没有与{$name}匹配的帮助主题。尝试使用"help help"、"man -k {$name} 或 "info {$name}"。 \ No newline at end of file diff --git a/bash-5.1/resources/zh-HK/message.ftl b/bash-5.1/resources/zh-HK/message.ftl index 79055394..6971cd97 100644 --- a/bash-5.1/resources/zh-HK/message.ftl +++ b/bash-5.1/resources/zh-HK/message.ftl @@ -10,11 +10,13 @@ $cmdName -> 退出状态： 返回被继续的任务的状态。 -[command1] 估值条件表达式。 +[command1] + 估值条件表达式。 是内建命令 test 的同义词，但是最后一个参数必须是 字符 `]'，以匹配起始的 `['。 -[command2] 在当前 shell 中执行一个文件中的命令。 +[command2] + 在当前 shell 中执行一个文件中的命令。 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS @@ -23,18 +25,21 @@ $cmdName -> 退出状态： 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 -[command3] 空的命令。 +[command3] + 空的命令。 没有效果； 此命令不做任何操作。 退出状态： 总是成功。 -[command4] 估值条件表达式。 +[command4] + 估值条件表达式。 是内建命令 test 的同义词，但是最后一个参数必须是 字符 `]'，以匹配起始的 `['。 -[command5] 执行条件命令。 +[command5] + 执行条件命令。 根据条件表达式 EXPRESSION 的估值返回状态0或1。表达式按照 `test' 内建的相同条件组成，或者可以有下列操作符连接而成： @@ -55,7 +60,8 @@ $cmdName -> 退出状态： 根据 EXPRESSION 的值为0或1。 -[command6] 算术 for 循环。 +[command6] + 算术 for 循环。 等价于 (( EXP1 )) @@ -68,7 +74,8 @@ $cmdName -> 退出状态： 返回最后执行的命令的状态。 -[command7] 将命令组合为一个单元。 +[command7] + 将命令组合为一个单元。 运行组中的命令集合。这是对整个命令集合 做重定向的方法之一。 @@ -77,7 +84,7 @@ $cmdName -> 返回最后一个执行的命令的状态。 [set] - 设定或取消设定 shell 选项和位置参数的 + 设定或取消设定 shell 选项和位置参数的 改变 shell 选项和位置参数的值，或者显示 shell 变量的 名称和值。 @@ -154,1223 +161,1287 @@ $cmdName -> 退出状态： 返回成功除非使用了无效的参数。 - [read] 从标准输入读取一行并将其分为不同的域。 - - 从标准输入读取单独的一行，或者如果使用了 -u 选项，从文件描述符 FD 中读 - 取。 - 该行被分割成域，如同词语分割一样，并且第一个词被赋值给第一个 NAME 变量， - 第二 - 个词被赋值给第二个 NAME 变量，如此继续，直到剩下所有的词被赋值给最后一个 - NAME - 变量。只有 $IFS 变量中的字符被认作是词语分隔符。 - - 如果没有提供 NAME 变量，则读取的行被存放在 REPLY 变量中。 - - 选项： - -a array 将词语赋值给 ARRAY 数组变量的序列下标成员，从零开始 - -d delim 持续读取直到读入 DELIM 变量中的第一个字符，而不是换行符 - -e 使用 Readline 获取行 - -i text 使用 TEXT 文本作为 Readline 的初始文字 - -n nchars 读取 nchars 个字符之后返回，而不是等到读取换行符。 - 但是分隔符仍然有效，如果遇到分隔符之前读取了不足 nchars 个字符。 - -N nchars 在准确读取了 nchars 个字符之后返回，除非遇到文件结束符或者读 - 超时， - 任何的分隔符都被忽略 - -p prompt 在尝试读取之前输出 PROMPT 提示符并且不带 - 换行符 - -r 不允许反斜杠转义任何字符 - -s 不回显终端的任何输入 - -t timeout 如果在 TIMEOUT 秒内没有读取一个完整的行则超时并且返回失 - 败。 - TMOUT 变量的值是默认的超时时间。TIMEOUT 可以是小数。 - 如果 TIMEOUT 是 0，那么仅当在指定的文件描述符上输入有效的时候， - read 才返回成功；否则它将立刻返回而不尝试读取任何数据。 - 如果超过了超时时间，则返回状态码大于 128 - -u fd 从文件描述符 FD 中读取，而不是标准输入 - - 退出状态： - 返回码为零，除非遇到了文件结束符、读超时（且返回码不大于128）、 - 出现了变量赋值错误或者无效的文件描述符作为参数传递给了 -u 选项。 - - [type] 显示命令类型的信息。 - - 对于每一个 NAME 名称，指示如果作为命令它将如何被解释。 - - 选项： - -a 显示所有包含名称为 NAME 的可执行文件的位置； - 包括别名、内建和函数。仅当 `-p' 选项没有使用时 - -f 抑制 shell 函数查询 - -P 为每个 NAME 名称惊醒 PATH 路径搜索，即使它是别名、 - 内建或函数，并且返回将被执行的磁盘上文件的名称。 - -p 返回将被执行的磁盘上文件的名称，或者当 `type -t NAME' - 不返回 `file' 时，不返回任何值。 - -t 返回下列词中的任何一个 `alias'、`keyword'、 - `function'、`builtin'、`file' 或者 `'，相应地如果 NAME 是 - 一个别名、shell 保留字、shell 函数、shell 内建、 - 磁盘文件或没有找到。 - - 参数： - NAME 将要解析的命令。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - - [trap] 对信号和其他事件设陷阱。 - - 定义一个处理器，在 shell 接收到信号和其他条件下执行。 - - ARG 参数是当 shell 接收到 SIGNAL_SPEC 信号时读取和执行的命令。 - 如果没有指定 ARG 参数 (并且只给出一个 SIGNAL_SPEC 信号) 或者 - ARG 参数为 - `-'，每一个指定的参数会被重置为原始值。如果 ARG 参数是一个空串，则每一 - 个 - SIGNAL_SPEC 信号会被 shell 和它启动的命令忽略。 - - 如果一个 SIGNAL_SPEC 信号是 EXIT (0) ，则 ARG 命令会在 shell 退出时被 - 执行。如果一个 SIGNAL_SPEC 信号是 DEBUG，则 ARG命令会在每一个简单命 - 令之前执行。 - - 如果不提供参数，trap 打印列表显示每一个与每一个信号相关联的命令。 - - 选项： - -l 打印一个信号名称和它们对应的编号的列表 - -p 打印与每个 SIGNAL_SPEC 信号相关联的陷阱命令 - - 每一个 SIGNAL_SPEC 信号可以是 中的信号名称或者信号编号。 - 信号名称大小写敏感且可以使用 SIG 前缀。信号可用 \kill -信号 $$\ - 发送给 shell。 - - 返回成功，除非使用了无效的选项或者 SIGSPEC。 - - [alias] 定义或显示别名。 - - 不带参数时，`alias' 以可重用的格式 - `alias 名称=值'在标准输出设备上打印别名列表。 - - 否则，对于每个给定值的名称定义一个别名。 - 值末尾的空格会使下一个词被检测作为别名替换展开。 - - 选项： - -p 以可重用的格式打印所有的已定义的别名 - - 退出状态： - 除非一个没有定义的名字被作为参数提供，否则 alias - 返回值为真。 - - [unalias] 从别名定义列表中删除每一个“名字”。 - - 选项： - -a 删除所有的别名定义 - - 返回成功，除非“名字”不是一个已存在的别名。 - - [break] 退出 for、while 或 until 循环 - - 退出一个 FOR、WHILE 或 UNTIL 循环。如果指定了N，则跳出N重 - 循环 - - 退出状态： - 退出状态为0除非 N 不大于或等于 1。 - - [continue] 继续 for、while 或 until 循环。 - - 继续当前 FOR、WHILE 或 UNTIL 循环的下一步。 - 如果指定了 N， 则继续当前的第 N 重循环。 - - 退出状态： - 退出状态为 0 除非 N 不大于或等于1。 - - [builtin] 执行 shell 内建。 - - 带参数 ARGs 执行 SHELL-BUILTIN 内建，并且不做命令查询 - 在希望以 shell 函数的形式来重新实现 shell 内建， - 并且希望在函数之内执行该 shell 内建的情况下有用处。 - - 退出状态： - 以 SHELL-BUILTIN 内建的退出状态为准，或者如果 SHELL-BUILTIN 不是一个 - shell 内建时为假。 - - [caller] 返回当前子调用的上下文。 - - 不带有 EXPR 时，返回 \$line $filename\。带有 EXPR 时，返回 - \$line $subroutine $filename\；这个额外的信息可以被用于提供 - 栈追踪。 - - EXPR 的值 显示了到当前调用帧需要回去多少个调用帧；顶部帧 - 是第 0 帧。 - - 退出状态： - 除非 shell 不在执行一个 shell 函数或者 EXPR 无效，否则返回结 - 果为0。 - - [cd]改变 shell 工作目录。 - - 改变当前目录至 DIR 目录。默认的 DIR 目录是 shell 变量 HOME - 的值。 - - 变量 CDPATH 定义了含有 DIR 的目录的搜索路径，其中不同的目录名称由冒号 (:) - 分隔。 - 一个空的目录名称表示当前目录。如果要切换到的 DIR 由斜杠 (/) 开头，则 - CDPATH - 不会用上变量。 - - 如果路径找不到，并且 shell 选项 `cdable_vars' 被设定，则参数词被假定为一 - 个 - 变量名。如果该变量有值，则它的值被当作 DIR 目录。 - - 选项： - -L 强制跟随符号链接: 在处理 `..' 之后解析 DIR 中的符号链接。 - -P 使用物理目录结构而不跟随符号链接: 在处理 `..' 之前解析 DIR 中的符 - 号链接。 - -e 如果使用了 -P 参数，但不能成功确定当前工作目录时，返回非零的返回 - 值。 - -@ 在支持拓展属性的系统上，将一个有这些属性的文件当作有文件属性的目 - 录。 - - 默认情况下跟随符号链接，如同指定 `-L'。 - `..' 使用移除向前相邻目录名成员直到 DIR 开始或一个斜杠的方式处理。 - - 退出状态： - 如果目录改变，或在使用 -P 选项时 $PWD 修改成功时返回 0，否则非零。 - - [pwd]打印当前工作目录的名字。 - - 选项： - -L 打印 $PWD 变量的值，如果它包含了当前的工作目录 - -P 打印当前的物理路径，不带有任何的符号链接 - - 默认情况下，`pwd' 的行为和带 `-L' 选项一致 - - 退出状态： - 除非使用了无效选项或者当前目录不可读，否则返回状态为0。 - - [true]空的命令。 - - 没有效果； 此命令不做任何操作。 - - 退出状态： - 总是成功。 - [shopt] 设定和取消设定 shell 选项。 - - 改变每个 shell 选项 OPTNAME 的设定。不带参数时， - 列出每个提供的 OPTNAME，否则列出所有 shell 选项； - 同时标注每一个选项是否被设定。 - - 选项： - -o 限制 OPTNAME 为定义用于`set -o' 的选项 - -p 打印每个 shell 选项并标注它的状态。 - -q 抑制输出 - -s 启用(设定)每个 OPTNAME 选项 - -u 禁用(取消设定)每个 OPTNAME 选项 - - 退出状态： - 如果 OPTNAME 选项被启用则返回成功；如果是 - 无效的选项或 OPTNAME 被禁用则失败。 - - [false] 返回一个不成功的结果。 - - 退出状态： - 总是失败。 - - [command] 执行一个简单命令或者显示命令的相关信息。 - - 带 ARGS 参数运行 COMMAND 命令且抑制 shell 函数查询，或显示 - 指定的 COMMAND 命令的信息。可以在存在相同名称的函数定义的 - 情况下用于启动磁盘上的命令。 - - 选项： - -p 使用 PATH 变量的一个默认值以确保所有的标准工具都能被找到。 - -v 打印 COMMAND 命令的描述，和 `type' 内建相似 - -V 打印每个 COMMAND 命令的详细描述 - - 退出状态 - 返回 COMMAND 命令的返回状态，或者当找不到 COMMAND 命令时失败。 - - [echo] 将参数写到标准输出。 - - 在标准输出上，显示用空格分割的 ARG 参数后跟一个换行。 - - 选项： - -n 不要追加换行 - -e 启用下列反斜杠转义的解释 - -E 显式地抑制对于反斜杠转义的解释 - - `echo' 对下列反斜杠字符进行转义： - \a 警告(响铃) - \\b 退格 - \\c 抑制更多的输出 - \\e 转义字符 - \\f 换页字符 - \\t换行 - \\r\t回车 - \\t\t横向制表符 - \\v\t纵向制表符 - \\\\\t反斜杠 - \\0nnn 以 NNN（八进制）为 ASCII 码的字符。NNN 可以是 0 到 3 个八进制 - 位 - \\xHH 以 HH（十六进制）为值的八比特字符。HH 可以是一个或两个十六进制 - 位 - \\uHHHH 以 HHHH（十六进制）为值的 Unicode 字符。HHHH 可以是一个到 - 四个十六进制位。 - \\UHHHHHHHH 以 HHHHHHHH（十六进制）为值的 Unicode 字符。 - HHHHHHHH 可以是一到八个十六进制位。 - - 退出状态： - 返回成功除非有写错误发生。 - - 写参数至标准输出设备。 - - 在标准输出设备上显示 ARGs 参数和一个换行。 - - 选项： - -n 不附加换行 - - 退出状态： - 除非写错误发生，否则返回成功。 - - [enable] 启用和禁用 shell 内建。 - - 启用和禁用 shell 的内建命令。禁用使您能够执行一个和内建 - 命令同名的磁盘上的命令，而无须使用完整的路径名。 - - - 选项： - -a 打印一个内建的列表，并显示其中每一个是否启用 - -n 禁用每一个 NAME 内建或者显示一个被禁用的内建的列表 - -p 以可重用的格式打印一个内建的列表 - -s 仅打印Posix `special' 内建的名称 - - 控制动态加载的选项： - -f 从共享对象 FILENAME 文件中加载 NAME 内建 - -d 删除以 -f 选项加载的内建 - - 不带选项时，每一个 NAME 内建都被启用。 - - 如果要使用 $PATH 中找到的 `test' 而不是 shell 内建的版本， - 输入 `enable -n test'。 - - 退出状态： - 返回成功，除非 NAME 不是一个 shell 内建或者有错误发生。 - - [getopts] 解析选项参数。 - - getopts 被 shell 过程用于解析可定位的参数作为选项。 - +[read] + 从标准输入读取一行并将其分为不同的域。 - OPTSTRING 字符串包含待识别的选项字母；如果一个字母后面跟 - 着分号，则该选项需要一个参数，而该参数应用空格与选项分开。 + 从标准输入读取单独的一行，或者如果使用了 -u 选项，从文件描述符 FD 中读 + 取。 + 该行被分割成域，如同词语分割一样，并且第一个词被赋值给第一个 NAME 变量， + 第二 + 个词被赋值给第二个 NAME 变量，如此继续，直到剩下所有的词被赋值给最后一个 + NAME + 变量。只有 $IFS 变量中的字符被认作是词语分隔符。 + 如果没有提供 NAME 变量，则读取的行被存放在 REPLY 变量中。 - 每次启动时，getopts 会将下一个选项放到 shell 变量 $name - 中，如果 name 变量不存在则先将其初始化，而下一个待处 - 理的参数序号放入 shell 变量 OPTIND 中。OPTIND 变量在每 - 次 shell 或者 shell 脚本启动时都被初始化为1。当一个选项要 - 求有一个参数时，getopts 将参数放入 shell 变量 OPTARG - 中。 - - getopts 有两种报告错误的方法。如果 OPTSTRING 变量的第 - 一个字符是冒号，getopts 使用沉默错误报告。在这种模式 - 下，不会打印错误消息。如果看到了一个无效的选项， - getopts 将找到的选项字符放至 OPTARG 变量中。如果一个必 - 须的选项没有找到，getopts 放一个 ':' 到 NAME 变量中并且设 - 置 OPTARG 变量为找到的选项字符。如果 getopts 不在沉默模 - 式中，并且遇到了一个无效的选项，getopts 放置一个 '?' 到 NAME - 变量中并且取消设定 OPTARG变量。如果必须的选项没有找到， - 一个'?'会被放入 NAME变量中，OPTARG 将被取消设定，并且会 - 打印一个诊断信息。 - - 如果 shell 变量 OPTERR 的值为0，getopts 禁用 - 错误信息的打印，即使 OPTSTRING 变量的第一个字符不是一 - 个冒号。OPTERR 的默认值为1. + 选项： + -a array 将词语赋值给 ARRAY 数组变量的序列下标成员，从零开始 + -d delim 持续读取直到读入 DELIM 变量中的第一个字符，而不是换行符 + -e 使用 Readline 获取行 + -i text 使用 TEXT 文本作为 Readline 的初始文字 + -n nchars 读取 nchars 个字符之后返回，而不是等到读取换行符。 + 但是分隔符仍然有效，如果遇到分隔符之前读取了不足 nchars 个字符。 + -N nchars 在准确读取了 nchars 个字符之后返回，除非遇到文件结束符或者读 + 超时，任何的分隔符都被忽略 + -p prompt 在尝试读取之前输出 PROMPT 提示符并且不带换行符 + -r 不允许反斜杠转义任何字符 + -s 不回显终端的任何输入 + -t timeout 如果在 TIMEOUT 秒内没有读取一个完整的行则超时并且返回失 + 败。TMOUT 变量的值是默认的超时时间。TIMEOUT 可以是小数。 + 如果 TIMEOUT 是 0，那么仅当在指定的文件描述符上输入有效的时候， + read 才返回成功；否则它将立刻返回而不尝试读取任何数据。 + 如果超过了超时时间，则返回状态码大于 128 + -u fd 从文件描述符 FD 中读取，而不是标准输入 + + 退出状态： + 返回码为零，除非遇到了文件结束符、读超时（且返回码不大于128）、 + 出现了变量赋值错误或者无效的文件描述符作为参数传递给了 -u 选项。 + +[type] + 显示命令类型的信息。 + + 对于每一个 NAME 名称，指示如果作为命令它将如何被解释。 - getopts 通常解析可定位的参数($0 - $9)，不过如果提供了 - 更多的参数，它们反而会被解析。 + 选项： + -a 显示所有包含名称为 NAME 的可执行文件的位置； + 包括别名、内建和函数。仅当 `-p' 选项没有使用时 + -f 抑制 shell 函数查询 + -P 为每个 NAME 名称惊醒 PATH 路径搜索，即使它是别名、 + 内建或函数，并且返回将被执行的磁盘上文件的名称。 + -p 返回将被执行的磁盘上文件的名称，或者当 `type -t NAME' + 不返回 `file' 时，不返回任何值。 + -t 返回下列词中的任何一个 `alias'、`keyword'、 + `function'、`builtin'、`file' 或者 `'，相应地如果 NAME 是 + 一个别名、shell 保留字、shell 函数、shell 内建、 + 磁盘文件或没有找到。 + + 参数： + NAME 将要解析的命令。 - 退出状态： - 如果一个选项被找到则返回成功；如果遇到了选项的结尾或者 - 有错误发生则返回失败。 + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - [exec] 使用指定命令替换 shell。 - - 执行 COMMAND 命令，以指定的程序替换这个 shell。 - ARGUMENTS 参数成为 COMMAND命令的参数。如果 - 没有指定COMMAND 命令，则任何的重定向在当前 shell 中生效。 - - 选项： - -a 名称 作为第0个参数传递给 COMMAND 命令 - -c 在一个空环境中执行 COMMAND 命令 - -l 在COMMAND 命令的第0个参数中加一个短线 - - 如果命令不能被执行，则退出一个非交互式的 shell，除非 - shell 选项`execfail' 已经设定。 - - 退出状态： - 返回成功除非 COMMAND 命令没有找到或者出现一个重定向错误。 +[trap] + 对信号和其他事件设陷阱。 + + 定义一个处理器，在 shell 接收到信号和其他条件下执行。 + + ARG 参数是当 shell 接收到 SIGNAL_SPEC 信号时读取和执行的命令。 + 如果没有指定 ARG 参数 (并且只给出一个 SIGNAL_SPEC 信号) 或者 + ARG 参数为 + `-'，每一个指定的参数会被重置为原始值。如果 ARG 参数是一个空串，则每一 + 个 + SIGNAL_SPEC 信号会被 shell 和它启动的命令忽略。 + + 如果一个 SIGNAL_SPEC 信号是 EXIT (0) ，则 ARG 命令会在 shell 退出时被 + 执行。如果一个 SIGNAL_SPEC 信号是 DEBUG，则 ARG命令会在每一个简单命 + 令之前执行。 + + 如果不提供参数，trap 打印列表显示每一个与每一个信号相关联的命令。 + + 选项： + -l 打印一个信号名称和它们对应的编号的列表 + -p 打印与每个 SIGNAL_SPEC 信号相关联的陷阱命令 + + 每一个 SIGNAL_SPEC 信号可以是 中的信号名称或者信号编号。 + 信号名称大小写敏感且可以使用 SIG 前缀。信号可用 \kill -信号 $$\ + 发送给 shell。 + + 返回成功，除非使用了无效的选项或者 SIGSPEC。 - [exit] 退出shell。 - - 以状态 N 退出 shell。 如果 N 被省略，则退出状态 - 为最后一个执行的命令的退出状态。 +[alias] + 定义或显示别名。 + + 不带参数时，`alias' 以可重用的格式 + `alias 名称=值'在标准输出设备上打印别名列表。 + + 否则，对于每个给定值的名称定义一个别名。 + 值末尾的空格会使下一个词被检测作为别名替换展开。 + + 选项： + -p 以可重用的格式打印所有的已定义的别名 + + 退出状态： + 除非一个没有定义的名字被作为参数提供，否则 alias + 返回值为真。 - [logout] 退出一个登录 shell. - - 以状态 N 退出一个登录 shell。如果不在登录 shell 中执行，则 - 返回一个错误。 +[unalias] + 从别名定义列表中删除每一个“名字”。 + + 选项： + -a 删除所有的别名定义 + + 返回成功，除非“名字”不是一个已存在的别名。 - [fc] 从历史列表中显示或者执行命令。 - - fc 被用于从历史列表中列出或者重新编辑并执行命令。 - FIRST 和 LAST 变量可以是数字用于指定范围，或者 FIRST 可以是 - 字符串，意味着以这个字符串打头的最近的一个命令。 - - - 选项： - -e ENAME 选择使用哪个编辑器。默认的是 FCEDIT, 然后是 EDITOR， - 然后是 vi - -l 列出行而不编辑 - -n 列举时省略行号 - -r 反转行的顺序(最新行在前) - - 用 `fc -s [模式=替换 ...] [命令]' 的格式，COMMAND 命令会在 OLD=NEW - 替换之后被重新执行。 - - r='fc -s' 是一个有用的别名，这样的话输入 `r cc'会执行最后一个以 `cc' - 开头的命令，输入 `r'会重新执行最后一个命令。 - - - 退出状态： - 返回成功，或者执行的命令的状态；如果错误发生则返回非零。 +[break] + 退出 for、while 或 until 循环 + + 退出一个 FOR、WHILE 或 UNTIL 循环。如果指定了N，则跳出N重 + 循环 + + 退出状态： + 退出状态为0除非 N 不大于或等于 1。 - [fg] 将任务移至前台。 - - 将以 JOB_SPEC 标识的任务放至前台，使其成为 - 当前任务。如果 JOB_SPEC 不存在，shell 观念中的当前任务 - 将被使用。 - - 退出状态： - 放至前台的命令状态，或者当错误发生时为失败。 +[continue] + 继续 for、while 或 until 循环。 + + 继续当前 FOR、WHILE 或 UNTIL 循环的下一步。 + 如果指定了 N， 则继续当前的第 N 重循环。 + + 退出状态： + 退出状态为 0 除非 N 不大于或等于1。 - [bg] 移动任务至后台。 - - 将 JOB_SPEC 标识的任务放至后台，就像它们 - 是带 `&' 启动的一样。如果 JOB_SPEC 不存在，shell 观念中的 - 当前任务将会被使用。 - - 退出状态： - 返回成功除非任务管理没有启用或者错误发生。 +[builtin] + 执行 shell 内建。 + + 带参数 ARGs 执行 SHELL-BUILTIN 内建，并且不做命令查询 + 在希望以 shell 函数的形式来重新实现 shell 内建， + 并且希望在函数之内执行该 shell 内建的情况下有用处。 + + 退出状态： + 以 SHELL-BUILTIN 内建的退出状态为准，或者如果 SHELL-BUILTIN 不是一个 + shell 内建时为假。 - [hash] 记住或显示程序位置。 - - 确定并记住每一个给定 NAME 名称的命令的完整路径。 - 如果不提供参数，则显示已经记住的命令的信息。 - - 选项： - -d 忘记每一个已经记住的 NAME 的位置 - -l 以可作为输入重用的格式显示 - -p pathname 使用 pathname 路径作为 NAME 命令的全路径 - -r 忘记所有记住的位置 - -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 - NAME 名称，则每个位置前面会加上相应的 NAME 名称 - - 参数： - NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 - 令 - 列表中。 - - 退出状态： - 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 +[caller] + 返回当前子调用的上下文。 + + 不带有 EXPR 时，返回 $line $filename。带有 EXPR 时，返回 + $line $subroutine $filename；这个额外的信息可以被用于提供 + 栈追踪。 + + EXPR 的值 显示了到当前调用帧需要回去多少个调用帧；顶部帧 + 是第 0 帧。 + + 退出状态： + 除非 shell 不在执行一个 shell 函数或者 EXPR 无效，否则返回结 + 果为0。 - [help] 显示内建命令的相关信息。 - - 显示内建命令的简略信息。如果指定了 PATTERN 模式， - 给出所有匹配 PATTERN 模式的命令的详细帮助，否则打 - 印一个帮助主题列表 - - 选项： - -d 输出每个主题的简短描述 - -m 以伪 man 手册的格式显示使用方法 - -s 为每一个匹配 PATTERN 模式的主题仅显示一个用法 - 简介 - - 参数： - PATTERN 指定帮助主题的模式 - - 退出状态： - 返回成功，除非未找到 PATTERN 模式没有找到或者使用了无效选项。 +[cd] + 改变 shell 工作目录。 + + 改变当前目录至 DIR 目录。默认的 DIR 目录是 shell 变量 HOME + 的值。 + + 变量 CDPATH 定义了含有 DIR 的目录的搜索路径，其中不同的目录名称由冒号 (:) + 分隔。 + 一个空的目录名称表示当前目录。如果要切换到的 DIR 由斜杠 (/) 开头，则 + CDPATH + 不会用上变量。 + + 如果路径找不到，并且 shell 选项 `cdable_vars' 被设定，则参数词被假定为一 + 个 + 变量名。如果该变量有值，则它的值被当作 DIR 目录。 + + 选项： + -L 强制跟随符号链接: 在处理 `..' 之后解析 DIR 中的符号链接。 + -P 使用物理目录结构而不跟随符号链接: 在处理 `..' 之前解析 DIR 中的符 + 号链接。 + -e 如果使用了 -P 参数，但不能成功确定当前工作目录时，返回非零的返回 + 值。 + -@ 在支持拓展属性的系统上，将一个有这些属性的文件当作有文件属性的目 + 录。 + + 默认情况下跟随符号链接，如同指定 `-L'。 + `..' 使用移除向前相邻目录名成员直到 DIR 开始或一个斜杠的方式处理。 + + 退出状态： + 如果目录改变，或在使用 -P 选项时 $PWD 修改成功时返回 0，否则非零。 + +[pwd] + 打印当前工作目录的名字。 + + 选项： + -L 打印 $PWD 变量的值，如果它包含了当前的工作目录 + -P 打印当前的物理路径，不带有任何的符号链接 + + 默认情况下，`pwd' 的行为和带 `-L' 选项一致 + + 退出状态： + 除非使用了无效选项或者当前目录不可读，否则返回状态为0。 - [history] 显示或操纵历史列表。 - - 带行号显示历史列表，将每个被修改的条目加上 `*' 前缀。 - 参数 N 会仅列出最后的 N 个条目。 - - 选项： - -c 删除所有条目从而清空历史列表。 - -d 偏移量 从指定位置删除历史列表。负偏移量将从历史条目末尾 - 开始计数 - - -a 将当前会话的历史行追加到历史文件中 - -n 从历史文件中读取所有未被读取的行 - 并且将它们附加到历史列表 - -r 读取历史文件并将内容追加到历史列表中 - -w 将当前历史写入到历史文件中 - - -p 对每一个 ARG 参数展开历史并显示结果，而不存储到历史列表中 - -s 以单条记录追加 ARG 到历史列表中 - - 如果给定了 FILENAME 文件名，则它将被作为历史文件。否则 - 如果 $HISTFILE 变量有值的话使用之，不然使用 ~/.bash_history 文件。 - - 如果 $HISTTIMEFORMAT 变量被设定并且不为空，它的值会被用于 - strftime(3) 的格式字符串来打印与每一个显示的历史条目想关联的 - 时间戳，否则不打印时间戳。 - - 退出状态： - 返回成功，除非使用了无效的选项或者发生错误。 - [jobs] 显示任务状态。 - - 列出活动的任务。JOBSPEC 限制仅输出指定的任务。 - 不带选项时，所有活动任务的状态都会显示。 - - 选项： - -l 在正常信息基础上列出进程号 - -n 仅列出上次通告之后改变了状态的进程 - -p 仅列出进程号 - -r 限制仅输出运行中的任务 - -s 限制仅输出停止的任务 - - 如果使用了 -x 选项，ARG 参数中的所有任务声明会被替换为该任务 - 的进程组头领的进程号，然后执行 COMMAND 命令。 - - 退出状态： - 返回成功，除非使用了无效的选项或者有错误发生。 - 如果使用 -x 选项，则返回 COMMAND 命令的退出状态。 +[true] + 空的命令。 + + 没有效果； 此命令不做任何操作。 + + 退出状态： + 总是成功。 + +[shopt] + 设定和取消设定 shell 选项。 + + 改变每个 shell 选项 OPTNAME 的设定。不带参数时， + 列出每个提供的 OPTNAME，否则列出所有 shell 选项； + 同时标注每一个选项是否被设定。 + + 选项： + -o 限制 OPTNAME 为定义用于`set -o' 的选项 + -p 打印每个 shell 选项并标注它的状态。 + -q 抑制输出 + -s 启用(设定)每个 OPTNAME 选项 + -u 禁用(取消设定)每个 OPTNAME 选项 + + 退出状态： + 如果 OPTNAME 选项被启用则返回成功；如果是 + 无效的选项或 OPTNAME 被禁用则失败。 - [disown] 从当前 shell 中删除任务。 - - 从活动任务表中删除每一个 JOBSPEC 参数。不带任何 - JOBSPEC 参数时，shell 使用观念中的当前任务。 - - 选项： - -a 如果不提供 JOBSPEC 参数，则删除所有任务 - -h 标识每个 JOBSPEC 任务，从而当 shell 接收到 SIGHUP - 信号时不发送 SIGHUP 给指定任务 - -r 仅删除运行中的任务 - - 退出状态： - 返回成功除非使用了无效的选项或者 JOBSPEC 声明。 +[false] + 返回一个不成功的结果。 + + 退出状态： + 总是失败。 + +[command] + 执行一个简单命令或者显示命令的相关信息。 + + 带 ARGS 参数运行 COMMAND 命令且抑制 shell 函数查询，或显示 + 指定的 COMMAND 命令的信息。可以在存在相同名称的函数定义的 + 情况下用于启动磁盘上的命令。 + + 选项： + -p 使用 PATH 变量的一个默认值以确保所有的标准工具都能被找到。 + -v 打印 COMMAND 命令的描述，和 `type' 内建相似 + -V 打印每个 COMMAND 命令的详细描述 + + 退出状态 + 返回 COMMAND 命令的返回状态，或者当找不到 COMMAND 命令时失败。 + +[echo] + 将参数写到标准输出。 + + 在标准输出上，显示用空格分割的 ARG 参数后跟一个换行。 + + 选项： + -n 不要追加换行 + -e 启用下列反斜杠转义的解释 + -E 显式地抑制对于反斜杠转义的解释 + + `echo' 对下列反斜杠字符进行转义： + \a 警告(响铃) + \\b 退格 + \\c 抑制更多的输出 + \\e 转义字符 + \\f 换页字符 + \\t换行 + \\r\t回车 + \\t\t横向制表符 + \\v\t纵向制表符 + \\\\\t反斜杠 + \\0nnn 以 NNN（八进制）为 ASCII 码的字符。NNN 可以是 0 到 3 个八进制 + 位 + \\xHH 以 HH（十六进制）为值的八比特字符。HH 可以是一个或两个十六进制 + 位 + \\uHHHH 以 HHHH（十六进制）为值的 Unicode 字符。HHHH 可以是一个到 + 四个十六进制位。 + \\UHHHHHHHH 以 HHHHHHHH（十六进制）为值的 Unicode 字符。 + HHHHHHHH 可以是一到八个十六进制位。 + + 退出状态： + 返回成功除非有写错误发生。 + + 写参数至标准输出设备。 + + 在标准输出设备上显示 ARGs 参数和一个换行。 + + 选项： + -n 不附加换行 + + 退出状态： + 除非写错误发生，否则返回成功。 + +[enable] + 启用和禁用 shell 内建。 + + 启用和禁用 shell 的内建命令。禁用使您能够执行一个和内建 + 命令同名的磁盘上的命令，而无须使用完整的路径名。 + + + 选项： + -a 打印一个内建的列表，并显示其中每一个是否启用 + -n 禁用每一个 NAME 内建或者显示一个被禁用的内建的列表 + -p 以可重用的格式打印一个内建的列表 + -s 仅打印Posix `special' 内建的名称 + + 控制动态加载的选项： + -f 从共享对象 FILENAME 文件中加载 NAME 内建 + -d 删除以 -f 选项加载的内建 + + 不带选项时，每一个 NAME 内建都被启用。 + + 如果要使用 $PATH 中找到的 `test' 而不是 shell 内建的版本， + 输入 `enable -n test'。 + + 退出状态： + 返回成功，除非 NAME 不是一个 shell 内建或者有错误发生。 - [kill] 向一个任务发送一个信号。 - - 向以 PID 进程号或者 JOBSPEC 任务声明指定的进程发送一个以 - SIGSPEC 信号声明或 SIGNUM 信号编号命名的信号。如果没有指定 - SIGSPEC 或 SIGNUM，那么假定发送 SIGTERM 信号。 - - 选项： - -s sig SIG 是信号名称 - -n sig SIG 是信号编号 - -l 列出信号名称；如果参数后跟 `-l'则被假设为信号编号， - 而相应的信号名称会被列出 - - Kill 成为 shell 内建有两个理由：它允许使用任务编号而不是进程号， - 并且在可以创建的进程数上限达到是允许进程被杀死。 - - 退出状态： - 返回成功，除非使用了无效的选项或者有错误发生。 - - [let] 估值算术表达式。 - - 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 - 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 - 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 - 优先级从高至低。 - - - \tid++, id--\t变量后置加，后置减 - \t++id, --id\t变量前置加，前置减 - \t-, +\t\t一元减法，一元加法 - \t!, ~\t\t逻辑和位取反 - \t**\t\t指数 - \t*, /, %\t\t乘法，除法，取余数 - \t+, -\t\t增加，减少 - \t<<, >>\t\t向左和向右按位移位 - \t<=, >=, <, >\t比较 - \t==, !=\t\t等于，不等于 - \t&\t\t按位与 - \t^\t\t按位异或 - \t|\t\t按位或 - \t&&\t\t逻辑与 - \t||\t\t逻辑或 - \texpr ? expr : expr - \t\t\t条件操作符 - \t=, *=, /=, %=, - \t+=, -=, <<=, >>=, - \t&=, ^=, |=\t赋值 - - Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 - (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 - - 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 - 规则。 +[getopts] + 解析选项参数。 + + getopts 被 shell 过程用于解析可定位的参数作为选项。 + + + OPTSTRING 字符串包含待识别的选项字母；如果一个字母后面跟 + 着分号，则该选项需要一个参数，而该参数应用空格与选项分开。 + + + 每次启动时，getopts 会将下一个选项放到 shell 变量 $name + 中，如果 name 变量不存在则先将其初始化，而下一个待处 + 理的参数序号放入 shell 变量 OPTIND 中。OPTIND 变量在每 + 次 shell 或者 shell 脚本启动时都被初始化为1。当一个选项要 + 求有一个参数时，getopts 将参数放入 shell 变量 OPTARG + 中。 + + getopts 有两种报告错误的方法。如果 OPTSTRING 变量的第 + 一个字符是冒号，getopts 使用沉默错误报告。在这种模式 + 下，不会打印错误消息。如果看到了一个无效的选项， + getopts 将找到的选项字符放至 OPTARG 变量中。如果一个必 + 须的选项没有找到，getopts 放一个 ':' 到 NAME 变量中并且设 + 置 OPTARG 变量为找到的选项字符。如果 getopts 不在沉默模 + 式中，并且遇到了一个无效的选项，getopts 放置一个 '?' 到 NAME + 变量中并且取消设定 OPTARG变量。如果必须的选项没有找到， + 一个'?'会被放入 NAME变量中，OPTARG 将被取消设定，并且会 + 打印一个诊断信息。 + + 如果 shell 变量 OPTERR 的值为0，getopts 禁用 + 错误信息的打印，即使 OPTSTRING 变量的第一个字符不是一 + 个冒号。OPTERR 的默认值为1. + + getopts 通常解析可定位的参数($0 - $9)，不过如果提供了 + 更多的参数，它们反而会被解析。 + + 退出状态： + 如果一个选项被找到则返回成功；如果遇到了选项的结尾或者 + 有错误发生则返回失败。 - [shift] 移位位置参数。 - - 重命名位置参数 $N+1、$N+2 ... 到 $1、$2 ... 如果没有给定 N， - 则假设为1. - - 退出状态： - 返回成功，除非 N 为负或者大于 $#。 - 返回 N，或者如果 shell 不在执行一个函数或引用脚本时，失败。 +[exec] + 使用指定命令替换 shell。 + + 执行 COMMAND 命令，以指定的程序替换这个 shell。 + ARGUMENTS 参数成为 COMMAND命令的参数。如果 + 没有指定COMMAND 命令，则任何的重定向在当前 shell 中生效。 + + 选项： + -a 名称 作为第0个参数传递给 COMMAND 命令 + -c 在一个空环境中执行 COMMAND 命令 + -l 在COMMAND 命令的第0个参数中加一个短线 + + 如果命令不能被执行，则退出一个非交互式的 shell，除非 + shell 选项`execfail' 已经设定。 + + 退出状态： + 返回成功除非 COMMAND 命令没有找到或者出现一个重定向错误。 - [suspend] 挂起 shell 执行。 - - 挂起 shell 的执行直到收到 SIGCONT 信号。 - 登录 shell 不可以被挂起，除非强制执行。 - - 选项： - -f 强制挂起，即使是登录 shell。 - - 退出状态： - 返回成功，除非没有启用任务控制或者有错误发生。 +[exit] + 退出shell。 + + 以状态 N 退出 shell。 如果 N 被省略，则退出状态 + 为最后一个执行的命令的退出状态。 - [eval] 对条件表达式进行估值。 - - 根据 EXPR 表达式的估值以状态 0 (真) 或 1 (伪) 退出。 - 表达式可以是一元或者二元的。一元表达式通常用于检测 - 文件状态。同时还有字符串操作符和数字比较操作符。 - - 文件操作符： - - -a 文件 如果文件存在则为真。 - -b 文件 如果文件为块特殊文件则为真。 - -c 文件 如果文件为字符特殊文件则为真。 - -d 文件 如果文件为目录则为真。 - -e 文件 如果文件存在则为真。 - -f 文件 如果文件存在且为常规文件则为真。 - -g 文件 如果文件的组属性设置打开则为真。 - -h 文件 如果文件为符号链接则为真。 - -L 文件 如果文件为符号链接则为真。 - -k 文件 如果文件的粘滞 (sticky) 位设定则为真。 - -p 文件 如果文件为命名管道则为真。 - -r 文件 如果文件对于您是可读的则为真。 - -s 文件 如果文件存在且不为空则为真。 - -S 文件 如果文件是套接字则为真。 - -t 文件描述符 如果文件描述符在一个终端上打开则为真。 - -u 文件 如果文件的用户数行设置打开则为真。 - -w 文件 如果文件对您是可写的则为真 - -x 文件 如果文件对您是可执行的则为真。 - -O 文件 如果文件是被您所有的则为真。 - -G 文件 如果文件被您的组所有则为真。 - -N 文件 如果文件上次被读取之后修改过则为真。 - - FILE1 -nt FILE2 如果 file1 文件新于 file2 文件则为真(根据 - 修改日期)。 - - FILE1 -ot FILE2 如果 file1 文件旧于 file2 文件则为真。 - - FILE1 -ef FILE2 如果 file1 文件是 file2 文件的硬链接则为真。 - - 字符串操作符 - - -z 字符串 如果字符串为空则为真。 - - -n 字符串 - 字符串 如果字符串不为空则为真。 - - STRING1 = STRING2 - 如果 string1 和 string2 字符串相同则为真。 - STRING1 != STRING2 - 如果 string1 和 string2 字符串不相同则为真。 - STRING1 < STRING2 - 如果按字典排序 string1 在 string2 串之前则为真。 - STRING1 > STRING2 - 如果按字典排序 string1 在 string2 串之前则为真。 - - 其他操作符： - - -o 选项 如果指定 shell 选项启用则为真。 - -v VAR 如果指定 Shell 变量 VAR 已赋值则为真。 - -R VAR 如果指定 Shell 变量 VAR 已赋值且为名称引用则为真。 - ! EXPR 如果表达式 expr 为假则为真。 - EXPR1 -a EXPR2 如果 expr1 和 expr2 都为真则为真。 - EXPR1 -o EXPR2 如果 expr1 和 expr2 有一个为真则为真。 - - arg1 OP arg2 算术测试。OP操作符可以是 -eq、-ne、 - -lt、-le、-gt、或 -ge 中的一个。 - - 二元算术操作返回真，如果 ARG1 参数等于、不等于、 - 小于、小于等于、大于、或者大于等于 ARG2 参数。 - - 退出状态： - 如果 EXPR 表达式估值为真则返回成功；如果 EXPR 表达式估值 - 为假或者使用了无效的参数则返回失败。 +[logout] + 退出一个登录 shell. + + 以状态 N 退出一个登录 shell。如果不在登录 shell 中执行，则 + 返回一个错误。 - [times] 显示进程时间 - - 打印 shell 及其所有子进程的累计用户空间和 - 系统空间执行时间。 - - 退出状态 - 总是成功。 +[fc] + 从历史列表中显示或者执行命令。 + + fc 被用于从历史列表中列出或者重新编辑并执行命令。 + FIRST 和 LAST 变量可以是数字用于指定范围，或者 FIRST 可以是 + 字符串，意味着以这个字符串打头的最近的一个命令。 + + + 选项： + -e ENAME 选择使用哪个编辑器。默认的是 FCEDIT, 然后是 EDITOR， + 然后是 vi + -l 列出行而不编辑 + -n 列举时省略行号 + -r 反转行的顺序(最新行在前) + + 用 `fc -s [模式=替换 ...] [命令]' 的格式，COMMAND 命令会在 OLD=NEW + 替换之后被重新执行。 + + r='fc -s' 是一个有用的别名，这样的话输入 `r cc'会执行最后一个以 `cc' + 开头的命令，输入 `r'会重新执行最后一个命令。 + + + 退出状态： + 返回成功，或者执行的命令的状态；如果错误发生则返回非零。 - [ulimit] 修改 shell 资源限制。 - - 在允许此类控制的系统上，提供对于 shell 及其创建的进程所可用的 - 资源的控制。 - - 选项： - -S 使用软 (`soft') 资源限制 - -H 使用硬 (`hard') 资源限制 - -a 所有当前限制都被报告 - -b 套接字缓存尺寸 - -c 创建的核文件的最大尺寸 - -d 一个进程的数据区的最大尺寸 - -e 最高的调度优先级 (`nice') - -f 有 shell 及其子进程可以写的最大文件尺寸 - -i 最多的可以挂起的信号数 - -k 分配给此进程的最大 kqueue 数量 - -l 一个进程可以锁定的最大内存尺寸 - -m 最大的内存进驻尺寸 - -n 最多的打开的文件描述符个数 - -p 管道缓冲区尺寸 - -q POSIX 信息队列的最大字节数 - -r 实时调度的最大优先级 - -s 最大栈尺寸 - -t 最大的CPU时间，以秒为单位 - -u 最大用户进程数 - -v 虚拟内存尺寸 - -x 最大的文件锁数量 - -P 最大伪终端数量 - -T 最大线程数量 - - 并非所有选项在所有系统上可用。 - - 如果提供了 LIMIT 变量，则它为指定资源的新的值；特别的 LIMIT 值为 - `soft'、`hard'和`unlimited'，分别表示当前的软限制，硬限制和无限制。 - 否则打印指定资源的当前限制值，不带选项则假定为 -f - - 取值都是 1024 字节为单位，除了 -t 以秒为单位，-p 以 512 字节递增， - -u 为无范围的进程数量。 - - 退出状态： - 返回成功，除非使用了无效的选项或者错误发生。 +[fg] + 将任务移至前台。 + + 将以 JOB_SPEC 标识的任务放至前台，使其成为 + 当前任务。如果 JOB_SPEC 不存在，shell 观念中的当前任务 + 将被使用。 + + 退出状态： + 放至前台的命令状态，或者当错误发生时为失败。 + +[bg] + 移动任务至后台。 + + 将 JOB_SPEC 标识的任务放至后台，就像它们 + 是带 `&' 启动的一样。如果 JOB_SPEC 不存在，shell 观念中的 + 当前任务将会被使用。 + + 退出状态： + 返回成功除非任务管理没有启用或者错误发生。 - [umask] 显示或设定文件模式掩码。 - - 设定用户文件创建掩码为 MODE 模式。如果省略了 MODE，则 - 打印当前掩码的值。 - - 如果 MODE 模式以数字开头，则被当作八进制数解析；否则是一个 - chmod(1) 可接收的符号模式串。 - - 选项： - -p 如果省略 MODE 模式，以可重用为输入的格式输入 - -S 以符号形式输出，否则以八进制数格式输出 - - 退出状态： - 返回成功，除非使用了无效的 MODE 模式或者选项。 +[hash] + 记住或显示程序位置。 + + 确定并记住每一个给定 NAME 名称的命令的完整路径。 + 如果不提供参数，则显示已经记住的命令的信息。 + + 选项： + -d 忘记每一个已经记住的 NAME 的位置 + -l 以可作为输入重用的格式显示 + -p pathname 使用 pathname 路径作为 NAME 命令的全路径 + -r 忘记所有记住的位置 + -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 + NAME 名称，则每个位置前面会加上相应的 NAME 名称 + + 参数： + NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 + 令 + 列表中。 + + 退出状态： + 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 + +[help] + 显示内建命令的相关信息。 + + 显示内建命令的简略信息。如果指定了 PATTERN 模式， + 给出所有匹配 PATTERN 模式的命令的详细帮助，否则打 + 印一个帮助主题列表 + + 选项： + -d 输出每个主题的简短描述 + -m 以伪 man 手册的格式显示使用方法 + -s 为每一个匹配 PATTERN 模式的主题仅显示一个用法 + 简介 + + 参数： + PATTERN 指定帮助主题的模式 + + 退出状态： + 返回成功，除非未找到 PATTERN 模式没有找到或者使用了无效选项。 - [return] 等待任务完成并返回退出状态。 - - 等待以 ID 编号识别的进程，其中 ID 可以是进程编号或者任务声明， - 并报告它的终止状态。如果 ID 没有给出，则等待所有的当前活跃子 - 进程，并且返回状态为零。如果 ID 是任务声明，等待任务管道中的 - 所有进程。 - - 若给定了 -n 选项，等待下一个任务完成并返回其状态。 - - 若给定了 -f 选项，且已启用了任务控制，则等待指定的 ID 终止 - 而非等待它改变状态。 - 退出状态： - 返回最后一个 ID 进程的状态；如果使用了无效的 ID 或者选项则失败。 +[history] + 显示或操纵历史列表。 + + 带行号显示历史列表，将每个被修改的条目加上 `*' 前缀。 + 参数 N 会仅列出最后的 N 个条目。 + + 选项： + -c 删除所有条目从而清空历史列表。 + -d 偏移量 从指定位置删除历史列表。负偏移量将从历史条目末尾 + 开始计数 + + -a 将当前会话的历史行追加到历史文件中 + -n 从历史文件中读取所有未被读取的行 + 并且将它们附加到历史列表 + -r 读取历史文件并将内容追加到历史列表中 + -w 将当前历史写入到历史文件中 + + -p 对每一个 ARG 参数展开历史并显示结果，而不存储到历史列表中 + -s 以单条记录追加 ARG 到历史列表中 + + 如果给定了 FILENAME 文件名，则它将被作为历史文件。否则 + 如果 $HISTFILE 变量有值的话使用之，不然使用 ~/.bash_history 文件。 + + 如果 $HISTTIMEFORMAT 变量被设定并且不为空，它的值会被用于 + strftime(3) 的格式字符串来打印与每一个显示的历史条目想关联的 + 时间戳，否则不打印时间戳。 + + 退出状态： + 返回成功，除非使用了无效的选项或者发生错误。 + +[jobs] + 显示任务状态。 + + 列出活动的任务。JOBSPEC 限制仅输出指定的任务。 + 不带选项时，所有活动任务的状态都会显示。 + + 选项： + -l 在正常信息基础上列出进程号 + -n 仅列出上次通告之后改变了状态的进程 + -p 仅列出进程号 + -r 限制仅输出运行中的任务 + -s 限制仅输出停止的任务 + + 如果使用了 -x 选项，ARG 参数中的所有任务声明会被替换为该任务 + 的进程组头领的进程号，然后执行 COMMAND 命令。 + + 退出状态： + 返回成功，除非使用了无效的选项或者有错误发生。 + 如果使用 -x 选项，则返回 COMMAND 命令的退出状态。 - [wait] 等待进程完成并且返回退出状态。 - - 等待指定进程并报告它的终止状态。如果没有提供 PID，则当前所有的活跃 - 子进程都会被等待，并且返回码为零。PID 必须为进程号。 - - 退出状态： - 返回进程 ID 的状态；如果 PID 是无效的进程号或者指定了无效的选项则失败。 +[disown] + 从当前 shell 中删除任务。 + + 从活动任务表中删除每一个 JOBSPEC 参数。不带任何 + JOBSPEC 参数时，shell 使用观念中的当前任务。 + + 选项： + -a 如果不提供 JOBSPEC 参数，则删除所有任务 + -h 标识每个 JOBSPEC 任务，从而当 shell 接收到 SIGHUP + 信号时不发送 SIGHUP 给指定任务 + -r 仅删除运行中的任务 + + 退出状态： + 返回成功除非使用了无效的选项或者 JOBSPEC 声明。 - [for] 为列表中的每个成员执行命令。 - - “for”循环为列表中的每个成员执行一系列的命令。如果没有 - “in <词语> ...;”则假定使用“in \$@\”。对于 <词语> 中的每 - 个元素，<名称> 变量被设定为该元素后执行 <命令>。 +[kill] + 向一个任务发送一个信号。 + + 向以 PID 进程号或者 JOBSPEC 任务声明指定的进程发送一个以 + SIGSPEC 信号声明或 SIGNUM 信号编号命名的信号。如果没有指定 + SIGSPEC 或 SIGNUM，那么假定发送 SIGTERM 信号。 + + 选项： + -s sig SIG 是信号名称 + -n sig SIG 是信号编号 + -l 列出信号名称；如果参数后跟 `-l'则被假设为信号编号， + 而相应的信号名称会被列出 + + Kill 成为 shell 内建有两个理由：它允许使用任务编号而不是进程号， + 并且在可以创建的进程数上限达到是允许进程被杀死。 + + 退出状态： + 返回成功，除非使用了无效的选项或者有错误发生。 - 退出状态： - 返回最后执行的命令的状态。 +[let] + 估值算术表达式。 + + 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 + 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 + 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 + 优先级从高至低。 + + + \tid++, id--\t变量后置加，后置减 + \t++id, --id\t变量前置加，前置减 + \t-, +\t\t一元减法，一元加法 + \t!, ~\t\t逻辑和位取反 + \t**\t\t指数 + \t*, /, %\t\t乘法，除法，取余数 + \t+, -\t\t增加，减少 + \t<<, >>\t\t向左和向右按位移位 + \t<=, >=, <, >\t比较 + \t==, !=\t\t等于，不等于 + \t&\t\t按位与 + \t^\t\t按位异或 + \t|\t\t按位或 + \t&&\t\t逻辑与 + \t||\t\t逻辑或 + \texpr ? expr : expr + \t\t\t条件操作符 + \t=, *=, /=, %=, + \t+=, -=, <<=, >>=, + \t&=, ^=, |=\t赋值 + + Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 + (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 + + 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 + 规则。 + +[shift] + 移位位置参数。 + + 重命名位置参数 $N+1、$N+2 ... 到 $1、$2 ... 如果没有给定 N， + 则假设为1. + + 退出状态： + 返回成功，除非 N 为负或者大于 $#。 + 返回 N，或者如果 shell 不在执行一个函数或引用脚本时，失败。 - [select] 从列表中选取词并且执行命令。 - - <词语...> 被展开，生成一个词的列表。展开的词集合被打印 - 在标准错误输出设备上，每个以一个数字做前缀。如果没有 `in WORDS' - 则假定使用`in \$@\'。PS3提示符会被显示并且从标准输入读入一行 - 如果该行由被显示的词对应的数字组成，则 NAME 变量被设定为相应 - 的词。如果行为空，则 WORDS 变量和提示符被重新显示。如果读取了 - 文件结束符，则命令完成。读入任何其他的值会导致 NAME 变量被设定 - 为空。读入的行被存放在变量 REPLY 中。COMMANDS 命令在每次选择 - 之后执行直到执行一个 break 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[suspend] + 挂起 shell 执行。 + + 挂起 shell 的执行直到收到 SIGCONT 信号。 + 登录 shell 不可以被挂起，除非强制执行。 + + 选项： + -f 强制挂起，即使是登录 shell。 + + 退出状态： + 返回成功，除非没有启用任务控制或者有错误发生。 + +[eval] + 对条件表达式进行估值。 + + 根据 EXPR 表达式的估值以状态 0 (真) 或 1 (伪) 退出。 + 表达式可以是一元或者二元的。一元表达式通常用于检测 + 文件状态。同时还有字符串操作符和数字比较操作符。 + + 文件操作符： + + -a 文件 如果文件存在则为真。 + -b 文件 如果文件为块特殊文件则为真。 + -c 文件 如果文件为字符特殊文件则为真。 + -d 文件 如果文件为目录则为真。 + -e 文件 如果文件存在则为真。 + -f 文件 如果文件存在且为常规文件则为真。 + -g 文件 如果文件的组属性设置打开则为真。 + -h 文件 如果文件为符号链接则为真。 + -L 文件 如果文件为符号链接则为真。 + -k 文件 如果文件的粘滞 (sticky) 位设定则为真。 + -p 文件 如果文件为命名管道则为真。 + -r 文件 如果文件对于您是可读的则为真。 + -s 文件 如果文件存在且不为空则为真。 + -S 文件 如果文件是套接字则为真。 + -t 文件描述符 如果文件描述符在一个终端上打开则为真。 + -u 文件 如果文件的用户数行设置打开则为真。 + -w 文件 如果文件对您是可写的则为真 + -x 文件 如果文件对您是可执行的则为真。 + -O 文件 如果文件是被您所有的则为真。 + -G 文件 如果文件被您的组所有则为真。 + -N 文件 如果文件上次被读取之后修改过则为真。 + + FILE1 -nt FILE2 如果 file1 文件新于 file2 文件则为真(根据 + 修改日期)。 + + FILE1 -ot FILE2 如果 file1 文件旧于 file2 文件则为真。 + + FILE1 -ef FILE2 如果 file1 文件是 file2 文件的硬链接则为真。 + + 字符串操作符 + + -z 字符串 如果字符串为空则为真。 + + -n 字符串 + 字符串 如果字符串不为空则为真。 + + STRING1 = STRING2 + 如果 string1 和 string2 字符串相同则为真。 + STRING1 != STRING2 + 如果 string1 和 string2 字符串不相同则为真。 + STRING1 < STRING2 + 如果按字典排序 string1 在 string2 串之前则为真。 + STRING1 > STRING2 + 如果按字典排序 string1 在 string2 串之前则为真。 + + 其他操作符： + + -o 选项 如果指定 shell 选项启用则为真。 + -v VAR 如果指定 Shell 变量 VAR 已赋值则为真。 + -R VAR 如果指定 Shell 变量 VAR 已赋值且为名称引用则为真。 + ! EXPR 如果表达式 expr 为假则为真。 + EXPR1 -a EXPR2 如果 expr1 和 expr2 都为真则为真。 + EXPR1 -o EXPR2 如果 expr1 和 expr2 有一个为真则为真。 + + arg1 OP arg2 算术测试。OP操作符可以是 -eq、-ne、 + -lt、-le、-gt、或 -ge 中的一个。 + + 二元算术操作返回真，如果 ARG1 参数等于、不等于、 + 小于、小于等于、大于、或者大于等于 ARG2 参数。 + + 退出状态： + 如果 EXPR 表达式估值为真则返回成功；如果 EXPR 表达式估值 + 为假或者使用了无效的参数则返回失败。 - [time] 报告管道执行的消耗时间。 - - 执行 PIPELINE 并且打印 PIPELINE 终结时实际时间、用户 CPU 时间和系统 - CPU 时间的总结。 - - 选项： - -p 用可迁移的 POSIX 格式打印用时总结。 - - TIMEFORMAT 变量的值被作为输出格式。 - - 退出状态： - 返回状态即PIPELINE 的返回状态。 +[times] + 显示进程时间 + + 打印 shell 及其所有子进程的累计用户空间和 + 系统空间执行时间。 + + 退出状态 + 总是成功。 + +[ulimit] + 修改 shell 资源限制。 + + 在允许此类控制的系统上，提供对于 shell 及其创建的进程所可用的 + 资源的控制。 + + 选项： + -S 使用软 (`soft') 资源限制 + -H 使用硬 (`hard') 资源限制 + -a 所有当前限制都被报告 + -b 套接字缓存尺寸 + -c 创建的核文件的最大尺寸 + -d 一个进程的数据区的最大尺寸 + -e 最高的调度优先级 (`nice') + -f 有 shell 及其子进程可以写的最大文件尺寸 + -i 最多的可以挂起的信号数 + -k 分配给此进程的最大 kqueue 数量 + -l 一个进程可以锁定的最大内存尺寸 + -m 最大的内存进驻尺寸 + -n 最多的打开的文件描述符个数 + -p 管道缓冲区尺寸 + -q POSIX 信息队列的最大字节数 + -r 实时调度的最大优先级 + -s 最大栈尺寸 + -t 最大的CPU时间，以秒为单位 + -u 最大用户进程数 + -v 虚拟内存尺寸 + -x 最大的文件锁数量 + -P 最大伪终端数量 + -T 最大线程数量 + + 并非所有选项在所有系统上可用。 + + 如果提供了 LIMIT 变量，则它为指定资源的新的值；特别的 LIMIT 值为 + `soft'、`hard'和`unlimited'，分别表示当前的软限制，硬限制和无限制。 + 否则打印指定资源的当前限制值，不带选项则假定为 -f + + 取值都是 1024 字节为单位，除了 -t 以秒为单位，-p 以 512 字节递增， + -u 为无范围的进程数量。 + + 退出状态： + 返回成功，除非使用了无效的选项或者错误发生。 + +[umask] + 显示或设定文件模式掩码。 + + 设定用户文件创建掩码为 MODE 模式。如果省略了 MODE，则 + 打印当前掩码的值。 + + 如果 MODE 模式以数字开头，则被当作八进制数解析；否则是一个 + chmod(1) 可接收的符号模式串。 + + 选项： + -p 如果省略 MODE 模式，以可重用为输入的格式输入 + -S 以符号形式输出，否则以八进制数格式输出 + + 退出状态： + 返回成功，除非使用了无效的 MODE 模式或者选项。 - [case] 基于模式匹配来执行命令。 - - 基于 PATTERN 模式匹配的词 WORD，有选择的执行 COMMANDS 命令。 - `|' 用于分隔多个模式。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[return] + 等待任务完成并返回退出状态。 + + 等待以 ID 编号识别的进程，其中 ID 可以是进程编号或者任务声明， + 并报告它的终止状态。如果 ID 没有给出，则等待所有的当前活跃子 + 进程，并且返回状态为零。如果 ID 是任务声明，等待任务管道中的 + 所有进程。 + + 若给定了 -n 选项，等待下一个任务完成并返回其状态。 + + 若给定了 -f 选项，且已启用了任务控制，则等待指定的 ID 终止 + 而非等待它改变状态。 + 退出状态： + 返回最后一个 ID 进程的状态；如果使用了无效的 ID 或者选项则失败。 - [if] 根据条件执行命令。 - - `if COMMANDS'列表被执行。如果退出状态为零，则执行`then COMMANDS' - 列表。否则按顺序执行每个 `elif COMMANDS'列表，并且如果它的退出状态为 - 零，则执行对应的 `then COMMANDS' 列表并且 if 命令终止。否则如果存在的 - 情况下，执行 `else COMMANDS'列表。整个结构的退出状态是最后一个执行 - 的命令的状态，或者如果没有条件测试为真的话，为零。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[wait] + 等待进程完成并且返回退出状态。 + + 等待指定进程并报告它的终止状态。如果没有提供 PID，则当前所有的活跃 + 子进程都会被等待，并且返回码为零。PID 必须为进程号。 + + 退出状态： + 返回进程 ID 的状态；如果 PID 是无效的进程号或者指定了无效的选项则失败。 + +[for] + 为列表中的每个成员执行命令。 + + “for”循环为列表中的每个成员执行一系列的命令。如果没有 + “in <词语> ...;”则假定使用“in \$@\”。对于 <词语> 中的每 + 个元素，<名称> 变量被设定为该元素后执行 <命令>。 + + 退出状态： + 返回最后执行的命令的状态。 - [while] 只要测试成功即执行命令。 - - 只要在 `while' COMMANDS 中的最终命令返回结果为0，则 - 展开并执行 COMMANDS 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[select] + 从列表中选取词并且执行命令。 + + <词语...> 被展开，生成一个词的列表。展开的词集合被打印 + 在标准错误输出设备上，每个以一个数字做前缀。如果没有 `in WORDS' + 则假定使用`in \$@\'。PS3提示符会被显示并且从标准输入读入一行 + 如果该行由被显示的词对应的数字组成，则 NAME 变量被设定为相应 + 的词。如果行为空，则 WORDS 变量和提示符被重新显示。如果读取了 + 文件结束符，则命令完成。读入任何其他的值会导致 NAME 变量被设定 + 为空。读入的行被存放在变量 REPLY 中。COMMANDS 命令在每次选择 + 之后执行直到执行一个 break 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [until] 当测试不同过时执行命令。 - - `until' COMMANDS 命令的最终命令返回状态不为 0 时， - 展开并执行 COMMANDS 命令。 - - 退出状态： - 返回最后一个执行的命令的状态。 +[time] + 报告管道执行的消耗时间。 + + 执行 PIPELINE 并且打印 PIPELINE 终结时实际时间、用户 CPU 时间和系统 + CPU 时间的总结。 + + 选项： + -p 用可迁移的 POSIX 格式打印用时总结。 + + TIMEFORMAT 变量的值被作为输出格式。 + + 退出状态： + 返回状态即PIPELINE 的返回状态。 - [coproc] 创建一个以 NAME 为名的副进程。 - - 异步执行 COMMANDS 命令，在执行 shell 中的数组变量 NAME - 的 0 号和 1 号元素作为文件描述符，以一个管道连接命令 - 分别作为命令的标准输出和输入设备。 - 默认的 NAME 是 \COPROC\。 - - 退出状态： - 副进程会返回退出状态 0。 +[case] + 基于模式匹配来执行命令。 + + 基于 PATTERN 模式匹配的词 WORD，有选择的执行 COMMANDS 命令。 + |' 用于分隔多个模式。 + + 退出状态： + 返回最后一个执行的命令的状态。 + +[if] + 根据条件执行命令。 + + `if COMMANDS'列表被执行。如果退出状态为零，则执行`then COMMANDS' + 列表。否则按顺序执行每个 `elif COMMANDS'列表，并且如果它的退出状态为 + 零，则执行对应的 `then COMMANDS' 列表并且 if 命令终止。否则如果存在的 + 情况下，执行 `else COMMANDS'列表。整个结构的退出状态是最后一个执行 + 的命令的状态，或者如果没有条件测试为真的话，为零。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [variables] 常用 shell 变量名称和使用。 - - BASH_VERSION 当前 Bash 的版本信息。 - CDPATH 用于 `cd' 命令参数搜索的分号分隔的目录列表 - GLOBIGNORE 路径扩展时忽略的文件名匹配模式列表， - 以分号分隔。 - HISTFILE 您的命令历史存放的文件名称。 - HISTFILESIZE 历史文件最多可以保存的行数。 - HISTSIZE 一个运行的 shell 最多可以访问的历史命令行数。 - HOME 您的登录目录的完整路径。 - HOSTNAME 当前主机的主机名。 - HOSTTYPE 当前版本的 BASH 在其之上运行的 CPU 类型。 - IGNOREEOF 控制 shell 收到文件结束符作为单一输入后的 - 动作。如果设定这个变量，则它的值是 shell 退出之前在 - 一个空行上可以连续看到的文件结束符数量(默认为10)。 - 未设定时，文件结束符标志着输入的结束。 - MACHTYPE 描述当前运行 Bash 的系统的字符串。 - MAILCHECK Bash 检测新邮件的频率，以秒为单位。 - MAILPATH Bash 从中检测新邮件的文件列表，以分号分隔。 - OSTYPE 运行 Bash 的 Unix 版本。 - PATH 当寻找命令时搜索的目录列表，以冒号分隔。 - PROMPT_COMMAND 打印每一个主提示符之前执行的命 - 令。 - PS1 主提示符字符串。 - PS2 从提示符字符串。 - PWD 当前目录的完整路径。 - SHELLOPTS 已启用的 shell 选项列表，以冒号分隔。 - TERM 当前终端类型的名称。 - TIMEFORMAT 以关键则 `time' 显示的时间统计信息的输出 - 格式。 - auto_resume 非空时，一个单独的命令词会首先被在当前 - 停止的任务列表中搜索。如果找到则该任务被置于前台。 - 如果值为 `exact' 则意味着命令词必须精确匹配停止任务 - 列表中的命令。如果值为 `substring' 则意味着命令词必 - 须匹配任务的一个子字符串。任何其他的值意味着命令词 - 必须是停止任务的一个前缀。 - histchars 控制历史展开和快速替换的字符。第一个字符是 - 历史替换字符，通常是 `!'。第二个字符是快速替换字符， - 通常是 `^'。第三个是历史注释字符，通常是 `#'。 - HISTIGNORE 用于决定哪些命令被存入历史文件的模式 - 列表，以冒号分隔。 +[while] + 只要测试成功即执行命令。 + + 只要在 `while' COMMANDS 中的最终命令返回结果为0，则 + 展开并执行 COMMANDS 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 - [pushd] 将目录添加到栈中。 - - 将目录添加到目录栈顶，或着旋转栈直到当前工作目录成为 - 新的栈顶。不带参数时，交换栈顶的两个目录。 - - 选项： - -n 抑制添加目录至栈时通常的改变目录操作，从而仅对栈 - 进行操作。 - - 参数： - +N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中左起，从零开始) - 将移动到栈顶。 - - -N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中右起，从零开始) - 将移动到栈顶。 - - dir 将 DIR 目录添加到栈顶，并且使其成为当前工作目录。 - - `dirs' 内建显示目录栈。 - - 退出状态： - - [popd] 从栈中删除目录。 - - 从目录栈中删除条目。不带参数时，删除栈顶目录，并改变至新的栈 - 顶目录。 - - 选项： - -n 抑制从栈中删除目录时通常的目录变换操作，从而仅对栈 - 进行操作。 - - 参数： - +N 删除第 N 个目录 (`dirs' 显示的目录列表中左起，从零开始)。 - 例如：`popd +0' 删除第一个目录，`popd +1' 删除第二个。 - - -N 删除第 N 个目录 (`dirs' 显示的目录列表中右起，从零开始)。 - 例如：`popd -0' 删除最后一个目录，，`popd -1' 删除倒数第二个。 - - `dirs' 内建显示目录栈。 - - 退出状态： - 返回成功，除非使用了无效的参数或者目录变换失败。 +[until] + 当测试不同过时执行命令。 + + `until' COMMANDS 命令的最终命令返回状态不为 0 时， + 展开并执行 COMMANDS 命令。 + + 退出状态： + 返回最后一个执行的命令的状态。 + +[coproc] + 创建一个以 NAME 为名的副进程。 + + 异步执行 COMMANDS 命令，在执行 shell 中的数组变量 NAME + 的 0 号和 1 号元素作为文件描述符，以一个管道连接命令 + 分别作为命令的标准输出和输入设备。 + 默认的 NAME 是 \COPROC\。 + + 退出状态： + 副进程会返回退出状态 0。 - [dirs] 显示目录栈。 - - 显示当前记住的目录列表。通过 `pushd' 命令可以将目录存入列表 - 中；`popd' 命令可用于遍历弹出列表。 - - 选项： - -c 删除所有元素以清空目录栈 - -l 不打印与主目录相关的波浪号前缀的目录 - -p 每行一个条目打印目录栈 - -v 每行一个条目，以栈中位置为前缀打印目录栈 - - 参数： - +N 显示 dirs 不带选项启动时显示的目录列表左起中第 - N 个目录，从零开始。 - - -N 显示 dirs 不带选项启动时显示的目录列表右起中第 - N 个目录，从零开始。 +[variables] + 常用 shell 变量名称和使用。 + + BASH_VERSION 当前 Bash 的版本信息。 + CDPATH 用于 `cd' 命令参数搜索的分号分隔的目录列表 + GLOBIGNORE 路径扩展时忽略的文件名匹配模式列表， + 以分号分隔。 + HISTFILE 您的命令历史存放的文件名称。 + HISTFILESIZE 历史文件最多可以保存的行数。 + HISTSIZE 一个运行的 shell 最多可以访问的历史命令行数。 + HOME 您的登录目录的完整路径。 + HOSTNAME 当前主机的主机名。 + HOSTTYPE 当前版本的 BASH 在其之上运行的 CPU 类型。 + IGNOREEOF 控制 shell 收到文件结束符作为单一输入后的 + 动作。如果设定这个变量，则它的值是 shell 退出之前在 + 一个空行上可以连续看到的文件结束符数量(默认为10)。 + 未设定时，文件结束符标志着输入的结束。 + MACHTYPE 描述当前运行 Bash 的系统的字符串。 + MAILCHECK Bash 检测新邮件的频率，以秒为单位。 + MAILPATH Bash 从中检测新邮件的文件列表，以分号分隔。 + OSTYPE 运行 Bash 的 Unix 版本。 + PATH 当寻找命令时搜索的目录列表，以冒号分隔。 + PROMPT_COMMAND 打印每一个主提示符之前执行的命 + 令。 + PS1 主提示符字符串。 + PS2 从提示符字符串。 + PWD 当前目录的完整路径。 + SHELLOPTS 已启用的 shell 选项列表，以冒号分隔。 + TERM 当前终端类型的名称。 + TIMEFORMAT 以关键则 `time' 显示的时间统计信息的输出 + 格式。 + auto_resume 非空时，一个单独的命令词会首先被在当前 + 停止的任务列表中搜索。如果找到则该任务被置于前台。 + 如果值为 `exact' 则意味着命令词必须精确匹配停止任务 + 列表中的命令。如果值为 `substring' 则意味着命令词必 + 须匹配任务的一个子字符串。任何其他的值意味着命令词 + 必须是停止任务的一个前缀。 + histchars 控制历史展开和快速替换的字符。第一个字符是 + 历史替换字符，通常是 `!'。第二个字符是快速替换字符， + 通常是 `^'。第三个是历史注释字符，通常是 `#'。 + HISTIGNORE 用于决定哪些命令被存入历史文件的模式 + 列表，以冒号分隔。 + +[pushd] + 将目录添加到栈中。 + + 将目录添加到目录栈顶，或着旋转栈直到当前工作目录成为 + 新的栈顶。不带参数时，交换栈顶的两个目录。 + + 选项： + -n 抑制添加目录至栈时通常的改变目录操作，从而仅对栈 + 进行操作。 + + 参数： + +N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中左起，从零开始) + 将移动到栈顶。 + + -N 旋转栈从而第 N 个目录 (`dirs' 显示的列表中右起，从零开始) + 将移动到栈顶。 + + dir 将 DIR 目录添加到栈顶，并且使其成为当前工作目录。 + + `dirs' 内建显示目录栈。 + + 退出状态： - 退出状态： - 返回成功，除非使用了无效的选项或者发生错误。 +[popd] + 从栈中删除目录。 + + 从目录栈中删除条目。不带参数时，删除栈顶目录，并改变至新的栈 + 顶目录。 + + 选项： + -n 抑制从栈中删除目录时通常的目录变换操作，从而仅对栈 + 进行操作。 + + 参数： + +N 删除第 N 个目录 (`dirs' 显示的目录列表中左起，从零开始)。 + 例如：`popd +0' 删除第一个目录，`popd +1' 删除第二个。 + + -N 删除第 N 个目录 (`dirs' 显示的目录列表中右起，从零开始)。 + 例如：`popd -0' 删除最后一个目录，，`popd -1' 删除倒数第二个。 + + `dirs' 内建显示目录栈。 + + 退出状态： + 返回成功，除非使用了无效的参数或者目录变换失败。 - [printf] 在 FORMAT 的控制下格式化并打印 ARGUMENTS 参数。 - - 选项： - -v var 将输出赋值给 shell 变量 VAR 而不显示在标准输出上 - - FORMAT 是包含三种对象的字符串：简单地被拷贝到标准输出的普通字符； - 被变换之后拷贝到标准输入的转义字符；以及每个都会影响到下个参数的打印的格 - 式化声明。 - - 在 printf(1) 中描述的标准控制声明之外，printf 解析： - - %b 扩展对应参数中的反斜杠转义序列 - %q 以可作为 shell 输入的格式引用参数 - %(fmt)T 以 FMT 为供给 strftime(3) 的格式输出日期时间字符串 - - 退出状态： - 返回成功，除非使用了无效的选项或者写或赋值错误发生。 +[dirs] + 显示目录栈。 + + 显示当前记住的目录列表。通过 `pushd' 命令可以将目录存入列表 + 中；`popd' 命令可用于遍历弹出列表。 + + 选项： + -c 删除所有元素以清空目录栈 + -l 不打印与主目录相关的波浪号前缀的目录 + -p 每行一个条目打印目录栈 + -v 每行一个条目，以栈中位置为前缀打印目录栈 + + 参数： + +N 显示 dirs 不带选项启动时显示的目录列表左起中第 + N 个目录，从零开始。 + + -N 显示 dirs 不带选项启动时显示的目录列表右起中第 + N 个目录，从零开始。 + + 退出状态： + 返回成功，除非使用了无效的选项或者发生错误。 + +[printf] + 在 FORMAT 的控制下格式化并打印 ARGUMENTS 参数。 + + 选项： + -v var 将输出赋值给 shell 变量 VAR 而不显示在标准输出上 + + FORMAT 是包含三种对象的字符串：简单地被拷贝到标准输出的普通字符； + 被变换之后拷贝到标准输入的转义字符；以及每个都会影响到下个参数的打印的格 + 式化声明。 + + 在 printf(1) 中描述的标准控制声明之外，printf 解析： + + %b 扩展对应参数中的反斜杠转义序列 + %q 以可作为 shell 输入的格式引用参数 + %(fmt)T 以 FMT 为供给 strftime(3) 的格式输出日期时间字符串 + + 退出状态： + 返回成功，除非使用了无效的选项或者写或赋值错误发生。 - [complete] 指定 Readline 如何补全参数。 - - 声明对于每一个 NAME 名称如何补全参数。如果不带选项， - 现有的补全声明会以可以重用为输入的格式打印出来。 - - 选项： - -p 以可重用的格式打印现有的补全声明。 - -r 对于每个 NAME 名称删除补全声明，或者如果没有提供 NAME - 名称，删除所有的补全声明。 - -D 对于没有补全声明定义的命令，设定默认的补全动作 - -E 对于 \empty\ 命令设定补全动作，—— 对于空行的补全。 - -I 将补全和动作应用在首单词（通常是所给命令）上 - - 尝试补全时，按照上述大写字母选项的顺序进行动作。 - 如果给出了多个选项，-D 选项优先级高于 -E 选项，且 - 这两个选项优先级均高于 -I。 - - 退出状态： - 返回成功，除非使用了无效的选项或者错误发生。 +[complete] + 指定 Readline 如何补全参数。 + + 声明对于每一个 NAME 名称如何补全参数。如果不带选项， + 现有的补全声明会以可以重用为输入的格式打印出来。 + + 选项： + -p 以可重用的格式打印现有的补全声明。 + -r 对于每个 NAME 名称删除补全声明，或者如果没有提供 NAME + 名称，删除所有的补全声明。 + -D 对于没有补全声明定义的命令，设定默认的补全动作 + -E 对于 \empty\ 命令设定补全动作，—— 对于空行的补全。 + -I 将补全和动作应用在首单词（通常是所给命令）上 + + 尝试补全时，按照上述大写字母选项的顺序进行动作。 + 如果给出了多个选项，-D 选项优先级高于 -E 选项，且 + 这两个选项优先级均高于 -I。 + + 退出状态： + 返回成功，除非使用了无效的选项或者错误发生。 - [compgen] 依据选项显示可能的补全。 - - 意图在能产生可能的补全的 shell 函数内部使用。 - 如果提供了可选的 WORD 参数，则产生按照 WORD - 进行的匹配。 - - 退出状态： - 除非使用了无效选项或者错误发生，否则返回成功。 +[compgen] + 依据选项显示可能的补全。 + + 意图在能产生可能的补全的 shell 函数内部使用。 + 如果提供了可选的 WORD 参数，则产生按照 WORD + 进行的匹配。 + + 退出状态： + 除非使用了无效选项或者错误发生，否则返回成功。 - [compopt] 修改或显示补全选项。 - - 修改每个 NAME 名称的补全选项，或如果没有提供 NAME 名称，执行当前的补 - 全。 - 如果不带选项，打印每个 NAME 名称的补全选项或当前的补全声明。 - - 选项： - -o option 为每个 NAME 名称设定补全选项 option - -D 为 \default\ 命令补全改变选项 - -E 为 \empty\ 命令补全改变选项 - -I 为首单词的补全改变选项 - - 使用 `+o' 而不是 `-o' 可以关闭指定的选项。 - - 参数： - - 每个 NAME 名称都对应一个之前以通过 `complete' 内建定义了的补全声明的 - 命令。如果不提供 NAME 名称，当前生成补全的函数必须调用 compopt， - 并且当前执行的补全生成器选项会被修改。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称没有定义补全声明。 +[compopt] + 修改或显示补全选项。 + + 修改每个 NAME 名称的补全选项，或如果没有提供 NAME 名称，执行当前的补 + 全。 + 如果不带选项，打印每个 NAME 名称的补全选项或当前的补全声明。 + + 选项： + -o option 为每个 NAME 名称设定补全选项 option + -D 为 \default\ 命令补全改变选项 + -E 为 \empty\ 命令补全改变选项 + -I 为首单词的补全改变选项 + + 使用 `+o' 而不是 `-o' 可以关闭指定的选项。 + + 参数： + + 每个 NAME 名称都对应一个之前以通过 `complete' 内建定义了的补全声明的 + 命令。如果不提供 NAME 名称，当前生成补全的函数必须调用 compopt， + 并且当前执行的补全生成器选项会被修改。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称没有定义补全声明。 - [mapfile] +[mapfile] 从标准输入读取行到下标数组变量中。 - - 从标准输入读取行到下标数组变量 ARRAY 中，或者如果使用了 -u 选项， - 从文件描述符 FD 中读取。MAPFILE 变量是默认的 ARRAY 变量。 - - 选项： - -d delim 使用 DELIM 而非换行符断行 - -n count 最多拷贝 COUNT 行，如果 COUNT 为 0，则拷贝所有行。 - -O origin 从下标 ORIGIN 开始 赋值给 ARRAY 变量。默认下标是0. - -s count 丢弃最先读取的 COUNT 行。 - -t 从读取的每行末尾删除一个换行符。 - -u fd 从文件描述符 FD 中读取行而不是标准输入。 - -C callback 每 QUANTUM 次读行之后对 CALLBACK 回调进行估值。 - -c quantum 定义每次调用 CALLBACK 回调之间读取的行数。 - - 参数： - ARRAY 存储数据使用的数组变量 - - 如果使用了 -C 而没有 -c，默认的量子是5000。当对 CALLBACK 估值时， - 下一个将被赋值的数组元素的下标作为额外参数被传递。 - - 如果没有显式指定起始下标，mapfile 将在赋值前清空 ARRAY 变量。 - - 退出状态： - 返回成功，除非使用了无效的选项，或者 ARRAY 变量只读或不是下标数组。 + + 从标准输入读取行到下标数组变量 ARRAY 中，或者如果使用了 -u 选项， + 从文件描述符 FD 中读取。MAPFILE 变量是默认的 ARRAY 变量。 + + 选项： + -d delim 使用 DELIM 而非换行符断行 + -n count 最多拷贝 COUNT 行，如果 COUNT 为 0，则拷贝所有行。 + -O origin 从下标 ORIGIN 开始 赋值给 ARRAY 变量。默认下标是0. + -s count 丢弃最先读取的 COUNT 行。 + -t 从读取的每行末尾删除一个换行符。 + -u fd 从文件描述符 FD 中读取行而不是标准输入。 + -C callback 每 QUANTUM 次读行之后对 CALLBACK 回调进行估值。 + -c quantum 定义每次调用 CALLBACK 回调之间读取的行数。 + + 参数： + ARRAY 存储数据使用的数组变量 + + 如果使用了 -C 而没有 -c，默认的量子是5000。当对 CALLBACK 估值时， + 下一个将被赋值的数组元素的下标作为额外参数被传递。 + + 如果没有显式指定起始下标，mapfile 将在赋值前清空 ARRAY 变量。 + + 退出状态： + 返回成功，除非使用了无效的选项，或者 ARRAY 变量只读或不是下标数组。 - [readarray] 从一个文件中读取行到数组变量中。 +[readarray] + 从一个文件中读取行到数组变量中。 一个 `mapfile'的同义词。 - [unset] 取消设定 shell 变量和函数的值和属性。 - 对每一个 NAME 名称，删除对应的变量或函数。 - - 选项： - -f 将每个 NAME 视为函数 - -v 将每个 NAME 视为变量 - -n 将每个 NAME 视为名称引用，只取消其本身而非其指向的变量 - - 不带选项时，unset 首先尝试取消设定一个变量，如果失败，再尝试取消设定一个 - 函数。 - - 某些变量不可以被取消设定；参见 `readonly'。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - - [local] 记住或显示程序位置。 - - 确定并记住每一个给定 NAME 名称的命令的完整路径。 - 如果不提供参数，则显示已经记住的命令的信息。 - - 选项： - -d 忘记每一个已经记住的 NAME 的位置 - -l 以可作为输入重用的格式显示 - -p pathname 使用 pathname 路径作为 NAME 命令的全路径 - -r 忘记所有记住的位置 - -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 - NAME 名称，则每个位置前面会加上相应的 NAME 名称 - - 参数： - NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 - 令 - 列表中。 +[unset] + 取消设定 shell 变量和函数的值和属性。 + 对每一个 NAME 名称，删除对应的变量或函数。 + + 选项： + -f 将每个 NAME 视为函数 + -v 将每个 NAME 视为变量 + -n 将每个 NAME 视为名称引用，只取消其本身而非其指向的变量 + + 不带选项时，unset 首先尝试取消设定一个变量，如果失败，再尝试取消设定一个 + 函数。 + + 某些变量不可以被取消设定；参见 `readonly'。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - 退出状态： - 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 - 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 +[local] + 记住或显示程序位置。 + + 确定并记住每一个给定 NAME 名称的命令的完整路径。 + 如果不提供参数，则显示已经记住的命令的信息。 + + 选项： + -d 忘记每一个已经记住的 NAME 的位置 + -l 以可作为输入重用的格式显示 + -p pathname 使用 pathname 路径作为 NAME 命令的全路径 + -r 忘记所有记住的位置 + -t 打印记住的每一个 NAME 名称的位置，如果指定了多个 + NAME 名称，则每个位置前面会加上相应的 NAME 名称 + + 参数： + NAME 每个 NAME 名称会在 $PATH 路径变量中被搜索，并且添加到记住的命 + 令 + 列表中。 + + 退出状态： + 返回成功，除非 NAME 命令没有找到或者使用了无效的选项。 + 返回成功，除非使用了无效的选项或者 NAME 名称为只读。 - [export] 为 shell 变量设定导出属性。 +[export] + 为 shell 变量设定导出属性。 - 标记每个 NAME 名称为自动导出到后续命令执行的环境。如果提供了 VALUE - 则导出前将 VALUE 作为赋值。 - - 选项： - -f 指 shell 函数 - -n 删除每个 NAME 名称的导出属性 - -p 显示所有导出的变量和函数的列表 - - `--' 的参数禁用进一步的选项处理。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称。 + 标记每个 NAME 名称为自动导出到后续命令执行的环境。如果提供了 VALUE + 则导出前将 VALUE 作为赋值。 + + 选项： + -f 指 shell 函数 + -n 删除每个 NAME 名称的导出属性 + -p 显示所有导出的变量和函数的列表 + + `--' 的参数禁用进一步的选项处理。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称。 - [readonly] 标记 shell 变量为不可改变。 +[readonly] + 标记 shell 变量为不可改变。 - 标记每一个 NAME 名称为只读；这些 NAME 变量的值将不可以被后续的赋值 - 操作所改变。如果提供了 VALUE，则在标记为只读之前将 VALUE 值赋给变量。 - - 选项： - -a 指下标数组变量 - -A 指关联数组标量 - -f 指 shell 函数 - -p 显示只读变量或函数列表，取决于是否提供了 -f 选项 - - `--' 的参数禁用进一步的选项处理。 - - 退出状态： - 返回成功，除非使用了无效的选项或者 NAME 名称。 + 标记每一个 NAME 名称为只读；这些 NAME 变量的值将不可以被后续的赋值 + 操作所改变。如果提供了 VALUE，则在标记为只读之前将 VALUE 值赋给变量。 + + 选项： + -a 指下标数组变量 + -A 指关联数组标量 + -f 指 shell 函数 + -p 显示只读变量或函数列表，取决于是否提供了 -f 选项 + + `--' 的参数禁用进一步的选项处理。 + + 退出状态： + 返回成功，除非使用了无效的选项或者 NAME 名称。 - [declare] 设定变量值和属性。 - - 声明变量并且赋予它们属性。如果没有给定名称， - 则显示所有变量的属性和值。 - - 选项： - -f 限制动作或显示为仅函数名称和定义 - -F 限制仅显示函数名称 (以及调试时显示行号和源文件名) - -g 当用于 shell 函数内时创建全局变量; 否则忽略 - -p 显示每个 NAME 变量的属性和值 - - 设定属性的选项： - -a 使 NAME 成为下标数组 (如果支持) - -A 使 NAME 成为关联数组 (如果支持) - -i 使 NAME 带有 `integer' (整数)属性 - -l 将 NAME 在赋值时转为小写 - -n 使 NAME 成为指向一个以其值为名称的变量的引用 - -r 将 NAME 变为只读 - -t 使 NAME 带有 `trace' (追踪)属性 - -u 将每个 NAME 在赋值时转为大写 - -x 将 NAME 导出 - - 用 `+' 代替 `-' 会关闭指定选项。 - - 带有整数属性的变量在赋值时将使用算术估值(见 - `let' 命令) +[declare] + 设定变量值和属性。 - 在函数中使用时，`declare' 使 NAME 成为本地变量，和 `local' - 命令一致。`-g' 选项抑制此行为。 - - 退出状态： - 返回成功，除非提供了无效选项或者发生变量赋值错误 + 声明变量并且赋予它们属性。如果没有给定名称， + 则显示所有变量的属性和值。 + + 选项： + -f 限制动作或显示为仅函数名称和定义 + -F 限制仅显示函数名称 (以及调试时显示行号和源文件名) + -g 当用于 shell 函数内时创建全局变量; 否则忽略 + -p 显示每个 NAME 变量的属性和值 + + 设定属性的选项： + -a 使 NAME 成为下标数组 (如果支持) + -A 使 NAME 成为关联数组 (如果支持) + -i 使 NAME 带有 `integer' (整数)属性 + -l 将 NAME 在赋值时转为小写 + -n 使 NAME 成为指向一个以其值为名称的变量的引用 + -r 将 NAME 变为只读 + -t 使 NAME 带有 `trace' (追踪)属性 + -u 将每个 NAME 在赋值时转为大写 + -x 将 NAME 导出 + + 用 `+' 代替 `-' 会关闭指定选项。 + + 带有整数属性的变量在赋值时将使用算术估值(见 + `let' 命令) + + 在函数中使用时，`declare' 使 NAME 成为本地变量，和 `local' + 命令一致。`-g' 选项抑制此行为。 + + 退出状态： + 返回成功，除非提供了无效选项或者发生变量赋值错误 - [function] 定义 shell 函数。 - - 创建一个以 NAME 为名的 shell 函数。当作为一个简单的命令启用时， - NAME 函数执行调用 shell 的上下文中的 COMMANDs 命令。当 NAME - 被启用时，参数作为 $1...$n 被传递给函数，函数的名字储存在变量 - $FUNCNAME 中。 +[function] + 定义 shell 函数。 - 退出状态： - 返回成功除非 NAME 为只读。 + 创建一个以 NAME 为名的 shell 函数。当作为一个简单的命令启用时， + NAME 函数执行调用 shell 的上下文中的 COMMANDs 命令。当 NAME + 被启用时，参数作为 $1...$n 被传递给函数，函数的名字储存在变量 + $FUNCNAME 中。 + + 退出状态： + 返回成功除非 NAME 为只读。 - [typeset] 设置变量的值和属性。 +[typeset] + 设置变量的值和属性。 - `declare' 的等价形式。参见 `help declare'。 + `declare' 的等价形式。参见 `help declare'。 - - [source] 在当前 shell 中执行一个文件中的命令。 - - 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 - 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS - 参数，则它们将成为 FILENAME 文件执行时的位置参数。 +[source] + 在当前 shell 中执行一个文件中的命令。 - 退出状态： - 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 + 在当前 shell 中读取并执行 FILENAME 文件中的命令。$PATH 变量中的 + 条目被用于寻找包含 FILENAME 文件的目录。如果提供了任何的 ARGUMENTS + 参数，则它们将成为 FILENAME 文件执行时的位置参数。 + + 退出状态： + 返回 FILENAME 文件中最后一个命令的状态；如果 FILENAME 文件不可读则失败。 - [bind] 设定 Readline 键绑定和变量。 - - 绑定一个键序列到一个 Readline 函数或者宏，或者设定一个 - Readline 变量。非选项参数的语法和 ~/.inputrc 文件中的等 - 同，但是必须作为一个参数被传递， - 例如，bind '\\\C-x\\C-r\: re-read-init-file'. - - 选项： - -m 键映射 在此命令执行过程中使用指定的键映射。 - 可被接受的键映射名字有 emacs、emacs-standard、emacs- - meta、 - emacs-ctlx、vi、vi-move、vi-command、和 vi-insert。 - -l 列出函数名称。 - -P 列出函数名称和绑定。 - -p 以可以重新用作输入的格式列出函数名称和绑定。 - -S 列出可以启动宏的键序列以及它们的值 - -s 以可以重新用作输入的格式列出可以启动宏的键以及它们的 - 值。 - -V 列出变量名成和它们的值 - -v 以可以重新用作输入的格式列出变量的名称和它们的值 - -q 函数名 查询指定的函数可以由哪些键启动。 - -u 函数名 反绑定所有绑定至指定函数的键。 - -r 键序列 取消指定键序列的绑定。 - -f 文件名 从指定文件中读取键绑定。 - -x 键序列:shell命令\t当指定的键序列被输入时，执行指定的 shell 命令。 - -X 以可被重用的形式列出用 -x 绑定的键序列和命令。 +[bind] + 设定 Readline 键绑定和变量。 - 退出状态： - 除非使用了无法辨认的选项或者错误发生，否则返回0. + 绑定一个键序列到一个 Readline 函数或者宏，或者设定一个 + Readline 变量。非选项参数的语法和 ~/.inputrc 文件中的等 + 同，但是必须作为一个参数被传递， + 例如，bind '\\\C-x\\C-r\: re-read-init-file'. + + 选项： + -m 键映射 在此命令执行过程中使用指定的键映射。 + 可被接受的键映射名字有 emacs、emacs-standard、emacs- + meta、 + emacs-ctlx、vi、vi-move、vi-command、和 vi-insert。 + -l 列出函数名称。 + -P 列出函数名称和绑定。 + -p 以可以重新用作输入的格式列出函数名称和绑定。 + -S 列出可以启动宏的键序列以及它们的值 + -s 以可以重新用作输入的格式列出可以启动宏的键以及它们的 + 值。 + -V 列出变量名成和它们的值 + -v 以可以重新用作输入的格式列出变量的名称和它们的值 + -q 函数名 查询指定的函数可以由哪些键启动。 + -u 函数名 反绑定所有绑定至指定函数的键。 + -r 键序列 取消指定键序列的绑定。 + -f 文件名 从指定文件中读取键绑定。 + -x 键序列:shell命令\t当指定的键序列被输入时，执行指定的 shell 命令。 + -X 以可被重用的形式列出用 -x 绑定的键序列和命令。 + + 退出状态： + 除非使用了无法辨认的选项或者错误发生，否则返回0. - [test] 估值算术表达式。 - - 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 - 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 - 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 - 优先级从高至低。 - - - \tid++, id--\t变量后置加，后置减 - \t++id, --id\t变量前置加，前置减 - \t-, +\t\t一元减法，一元加法 - \t!, ~\t\t逻辑和位取反 - \t**\t\t指数 - \t*, /, %\t\t乘法，除法，取余数 - \t+, -\t\t增加，减少 - \t<<, >>\t\t向左和向右按位移位 - \t<=, >=, <, >\t比较 - \t==, !=\t\t等于，不等于 - \t&\t\t按位与 - \t^\t\t按位异或 - \t|\t\t按位或 - \t&&\t\t逻辑与 - \t||\t\t逻辑或 - \texpr ? expr : expr - \t\t\t条件操作符 - \t=, *=, /=, %=, - \t+=, -=, <<=, >>=, - \t&=, ^=, |=\t赋值 - - Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 - (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 +[test] + 估值算术表达式。 - 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 - 规则。 - - 退出状态： - 如果最后一个 ARG 参数估值为 0，则 let 返回 1； 否则 let 返回 0。 + 将每个 ARG 参赛作为算术表达式来估值。估值的计算以定宽的整 + 数完成，不带溢出检测，不过除 0 是被置陷阱的并且会报一个错 + 误。下列操作符被按照相同的算术优先级组合。列表的顺序按照 + 优先级从高至低。 + + + \tid++, id--\t变量后置加，后置减 + \t++id, --id\t变量前置加，前置减 + \t-, +\t\t一元减法，一元加法 + \t!, ~\t\t逻辑和位取反 + \t**\t\t指数 + \t*, /, %\t\t乘法，除法，取余数 + \t+, -\t\t增加，减少 + \t<<, >>\t\t向左和向右按位移位 + \t<=, >=, <, >\t比较 + \t==, !=\t\t等于，不等于 + \t&\t\t按位与 + \t^\t\t按位异或 + \t|\t\t按位或 + \t&&\t\t逻辑与 + \t||\t\t逻辑或 + \texpr ? expr : expr + \t\t\t条件操作符 + \t=, *=, /=, %=, + \t+=, -=, <<=, >>=, + \t&=, ^=, |=\t赋值 + + Shell 变量允许作为操作数。表达式中的变量的名称会被取代以值 + (强制转换为定宽的整数)。表达式中的变量不需要打开整数属性。 + + 操作符按照优先级进行估值。括号中的子表达式将被先估值，并可取代上述表达式 + 规则。 + + 退出状态： + 如果最后一个 ARG 参数估值为 0，则 let 返回 1； 否则 let 返回 0。 *[other] 显示其他命令帮助信息 . } @@ -1540,4 +1611,6 @@ $cmdName -> information = 这些 shell 命令是内部定义的。请输入 `help' 以获取一个列表。 输入 `help 名称' 以得到有关函数`名称'的更多信息。 使用 `info bash' 来获得关于 shell 的更多一般性信息。 - 使用 `man -k' 或 `info' 来获取不在列表中的命令的更多信息。 \ No newline at end of file + 使用 `man -k' 或 `info' 来获取不在列表中的命令的更多信息。 + +helperr = 没有与{$name}匹配的帮助主题。尝试使用"help help"、"man -k {$name} 或 "info {$name}"。 \ No newline at end of file diff --git a/record.txt b/record.txt index aa851144..db833e5a 100644 --- a/record.txt +++ b/record.txt @@ -68,3 +68,4 @@ 90 91 92 +93 -- Gitee