LS (1)

NAME
       ls - 디렉토리 내용을 나열한다.

SYNOPSIS
       ls [OPTION]... [FILE]...

DESCRIPTION
       기본적으로 현재 디렉토리의 파일에 대한 정보를 목록으로 나열한다.
       옵션 -cftuvSUX  또는 --sort가 지정되지 않는다면 알파벳순으로 정렬한다.

       긴 옵션에 대한 필수 인수는 짧은 옵션에 대해서도 같다.

       -a, --all
              숨김파일(.파일)을 무시하지 않고 목록에 포함한다.

       -A, --almost-all
              .[자신] ..[부모]을 제외하고 목록에 포함한다.

       --author
              '-l' 옵션을 같이 사용해야 한다. 각 파일의 작성자를 함께 출력한다. 
              * group, user와 함께 author를 표출한다. 'chown'으로 사용자와 그룹을 바꿔도 작성자가 바뀐다.

       -b, --escape
              비출력문자(공백, 탭 등)이 파일명에 존재하는 경우 그 문자를 이스케이핑(C-style escapes)하여 출력한다.
              * 파일명이 보여지는대로 입력하는데도 찾을 수 없다는 경우가 해당되는 듯하다.

       --block-size=SIZE
              -l옵션과 함께 사용하여 파일이나 디렉토리에 주어진 사이즈의 크기 단위를 지정하여 출력한다.
              SIZE 포맷은 아래를 참고한다.

       -B, --ignore-backups
              백업파일(~로 끝나는 파일명)을 제외하고 목록에 포함한다.
              * 이맥스의 경우 파일을 편집하면 백업파일이 편집파일~로 생성된다.

       -c    '-lt' 옵션을 같이 사용하는 경우, 수정일자(ctime) 순으로 정렬하여 ctime과 함께 출력한다.
              '-l' 옵션을 같이 사용하는 경우, 파일명 순으로 정렬하여 ctime과 함께  출력한다.
              그외 경우에는, ctime으로 정렬하여 최신순으로 정렬하여 출력한다.
              [--time=WORD 참고]

       -C   컬럼을 기준으로 화면을 구성한다. [--format=WORD 참고]
              * 한 컬럼을 채우고 다음 컬럼을 채우는 식으로 목록을 출력한다. ls의 기본 설정이다.

       --color[=WHEN]
              목록 출력시 컬러를 표시한다. WHEN 정보는 아래를 참고한다.

       -d, --directory
              디렉토리 목록만 출력한다. 
              * ls -d */ 이런 식으로 사용해야 한다. 그렇지 않으면 자신만 보인다.

       -D, --dired
              이맥스 파일매니저인 Dired모드로 결과물을 만들어낸다.
              * 이맥스를 사용하지 않는 사용자라면 무시해도 된다.

       -f     디렉토리 순서에 따라 항목을 출력한다. 디렉토리 순서란 파일시스템에 저장된 순서를 의미한다.

       -F, --classify[=WHEN]
              목록에 식별자(*/=>@|)를 추가하여 목록을 출력한다. [--indicator-style=WORD 참고]

              식별자별 특징은 아래처럼 설명하지만 심볼릭링
              @ : 심볼릭 링크, verbose모드가 아닌 컬럼옵션으로 보는 경우 출력된다.
               * : 실행 파일
               = : 소켓 파일
               | : 파이프 파일, 본 적이 없어 설명 불가
               > : 도어파일, 본 적이 없어서 설명 불가
               / : 디렉토리

       --file-type
              '*'를 추가하지 않는다는 것을 제외하고 -F 옵션과 같다.  [--indicator-style=WORD 참고]

       --format=WORD
              출력형식을 문자열(WORD)로 지정한다.
              across  -x, 
              commas -m, 
              horizontal -x, 
              long -l, 
              single-column -1,
              verbose -l, 
              vertical -C

              ls --format=horizontal 은 ls -x 와 같다.
              ls --format=vertical 은 ls -C 와 같다.

       --full-time
              '-l'과 같이 라인당 하나의 파일을 출력하면서 시간정보를 자세히 출력한다. 
              -l --time-style=full-iso 과 같다.

       -g    '-l'과 같이 라인당 하나의 파일을 출력하면서 소유자를 출력하지 않는다.
              즉, 기본적으로 보여지는 소유자,그룹명중 그룹명만 출력한다는 것이다.

       --group-directories-first
              목록 중 파일목록이 보이기 이전에 디렉토리목록을 먼저 보이도록 정렬한다.
              --sort=none(-U) 옵션을 제외한 다른 옵션에 모두 적용된다.

       -G, --no-group
              '-l' 옵션과 사용한다. 목록 중 그룹명은 출력하지 않는다.
              즉, 기본적으로 보여지는 소유자,그룹명중 소유자만 출력한다는 것이다.

       -h, --human-readable
              '-l'옵션을 같이 사용해야 한다. 파일 사이즈를 읽기 용이하도록 출력한다.(예, 1K 234M 2G)

       --si  '-h' 옵션과 비슷하다. 단지 단위를 1024가 아닌 1000으로 환산하여 적용한다.

       -H, --dereference-command-line
              심볼릭링크 목록 조회시 심볼릭링크 자체를 목록으로 보지 않고 그 링크 내부의 목록을 출력한다.

              목록 중 etclink라는 엔트리가 있고 이 엔트리가 /etc 디렉토리에 대한 심볼릭 링크일 경우,
              ls -l etclink 를 수행하면 etclink 엔트리만 출력되고,
              ls -lH etclink 를 수행하면 /etc내의 엔트리 목록이 출력된다.

       --dereference-command-line-symlink-to-dir
              디렉토리를 가리키는 심볼릭링크를 추종한다.
              * '-H' 옵션과의 차이를 알 수 없다.

       --hide=PATTERN
              패턴과 부합하는 엔트리는 목록에서 제외된 후 출력한다.
              이 옵션을 사용할 때 -a, -A 옵션을 사용하면 무시된다.  [--ignore=PATTERN 참고]

              ls -l --hide='D*'
              D로 시작하는 모든 엔트리는 목록에서 제외된다.

       --hyperlink[=WHEN]
              hyperlink file names WHEN

       --indicator-style=WORD
              식별자 타입을 문자열(WORD)로 지정한다. 문자열별 다른 옵션이 존재한다.
              none : 기본값
              slash : -p와 같다
              file-type : --file-type과 같다
              classify : -F와 같다

              ls -l --indicator-style=slash 디렉토리의 경우 '/'가 포함된다.

       -i, --inode
              목록에 inode컬럼을 추가하여 출력한다.

      -I, --ignore=PATTERN
              패턴과 부합하는 엔트리는 목록에서 제외된 후 출력한다.
              hide의 경우 -a, -A 옵션을 사용하면 무시되지만, 이 옵션의 경우에는 무시되지 않고 그대로 적용된다.

              ls -al --ignore='D*'
              D로 시작하는 모든 엔트리는 목록에서 제외되면서 다른 모든 목록(숨김파일 포함)이 출력된다.

       -k, --kibibytes
              --block-size=1K과 같다.

       -l    1행당 한 개의 엔트리를 출력하고 보다 자세한 목록으로 출력한다. [--format=WORD 참고]

       -L, --dereference
              링크 자체가 아닌 링크를 통해 연결된 파일의 정보를 출력한다.
              '-H' 옵션과는 다르다.

       -m    목록을 출력할 때, 엔트리 구분자를 커마(,)로 사용한다. [--format=WORD 참고]

       -n, --numeric-uid-gid
              '-l' 옵션과 같고 다만, 사용자, 그룹을 그들의 ID(숫자)로 표시한다.

       -N, --literal
              엔트리명에서 따옴표를 제거하여 출력한다.

       -o    '-l'과 같이 라인당 하나의 파일을 출력하면서 그룹명을 출력하지 않는다.
              즉, 기본적으로 보여지는 소유자,그룹명중 소유자만 출력한다.

       -p, --indicator-style=slash
              디렉토리에 '/'를 추가한다.  [--indicator-style=WORD 참고]

       -q, --hide-control-chars
              제어문자를 해당 문자대신 물음표로 표시한다.

       --show-control-chars
              제어문자를 표시한다. 파일명에 제어문자가 포함된 경우 그를 그대로 표시한다.

       -Q, --quote-name
              파일명을 큰 따옴표로 감싼다.

       --quoting-style=WORD
              쿼팅 타입을 문자열(WORD)로 지정한다.
              ls -l --quoting-style=c c형태로 파일명을 쿼팅한다. QUOTING_STYLE 환경변수를 오버라이드한다.

               - literal
               - locale
               - shell
               - shell-always
               - shell-escape
               - shell-escape-always
               - c
               - escape

       -r, --reverse
              역순으로 정렬한다.

       -R, --recursive
              하위디렉토리까지 목록화하여 출력한다.

       -s, --size
              파일에 할당된 디스크 사이즈를 출력한다.

       -S    파일 크기에 따라 정렬한다. 사이즈가 큰 파일이 우선 출력된다.  [--sort=WORD 참고]

       --sort=WORD
              정렬 타입을 문자열(WORD)로 지정한다. ls --sort=size 는 ls -S와 같다.
              none -U : 정렬없음
              extension -X : 확장자
              size -S : 파일크기
              time -t : 수정 일시
              version -v : 파일명에 표시된 버전정보  
              width : 파일명의 길이

       --time=WORD
              목록에 보여질 시간을 문자열(WORD)로 지정한다. ls -l -time=atime 은 ls -au와 같다.
              '-l' 옵션은 기본적으로 수정시간을 보여준다.              

              atime -u : 접근시간
              access  -u : 접근시간
              use  -u : 접근시간
              ctime -c : 수정시간(기본값)
              status -c : 수정시간(기본값)
              birth : 생성일시
              creation : 생성일시

              지정된 시간을 정렬기준으로 사용할 수 있다. --sort=time
              
       --time-style=TIME_STYLE
              목록에 보여질 날짜/시간형태를 문자열로 지정한다. TIME_STYLE 은 아래를 참고한다.

       -t     파일 수정일자에 따라 정렬한다. 최신파일이 먼저 출력된다. [--sort=WORD 참고]

       -T, --tabsize=COLS
              목록의 탭간격을 지정한다. 기본값은 8.

       -u    접근시간을 날짜정보로 접근시간을 출력한다. [--time=WORD 참고]
              -lt와 함께 사용하면 접근시간으로 정렬하고 접근시간을 시간정보로 출력한다.
              -l과 함께 사용하면 접근시간을 시간정보로 출력하되 정렬은 파일명에 따른다.
              그외의 경우 접근시간으로 정렬(최신순)하여 출력한다.

       -U    정렬하지 않는다. 디렉토리 순서에 따라 목록을 출력한다. [--sort=WORD 참고]
               수행결과가 -f와 같다.

       -v     파일명 기준의 자연적인 정렬을 수행한다. [--sort=WORD 참고]
               명확한 기준이라기보다 GNU coreutils에서 채택한 내용에 따르는 것으로 보인다.

       -w, --width=COLS
              화면의 크기를 설정한다.  0은 너비 제한을 두지 않는다.

       -x    행을 기준으로 화면을 구성한다. [--format=WORD 참고]
              한 행을 채우고 다음 행을 채우는 식으로 목록을 출력한다.
              -C 옵션은 열을 채우고 다음 열을 채우는 방식으로 출력한다.

       -X    확장자를 기준으로 정렬한다. [--sort=WORD 참고]

       -Z, --context
              SeLinux와 관련된 정보를 사용자.그룹명 이후 컬럼에 출력한다. SELinux를 모른다면 공부가 필요하다.

       --zero 엔트리 출력행의 마지막 부분을 개행(newline)이 아닌 NUL로 변경하여 출력한다.

       -1    목록을 출력할때 라인당 하나의 파일명을 출력한다.  [--format=WORD 참고]

       --help 도움말을 출력 하고 종료한다.

       --version
              버전정보를 출력하고 종료한다.

       :: SIZE ::
        숫자와 추가적인 단위로 작성한다. 예) 10K = 10*1024
        단위는 K,M,G,T,P,E,Z,Y 로 1024의 거듭제곱으로 구성된다.
        KB, MB...(1000의 거듭제곱)도 가능하다.

       ::  TIME_STYLE ::
         full-iso
         long-iso
         iso
         locale
         +FORMAT : date(1)이 처리하는 것과같이 처리한다.

       ::   WHEN ::
         기본값은 'always' 이고 'auto', 'never'도 있다.

      파일타입을 구분하기 위해 컬러를 사용하는 것은 기본적으로 그리고 --color=never에 의해 비활성화되어 있다.
      표준출력이 터미널에 연결되어 있는 경우에 --color=auto로 ls는 컬러코드를 출력한다.
      LS_COLORS 환경변수에 의해 설정을 변경할 수 있다. 그는 dircolors(1)명령을 통해 설정한다.

   종료 상태:
       0      정상 종료
       1      작은 문제 발생 (예. 하위 디렉토리 접근 불가)
       2      심각한 문제 발생 (예. 명령행 인수 접근 불가)

AUTHOR
       Written by Richard M. Stallman and David MacKenzie.

REPORTING BUGS
       GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
       Report any translation bugs to <https://translationproject.org/team/>

COPYRIGHT
       Copyright © 2022 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO
       dircolors(1)

       Full documentation <https://www.gnu.org/software/coreutils/ls>
       or available locally via: info '(coreutils) ls invocation'

GNU coreutils 9.1                                                  September 2022                                                             LS(1)