documentation/README.ko

   1 1. 소개
   2
   3 Wine은 Microsoft Windows 프로그램(DOS, Windows 3.x, Win32 실행 파일
   4 포함)을 유닉스 상에서 실행할 수 있게 해 주는 프로그램입니다.  Wine은
   5 Microsoft Windows 바이너리를 로드하고 실행하는 프로그램 로더와
   6 Unix와 X11 API를 써서 Windows API를 구현한 라이브러리(Winelib)로
   7 이루어져 있습니다.  이 라이브러리는 Win32 코드를 유닉스 실행 파일로
   8 이식하는 용도로도 사용할 수 있습니다.
   9
  10 Wine은 자유 소프트웨어이며 GNU LGPL 하에 배포됩니다.  자세한 내용은
  11 LICENSE 파일을 참조하십시오.
  12
  13
  14 2. 간편 설치 및 실행
  15
  16 소스를 받아 컴파일하는 경우 Wine Installer를 이용하는 것이 좋습니다.
  17  Wine 소스의 최상위 디렉토리에서 다음 명령을 실행합니다:
  18
  19 ./tools/wineinstall
  20
  21 프로그램을 실행할 때는 "wine 프로그램명"처럼 합니다.  더 자세한 정보
  22 및 문제 해결 방법은 이 파일의 나머지 부분과 Wine 맨페이지를 참조하십시오.
  23 특히 https://www.winehq.org 사이트에 방대한 정보가 집약되어 있습니다.
  24
  25
  26 3. 빌드에 필요한 조건
  27
  28 Wine을 컴파일하고 실행하려면 다음 중 하나가 필요합니다:
  29
  30   리눅스 2.0.36 또는 그 이상
  31   FreeBSD 5.3 또는 그 이상
  32   Solaris x86 2.5 또는 그 이상
  33   NetBSD-current
  34   Mac OS X 10.5 또는 그 이상
  35
  36 Wine을 실행하려면 커널 차원의 스레드 지원이 필요하기 때문에 현재는 여기
  37 나열한 운영 체제만 지원합니다.
  38 커널 스레드를 지원하는 기타 다른 운영 체제는 향후 지원할 예정입니다.
  39
  40 리눅스 정보:
  41   리눅스 2.2.x에서는 잘 실행될 것이지만 리눅스 2.0.x에서는 실행될 수도
  42   있고 그렇지 않을 수도 있습니다(초기 2.0.x 버전에서는 스레드 관련 문제로
  43   프로그램이 죽음). 가급적 2.4.x와 2.6.x 같은 최근 커널을 사용하기
  44   바랍니다.
  45
  46 FreeBSD 정보:
  47   FreeBSD 4.x 및 5.x에서 빌드되지만 FreeBSD 5.3 이전 버전에선 제대로
  48   동작하지 않습니다.
  49
  50   더 자세한 정보는
  51   <ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/>
  52   에 있는 FreeBSD ports 페이지를 참조하십시오.
  53
  54 Solaris 정보:
  55   거의 대부분의 경우 Wine을 빌드하려면 GNU 툴체인(gcc, gas 등)을 사용해야
  56   합니다.  경고: gas를 단순히 설치하기만 하면 gcc에서 사용되지 않을 수도
  57   있습니다.  gas를 설치한 다음 gcc를 재컴파일하거나 cc, as, ld 명령을
  58   GNU 바이너리로 심볼 링크를 걸어 주는 일이 필요하다고 합니다.
  59
  60 NetBSD 정보:
  61   USER_LDT, SYSVSHM, SYSVSEM, SYSVMSG 옵션이 커널에 포함되어 있어야 합니다.
  62
  63 Mac OS X 정보:
  64   x86 머신에서 빌드하려면 Xcode 2.4 또는 그 이상이 필요합니다.
  65
  66
  67 지원되는 파일 시스템:
  68   Wine은 대부분의 파일 시스템에서 문제없이 실행됩니다.  그렇지만 /tmp
  69   디렉토리가 umsdos 타입으로 마운트된 경우에는 프로그램이 실행되지
  70   않습니다.  Samba를 이용해서 파일을 액세스하는 경우 몇 가지 호환성
  71   문제가 보고되기도 했습니다.  또한 NTFS는 현재 디스크 기록시 안정성이
  72   보장되어 있지 않습니다.  Windows 프로그램은 대부분 디스크 어딘가에
  73   데이터를 기록하므로 NTFS는 가급적 사용하지 않는 것이 좋습니다.  NTFS
  74   파일의 경우 쓰기 가능한 위치로 복사한 다음 사용하시기 바랍니다.
  75
  76 필수 구성 요소:
  77   X11 개발용 헤더 파일이 설치되어 있어야 합니다(데비안에서는 xlib6g-dev,
  78   레드햇에서는 XFree86-devel이란 패키지명으로 되어 있음).
  79
  80 필수 빌드 도구:
  81   x86 시스템에서는 gcc 2.7.2 이상이 필요합니다.
  82   2.7.2.3 이전 버전은 최적화 옵션을 켜고 컴파일하면 몇몇 파일에서 문제가
  83   발생할 수 있는데, 대부분 헤더 파일 관리와 관련된 문제로 인한 것들입니다.
  84
  85   "make" 프로그램은 당연히 필수입니다(거의 대부분 GNU make 사용).
  86
  87   flex 버전 2.5 이상과 bison이 필요합니다.
  88
  89 선택적 라이브러리:
  90   포함 여부의 선택이 가능한 라이브러리는 ./configure --verbose 명령으로
  91   확인할 수 있습니다.
  92
  93
  94 4. 컴파일하기
  95
  96 wineinstall을 사용하지 않는 경우 다음 명령을 써서 Wine을 빌드합니다:
  97
  98 ./configure
  99 make depend
 100 make
 101
 102 이렇게 하면 "wine" 프로그램과 다수의 라이브러리/바이너리가 빌드됩니다.
 103 "wine" 프로그램은 Windows 실행 파일을 로드하고 실행하는 데 사용됩니다.
 104 "libwine" 라이브러리("Winelib")는 Windows 소스 코드를 유닉스 상에서
 105 컴파일하고 링크하는 용도로 사용할 수 있습니다.
 106
 107 컴파일 설정 옵션을 보려면 ./configure --help 명령을 사용합니다.
 108
 109 패치 파일을 써서 새 릴리스로 업그레이드하려면 먼저 릴리스의 최상위
 110 디렉토리(README 파일이 들어 있는 디렉토리)로 갑니다.  그런 다음
 111 "make clean" 명령을 실행하고 아래 명령으로 소스를 패치합니다:
 112
 113     bunzip2 -c patch-file | patch -p1
 114
 115 "patch-file"은 패치 파일의 이름입니다(wine-0.9.x.diff.bz2 등의 형태).
 116 패치한 다음에는 "./configure", "make depend && make"를 차례로
 117 실행하면 됩니다.
 118
 119
 120 5. 설정
 121
 122 Wine이 일단 정상적으로 빌드된 다음에는 "make install" 명령으로
 123 실행 파일과 맨페이지, 기타 필요한 파일을 시스템에 설치할 수 있습니다.
 124
 125 설치하기 전 이전 버전의 Wine을 제거해야 한다는 점을 잊지 마시기
 126 바랍니다.  "dpkg -r wine" 또는 "rpm -e wine" 또는 "make uninstall" 등의
 127 명령으로 이전 버전을 제거할 수 있습니다.
 128
 129 설정 관련 도움말은 https://www.winehq.org/의 Support 페이지에 있습니다.
 130
 131 라이브러리 로딩 에러("Error while loading shared libraries: libntdll.so")가
 132 발생하는 경우 라이브러리 경로가 /etc/ld.so.conf 파일 안에 지정되어 있는지
 133 확인한 다음 root 권한으로 ldconfig를 실행하십시오.
 134
 135
 136 6. 프로그램 실행
 137
 138 Wine을 실행할 때 실행 파일의 전체 경로를 지정할 수도 있고 파일명만 지정할
 139 수도 있습니다.
 140
 141 예를 들어 카드놀이를 실행하려면:
 142
 143         wine sol                   (파일을 찾기 위해 설정 파일에 지정된
 144         wine sol.exe                검색 경로를 이용)
 145
 146         wine c:\\windows\\sol.exe  (DOS 파일명 문법을 이용)
 147
 148         wine /usr/windows/sol.exe  (유닉스 파일명 문법을 이용)
 149
 150         wine sol.exe /parameter1 -parameter2 parameter3
 151                                    (프로그램을 호출할 때 파라미터를 넘겨줌)
 152
 153 Wine은 아직 완성 단계에 도달하지 못했기 때문에 프로그램이 제대로 실행되지
 154 않을 수 있습니다.  프로그램이 죽는 경우 문제를 분석하고 수정할 수 있도록
 155 디버그 모드로 자동 진입됩니다.  자세한 디버깅 방법은 Wine 개발자 가이드의
 156 디버깅 섹션을 참조하시기 바랍니다.
 157
 158
 159 7. 더 자세한 정보
 160
 161 WWW:    여러 종류의 Wine 가이드, 애플리케이션 데이터베이스, 버그 추적 등
 162         https://www.winehq.org/ 에 있는 WineHQ 사이트에 가면 많은 정보를 얻을
 163         수 있습니다.  정보를 찾을 때 대개 이 사이트가 출발점이 됩니다.
 164
 165 FAQ:    Wine FAQ은 https://www.winehq.org/FAQ 에 있습니다.
 166
 167 Usenet: Wine 관련 주제를 논의하거나 도움을 받으려면 comp.emulators.ms-windows.wine
 168         그룹을 이용하기 바랍니다.
 169
 170 Bugs:   https://bugs.winehq.org 의 Wine Bugzilla에 버그를 보고하십시오.
 171         버그 보고서를 제출하기 전 같은 문제가 이미 제출된 적이 있는지
 172         데이터베이스 검색을 통해 확인하기 바랍니다.
 173         comp.emulators.ms-windows.wine 그룹에 버그 보고서를 올려도 됩니다.
 174
 175 IRC:    irc.freenode.net 의 #WineHQ 채널에서 도움을 받을 수 있습니다.
 176
 177 GIT:    Wine 개발 트리는 현재 GIT로 관리되고 있습니다.  더 자세한 정보는
 178         https://www.winehq.org/site/git 를 참조하기 바랍니다.
 179
 180 메일링 리스트:
 181         Wine 사용자와 개발자를 위해 메일링 리스트가 운영되고 있습니다.
 182         더 자세한 정보는 https://www.winehq.org/forums 를 참조하기 바랍니다.
 183
 184 위키:     Wine 위키는 https://wiki.winehq.org 에 있습니다.
 185
 186 추가할 내용이나 수정할 버그가 있다면 다음번 릴리스에 포함될 수 있도록
 187 wine-devel@winehq.org 메일링 리스트로 패치('diff -u' 형식으로 된)를 보내
 188 주시기 바랍니다.
 189
 190 --
 191 Alexandre Julliard
 192 julliard@winehq.org
 193
 194 Translated into Korean by
 195 Bang Jun-Young
 196 junyoung@mogua.com