JP1/Advanced Shell
形式
umask [-S][mask]
機能
新規ファイル作成時のアクセス権を設定します。maskには設定するファイルモード作成マスクを指定します。maskを指定しないで実行した場合,現在のumask値を標準出力に出力します。
引数
- -S
- シンボリック形式で値を設定または出力します。
- -Sオプションを指定した場合,シンボリック形式でファイルモードの設定および出力をします。-Sオプションを指定しなかった場合,8進数で表したアクセス権の設定および出力をします。指定したアクセス権はファイル作成時に許可しないことを示します。
- mask
- ファイル作成時のファイルモードのデフォルト値に対するumask値を指定します。maskには数値またはシンボリック形式を指定できます。シンボリック形式で指定する場合,[who][op][perm][, ...]の書式に従って指定します。コンマで区切ると複数指定できます。スペースは使用できません。
- who
maskを設定する対象です。次の文字を0個以上指定します。
u:ユーザー(所有者)用のパーミッションを修正します。
g:グループ用のパーミッションを修正します。
o:そのほかのパーミッションを修正します。
a:全対象のパーミッションを修正します(a=ugo)。
指定なし:全対象のパーミッションを修正します(a=ugo)。
- op
maskの設定方法です。次の記号を1つ指定します。
+:permをwhoの既存のマスクに追加します。
-:permをwhoの既存のマスクから削除します。
=:whoの既存のマスクをpermで置換します。
- perm
ファイル作成時に許可する権限を指定します。次の文字を0個以上指定します。
r:read権限です。
w:write権限です。
x:実行権限です。
u:ユーザー用と同じ権限です。
g:グループ用と同じ権限です。
o:そのほかと同じ権限です。
X:ugoのどれかに実行権限がある場合は,その実行権限になります。ugoのどれにも実行権限がない場合は,権限指定がありません。権限指定がない場合,opが+または-のときは変更しません。opが=のときは,whoのマスクが解除されます。
s:権限指定がありません。opが+または-の場合は,変更しません。opが=の場合は,whoのマスクが解除されます。
指定なし:権限指定がありません。opが+または-の場合は,変更しません。opが=の場合は,whoのマスクが解除されます。
戻り値
戻り値 意味 0 正常終了 1 エラー終了
注意事項
- この正規組み込みコマンドは,コマンドの構文を誤ってもコマンドを実行しているシェルは終了しません。
- Windowsの場合にこのコマンドを実行すると,サポートしていないことをメッセージに出力し,戻り値0を返して正常終了します。ファイルモード作成マスクは設定しません。
使用例
- ファイル作成時にユーザーのwrite権限だけを設定します。
umask u=w
All Rights Reserved. Copyright (C) 2011, 2012, Hitachi, Ltd.