---------------

1. 소개

-------

  이 프로그램은 기본적으로 비-한국어판 OS/2 환경의 VIO 프로그램에서 한글 

입출력을 도와주기 위해 만들어졌습니다. OS/2 의 Base Video Subsystem 호출을 

가로채어 PM 창에서 출력되도록 합니다.

2. 제작 환경

------------

  - 한국어판 OS/2 Warp v4 with FixPak #15

  - Open Watcom v2.0.1

3. 실행에 필요한 환경

---------------------

  - 한글( 또는 해당 언어 )를 표현할 수 있는 글꼴

  - 한글( 또는 해당 언어 ) 입력기. 예) KIME

4. 시험 환경

------------

  한국어판 OS/2 Warp v4 with FixPak #15 와 ArcaOS v5.1.0GA 에서 

시험했습니다.

5. 기능

-------

  - OS/2 Base Video Subsystem 을 가로채어 PM 창에 출력하고, 키보드 모니터를 

    이용하여 PM 의 입력을 VIO 프로그램에 전달합니다.

  - 기존의 민초(MINCHO) 글꼴 대신 시스템에서 사용가능한 모든 글꼴을 사용할 수 

    있습니다. 단, 고정폭 글꼴만 가능합니다.

  - 코드 페이지를 따로 지정할 수 있기 때문에 한글 뿐만아니라, 해당 언어 

    입력기와 글꼴만 갖추어진다면 해당 언어의 문자를 입력/출력할 수 있습니다.

  - 다시 보기(Scroll-Back) 기능을 최대 10000줄까지 지원합니다.

  - 클립보드(유니코드)를 지원합니다.

  - FT2LIB 을 지원합니다.

  - 창 크기를 임의로 바꿀 수 있습니다.

6. 설치

-------

  kshell.exe, viodmn.exe, viosub.dll 을 아무 디렉토리에 같이 넣어두시면 

됩니다.

7. 사용법

---------

7-1. 시스템 메뉴

----------------

  Codepage... : 코드 페이지를 지정합니다.

  Font...     : 글꼴의 종류와 크기를 지정합니다.

7-2. 팝업 메뉴

--------------

  Codepage... : 코드페이지를 지정합니다.

  Font...     : 글꼴의 종류와 크기를 지정합니다.

  Copy        : 표시된 내용을 클립보드로 복사합니다.

  Copy All    : 화면의 모든 내용을 클립보드로 복사합니다.

  Paste       : 클립보드에 있는 내용을 화면으로 복사합니다.

  Use FT2LIB  : FT2LIB 사용 여부를 지정합니다.

7-3. 명령행 옵션

----------------

  -rows    : 시작할 때 창의 높이를 지정합니다(최소 10).

  -cols    : 시작할 때 창의 폭을 지정합니다(최소 40, 최대 132)

  -sblines : 스크롤백 버퍼의 줄 수를 지정합니다(최소 1, 기본 1000, 최대 10000)

7-4. 단축키

-----------

  Ctrl-Up   : 스크롤백 모드에서 한 줄 위로 올림

  Ctrl-Down : 스크롤백 모드에서 한 줄 아래로 내림

  Ctrl-PgUp : 스크롤백 모드에서 한 쪽 위로 올림

  Ctrl-PgDn : 스크롤백 모드에서 한 쪽 아래로 내림

8. 제한 사항 또는 알려진 벌레

-----------------------------

  - 키보드 입력과 출력만을 지원합니다. 따라서 마우스 기능은 지원되지 

    않습니다.  

  - Ctrl-P 같은 특수키 조합이 지원되지 않습니다.

  - Q.EXE 에서 Shift-방향키 조합이 작동하지 않습니다.

  - FT2LIB 모드일 경우, 글꼴의 가로 폭이 지나치게 넓어지는 경우가 있습니다.

  - FT2LIB 모두일 경우, 시작할 때 CPU 점유율이 높아집니다.

  - 4OS2에서 CHCP 명령어를 실행하면 4OS2가 죽습니다.

9. 할 것들...

-------------

  - 마우스를 지원한다.

  - 특수키 조합을 지원한다.

10. 판번호 보기

---------------

  - v1.0.0 ( 2026/11/04 )

    .viodmn: Ctrl-S 특수키 조합을 지원합니다.

    .kshell: -rows, -cols 명령행 옵션을 지원합니다.

    .kshell: 실행 중에 창 크기를 바꿀 수 있습니다.

    .kshell: 타이틀 바에 창 크기를 표시합니다.

    .kshell: Ctrl+Shift+Up, Down, PgUp, PgDn으로 스크롤백을 쓸 수 있습니다.

    .kshell: KSHELLOPT 환경 변수로 명령행 옵션을 지정할 수 있습니다.

    .kshell: -sblines 명령행 옵션을 지원합니다.

    .kshell: 항상 FT2LIB을 활성화하느라 시작할 때 CPU 부하가 높아집니다. 

             ( FT2LIB을 사용할 때만 활성화함 ). 고침.

    .kshell: KShell이 비정상적으로 종료할 때 VIODMN이 남아 있습니다. 고침.

    .viodmn: 일부 키보드의 키패드 키들을 일반 문자키로 인식합니다. 고침.

    .컴파일러를 Open Watcom v2.0.1로 바꾸었습니다.

  - v0.8.1 ( 2012/02/05 )

    .때때로 성능이 매우 느려집니다. 고침.

  - v0.8.0 ( 2010/12/26 )

    .viodmn: Pause 키를 지원합니다.

    .viodmn, ft2lib : LIBPATHSTRCIT=T 와의 호환성을 개선했습니다.

    .ft2lib : FT2LIB.DLL 를 로드하지 못했을 때 반환값이 일정하지 않습니다. 

              고침.

    .viodmn : 이름 있는 공유 메모리가 올바르게 해제되지 않습니다. 고침.

    .컴파일러를 Open Watcom v1.8 로 바꾸었습니다.

  - v0.7.0 ( 2008/10/05 )

    .FT2LIB 을 지원합니다.

    .아이콘을 포함했습니다( Alex Taylor 씨 기여 ).

    .클립보드에서 유니코드를 지원합니다( Alex Taylor 씨 기여 ).

    .클립보드에 복사할 때 기존 클립보드 내용이 지워지지 않습니다

     ( Alex Taylor 씨 제보 ). 고침.

    .화면 경계에서 팝업 메뉴 일부가 화면 밖으로 나갑니다. 고침.

  - v0.6.0 ( 2007/04/07 )

    .VioSetMode() 를 지원합니다. 따라서 25 줄뿐만 아니라 43/50 줄도 지원합니다.

    .글꼴을 바꾸면 코드페이지도 함께 바뀝니다. 고침.

    .코드 페이지가 바뀌더라도 DBCS 초기화가 되지 않습니다. 고침.

    .XCOPY.EXE 는 디버그 빌드에서 실행되지 않습니다. 고침( 스택 오버플로우 

     체크를 껐습니다. -s 옵션 추가 )

  - v0.5.0 ( 2007/03/14 )

    .Ctrl-C, Ctrl-Break 특수키 조합을 지원합니다.

    .KSHELL_COMSPEC 환경 변수를 지원합니다.

    .donePipeThreadForVioSub()에서 _endthread()가 잘못 호출됩니다. 고침.

    .v0.4.0 에서 HV.EXE 파일 목록 화면에 빈 사각형이 나타납니다. 고침.

    .'다시 보기' 상태에서 '표시' 기능이 올바르게 작동하지 않습니다. 고침.

    .과도하게 스크롤이 진행되는 상황(예, DIR x:\/s)에서 글쇠를 입력하면 KShell 

     이 반응하지 않습니다. 고침.

    .스크롤 도중에 화면 전환 따위로, KShell 창 전체가 가려지면 KShell 이 

     반응하지 않습니다. 고침.

    .v0.4.0 에서 XCOPY.EXE 가 작동하지 않습니다. 고침. (v0.4.0 은 디버그 빌드가

     배포하였는데, 디버그 빌드에서 문제 발생. 릴리즈 빌드에서는 문제없음. 

     컴파일러 벌레일지도...)

  - v0.4.0 ( 2007/02/26 )

    .'Courier New' 글꼴은 올바르게 표시되지 않습니다. 고침.

    .'Marking Mode' 일 경우, 다른 윈도우에 가려졌던 일부가 올바르게 표시되지 

     않습니다. 고침. 

    .v0.3.0 에서 컴파일러를 바꾸면서, vioGetBuf()가 올바르게 작동하지 

     않습니다. 고침

    .글꼴 연관 기능이 쓰일 경우 계단 현상이 나타납니다. 고침.

    .v0.2.0 에서 스크롤 함수를 바꾸면서, 스크롤 내용이 스크롤 범위 밖으로 

     흘러 나옵니다. 고침.

    .때때로 CPU 점유율이 올라가면서 멈춥니다. 고침(희망사항^^)

  - v0.3.0 ( 2007/01/01 )

    .클립보드를 지원합니다.

    .사소한 벌레들을 잡았습니다.

    .컴파일러를 Open Watcom v1.6 으로 바꾸었습니다.

  - v0.2.0 ( 2005/08/16 )

    .성능이 대폭 향상되었습니다.

    .배경색이 다를 경우, 잔상이 남을 수 있습니다. 고침.

    .화면이 스크롤 될 때, KShell 창의 일부가 다른 창으로 가려지게 되면, 

     KShell 창에 다른 창의 내용이 나타납니다. 고침(GpiBitBlt() 대신 

     WinScrollWindow() 사용).

    .HyperView( HV.EXE ) 는 실행이 되지 않습니다. 고침(DosQuerySysState()의 

     버퍼 크기를 늘림).

  - v0.1.0 ( 2005/02/28 )

    .폴링(Polling) 기법 대신 VioRegister() 이용하여, 출력 속도가 빨라졌습니다.

    .VIO 색상이 올바르게 표시됩니다.

    .DBCS 문자를 연속해서 입력할 경우, 깨진 글자가 나타납니다. 고침.

    .글꼴이 바뀌어도 크기가 바뀌지 않으면 화면이 갱신되지 않습니다. 고침.

    .비트맵 글꼴( 예, MINCHO )의 경우, 다음 실행때 제대로 지정되지 않습니다. 

     고침.

    .글꼴 크기를 pel 단위에서 pt 단위로 바꾸었습니다.

  - test version ( 2005/01/19 )

    .시험판

11. 소스 컴파일 하기

--------------------

  소스를 컴파일하기 위해서는 Open Watcom v1.8 이 필요합니다.

  이 모든 것이 준비되었다면, 해당 디렉토리에서 'wmake' 를 실행하시면 됩니다.

12. 모듈 설명

-------------

  kshell.exe : VIO 의 내용을 PM 상에 뿌려주고, PM 의 입력을 VIO 에 전해주는 

               프로그램 본체.

  viodmn.exe : 'KSHELL_COMSPEC', 'COMSPEC', 'CMD.EXE' 순으로 명령셸을 

               실행시키고, VIO 와 PM 을 연결해주는 프로그램. 

               !!! 단독으로 실행될 수 없습니다 !!!

  viosub.dll : OS/2 Base Video Subsystem 을 가로채기 위한 DLL 입니다.

  test.exe   : VIO 상에서 키가 입력되었을 때 키에 대한 정보를 알려주는 

               프로그램.

13. 고마운 분들...

------------------

  nickk : VioRegister() 를 사용하기 위한 예제를 제공해 주셨습니다.

14. 후원하기

------------

  이 프로그램이 마음에 들어 후원하고 싶으시면, 아래 URL 을 방문해 주십시오.

    https://www.os2.kr/komh/os2factory/

  또는 다음 블로그에서 광고를 클릭해 주십시오.

    https://lvzuufx.blogspot.com/

15. 하고 싶은 말이 있을 때...

-----------------------------

  github 의 이슈 트래커를 이용해 주십시오.

      https://github.com/komh/kshell/issues

                                                       만든이 : 고명훈

전체 이메일을 보내 드렸는데, 

 - 이메일 받으신 분 

 - 실제로 접속하시는 분

등은 댓글을 한번씩 달아 주세요. 그리고 이메일 못 받으신 분들은 이메일 수정도 부탁합니다.

아직 살아 있어요!

TP의 32비트 나눗셈 헬퍼(0x2C248)는 제수가 0이면 이렇게 처리합니다:

0x2c2d4: mov ax, 0xC8   ; 0xC8 = 200  → 소프트웨어적으로 Runtime Error 200 발생
큰 볼륨(예: 8GB HPFS) 에서 전체 크기가 32비트를 넘쳐 wrap → 전체/100 == 0 → 제수 0 → 나눗셈 → RTE200.

수정본 (검증 완료)

제수가 0일 때 RTE200을 던지지 않고 0을 반환하도록 헬퍼를 9바이트만 패치했습니다:

0x2c2d1: 9d 9d 31 c0 31 d2 cb 90 90   ; add sp,4;mov ax,C8;jmp RTE  →  popf;popf;xor ax,ax;xor dx,dx;retf

검증:

정상 볼륨 → 2,013,265,920(93%)byte free 정상 표시 (회귀 없음)

제수 0 강제(고장 조건) → 크래시 없이 파일관리자 정상 실행, 퍼센트만 0%로 표시

산출물 (충실한 원본과 오직 그 9바이트만 다름)

2gb만 쓰고 있었는데 용량이 부족해서 xcopy로 마이그레이션 해주었습니다.
 jfs 사용하고 싶은데 잘 안되네요 ㅠ