기존에 티스토리에서 운영 중이던 프로그래밍 관련 블로그(devnote.tistory.com)를 Octopress로 이사합니다. 사실 운영이라고 말하기도 뭣할 만큼 오랫동안 방치되어 있었는데, 다시금 분위기를 쇄신하고자 환경을 바꿔볼까 합니다.
- +기존 블로그를 feedburner 주소로 구독중이었다면 새로운 블로그로 자동으로 넘어갑니다. 하지만 티스토리 기본 rss 주소를 사용중이었다면, 이참에 feed-burner로 갈아타 주세요 ‘ㅁ’)/
feed burder address : http://feeds.feedburner.com/florist_devnote
diff --git a/2014/07/16/the-benz-programmer/index.html b/2014/07/16/the-benz-programmer/index.html index 21265422..fe069f98 100644 --- a/2014/07/16/the-benz-programmer/index.html +++ b/2014/07/16/the-benz-programmer/index.html @@ -3,7 +3,7 @@ - + @@ -125,12 +125,12 @@ @@ -218,7 +218,7 @@요 며칠간 이 책을 읽었습니다. 회사 도서관에 갔다가 제목이 끌려서 한 번 읽어봤어요.
누가 정한건지 모르겠지만 책 제목 참 멋지게 지었습니다. 주변에서 제가 이 책 읽는 것 보면 모두들 제목에 대해 관심을 보이더군요 ㅎ
진로를 고민중인 학생이나 일을 시작한지 얼마 되지 않는 신입 개발자들을 주 대상으로 삼은 책입니다. 다소 주관적이긴 하지만 선배 개발자 입장에서 들려주는 이런 저런 이야기들이 적혀 있어요.
저자는 자기관리를 잘 하는 분이신 듯 합니다. 구체적인 개인 목표를 세우고 달성을 위해 노력하는 점이라든지, 꾸준한 자기계발에 관심을 두는 점 같은 좋은 습관을 많이 만들어두신 것 같네요.
저는 작업 도중에 빌드 걸어놓고 잠깐씩 기다리는 동안에 주로 읽었습니다.
빌드시간에 조금 난이도가 있는 기술서적을 읽을 때는, 내용을 좀 따라가려다 보면 빌드가 끝나서 흐름이 끊기고, 이게 계속 반복되다보니 책에 제대로 집중할 수가 없었습니다.
그래서 빌드시간에 책읽는 것은 거의 포기를 하고 있었는데, 이런 책은 부담없이 읽을 수 있어서 빌드 중에 읽어도 괜찮더군요.
그래서 앞으로는 빌드하는 중에 이런 가벼운 책들 읽으면 되겠구나 하는 생각을 해봤습니다.
저는 책을 읽다가 조금 엉뚱한 구절에 눈길이 확 쏠렸는데,
diff --git a/2014/07/19/google-c-plus-plus-style-guide/index.html b/2014/07/19/google-c-plus-plus-style-guide/index.html index 7021a6e2..96275439 100644 --- a/2014/07/19/google-c-plus-plus-style-guide/index.html +++ b/2014/07/19/google-c-plus-plus-style-guide/index.html @@ -3,7 +3,7 @@ - + @@ -126,12 +126,12 @@ @@ -217,7 +217,7 @@
지금 참여중인 프로젝트에서 얼마전에 코딩 컨벤션을 통일하는 작업이 있었습니다.
본격적으로 컨벤션을 통일하고 이제 한 서너달? 정도 지난 것 같네요.
처음에는 팀원 대다수가 많이 혼란스러워 했지만 이제 어느 정도 시간이 지나고 나니 팀 내 프로그래머 모두가 거의 유사한 스타일의 코드를 작성하게 됐습니다. 이렇게 되니 전보다 코드 가독성이 좋아지고 협업을 할 때 이런 저런 많은 도움이 됩니다.
-
+
사실 컨벤션이 통일되면 좋다는 것은 아주 상식적인 말입니다만, 개개인이 선호하는 스타일이 다 다르기 때문에 통일을 하기가 쉽지 않다는 것이 문제입니다. 팀에서도 그동안 몇 차례 시도 했었지만 잘 안되었다가, 이번에서야 겨우 성공했어요.
이번에 컨벤션의 통일을 성공한 주된 요인 중의 하나는 구글 내부에서 사용하는 컨벤션을 정리해서 공개한 구글 C++ 스타일 가이드라고 볼 수 있습니다. 이 문서의 내용을 가져와 몇 가지 사항만 프로젝트에 맞게 조정하여 적용 하였지요. 구글 컨벤션의 코드들은 처음 볼 땐 좀 낮설었지만 적응하고 나니 이젠 괜찮군요.
diff --git a/2014/07/21/octopress-tips-on-windows/index.html b/2014/07/21/octopress-tips-on-windows/index.html
index b369ca3c..81633968 100644
--- a/2014/07/21/octopress-tips-on-windows/index.html
+++ b/2014/07/21/octopress-tips-on-windows/index.html
@@ -3,7 +3,7 @@
-
+
@@ -128,12 +128,12 @@
@@ -218,7 +218,7 @@
개인적으로 Octopress를 윈도우에서 사용하도록 구성하면서 도움이 되었던 팁들을 몇가지 정리해 보려고 합니다.
앞으로 계속 사용해 가면서 추가적인 팁이 생길 때에도 이 포스팅에 업데이트 할 생각이예요.
-
+
윈도우 실행 (Windows + R) 창에서 블로그 패스로 바로 이동 하기
@@ -256,6 +256,7 @@ 1
2
3
4
5
6
7
8
cd %blogpath%
rmdir /s /q _deploy
mkdir _deploy
cd _deploy
git init
git remote add origin https://....
git pull
git check --track origin/gh-pages
+
diff --git a/2014/08/19/yoda-notation/index.html b/2014/08/19/yoda-notation/index.html
index ac16d676..845362e4 100644
--- a/2014/08/19/yoda-notation/index.html
+++ b/2014/08/19/yoda-notation/index.html
@@ -3,7 +3,7 @@
-
+
@@ -125,12 +125,12 @@
@@ -220,7 +220,7 @@
이 책을 읽다가 ‘Yoda Notation’이란 표현을 처음 접했습니다. 표현이 재미있어서 블로그에 한 번 적어봅니다. 구글링해보면 Yoda Conditions 라고도 부르는 것 같네요. 프로그램 코드 상에서 조건문에 값 비교 구문을 적을 때 변수와 상수의 위치를 바꾸어 적는 것을 말합니다.
May the force be with you. 1
2
3
4
int val = 20;
if(20 == val) { // <- yoda notation here.
...
}
-
+
조건문을 val == 20
으로 적는 것이 일반적인 언어 어순과 같아서 읽기가 좋지만
프로그래머의 실수로 val = 20
과 같이 잘못된 코드가 만들어지고 컴파일 에러 없이 그대로 실행되는 것을 막기 위해서
일부러 변수와 상수의 위치를 서로 바꾸는 거죠.
요다는 영화 스타워즈에서 영문권 사람들도 이해하기 어려울 정도로 꼬인 문법의 말을 사용합니다. 이를 빗대어 위와 같은 조건문 표기 방식을 Yoda Notation이라고 부르는군요. 재미있는 네이밍입니다 :)
diff --git a/2014/09/12/claenup-cpp-project-1st/index.html b/2014/09/12/claenup-cpp-project-1st/index.html
index beb6816d..eefd426c 100644
--- a/2014/09/12/claenup-cpp-project-1st/index.html
+++ b/2014/09/12/claenup-cpp-project-1st/index.html
@@ -3,7 +3,7 @@
-
+
@@ -125,12 +125,12 @@
@@ -219,7 +219,7 @@ Whole Tomato의 Spaghetti 처럼 인클루드간의 관계를 그래프로 보여주는 툴은 몇 번 본 적 있다. 조낸 멋지게 그래프까지 보여주었지만 정작 불필요한 놈이 무언지 콕 짚어주는 녀석은 없음. 참으로 척박한 현실이다.
그래서 한 번 직접 만들어보기로 했다.
-
+
프로젝트 내의 cpp 파일을 개별 컴파일 하기
일단은 만들려는 툴에서, 입력으로 받은 vc 프로젝트에 포함된 cpp 파일을 개별로 컴파일 할 수 있어야 한다.
그렇게 되면 cpp 파일마다 돌면서 코드 안에 있는 #include를 직접 하나씩 제거해보면서 컴파일이 성공하는지를 확인할거다. 그러면 불필요할 것이라 예상되는 #include의 후보를 만들 수 있다.
무식한 방법이다. cpu를 많이 먹을거고 시간도 오래 걸릴거다. 하지만 저렇게라도 알 수 있다면 새벽에 실행해서 리포트 뽑아놓도록 CI에 물려놓으면 그만이다.
diff --git a/2014/09/17/cleanup-cpp-project-2nd/index.html b/2014/09/17/cleanup-cpp-project-2nd/index.html
index 2844494a..f02e445b 100644
--- a/2014/09/17/cleanup-cpp-project-2nd/index.html
+++ b/2014/09/17/cleanup-cpp-project-2nd/index.html
@@ -3,7 +3,7 @@
-
+
@@ -125,12 +125,12 @@
@@ -218,12 +218,14 @@
지워도 되는 인클루드를 찾아냈다
개별 파일 하나씩을 컴파일 할 수 있다면 이제 모든 인클루드를 하나씩 삭제하면서 컴파일 가능 여부를 확인해보면 된다. 이 부분은 간단한 file seeking과 string 처리 작업일 뿐이니 굳이 부연 설명은 필요 없다. 카페에서 여유롭게 음악을 들으며 즐겁게 툴을 만들자. 뚝딱뚝딱.
이정도 하고 나니 이제 vcxproj파일 경로를 주면 해당 프로젝트에 들어있는 소스코드에서 불필요한 인클루드를 색출해 위치정보를 출력해주는 물건이 만들어졌다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
작업 대상으로 1개의 프로젝트가 입력 되었습니다.
-------------------------------------------------
Service : 프로젝트 정리.
Service : PCH 생성.
컴파일 : stdafx.cpp ... 성공. 걸린 시간 : 1.04초
Client.cpp의 인클루드를 검사합니다.
- process #1 Client.cpp (1/2) ... X
- process #1 Client.cpp (2/2) ... X
ClientAcceptor.cpp의 인클루드를 검사합니다.
- process #1 ClientAcceptor.cpp (1/2) ... 컴파일 가능!
- process #1 ClientAcceptor.cpp (2/2) ... X
ClientConnection.cpp의 인클루드를 검사합니다.
- process #1 ClientConnection.cpp (1/3) ... X
- process #1 ClientConnection.cpp (2/3) ... X
- process #1 ClientConnection.cpp (3/3) ... X
Start.cpp의 인클루드를 검사합니다.
- process #1 Start.cpp (1/4) ... X
- process #1 Start.cpp (2/4) ... X
- process #1 Start.cpp (3/4) ... X
- process #1 Start.cpp (4/4) ... X
ThreadEntry.cpp의 인클루드를 검사합니다.
- process #1 ThreadEntry.cpp (1/1) ... X
-------------------------------------------------
Project : Service 모두 1개의 인클루드가 불필요한 것으로 의심됩니다.
D:\Dev\uni\World\Service\ClientAcceptor.cpp
- 2 line : #include "World/Service/Client.h"
총 소요 시간 : 13.289 sec
-
+
+
이 정도 만들어서 회사에서 만들고 있는 프로젝트에 조금 돌려 보았는데, 덕분에 꽤나 많은 불필요 인클루드를 색출해 내었다. 회사 프로젝트는 덩치가 제법 크고, 아직 서비스 중이지 않은 코드여서 용감무쌍한 리팩토링이 자주 일어나기 때문에 관리가 잘 안되는 파일이 제법 있더라. 아무튼 덕을 톡톡히 보았다.
튜닝 : 솔루션 단위로 검사할 수 있게 만들자
프로젝트 파일 단위로 어느 정도 돌아가니까, 솔루션 파일 단위로도 돌릴수 있게 확장했다. sln 파일을 파싱해서 프로젝트 리스트만 얻어오면 끝나는 일이다.
하지만 sln 파일은 vcxproj 파일처럼 쉽게 파싱할 수는 없다. 이녀석은 xml 포맷이 아니라, 자체적인 포맷을 가지고 있다. 사실 sln 파일을 파싱해 본 게 이번이 처음이 아닌데, 예전에는 lua를 써서 직접 노가다 파싱을 했더니 별로 재미도 없고 잘 돌아가지도 않고 코딩하는 재미도 별로 없더라.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 솔루션 파일은 이렇게 생겼다. 왜죠...
Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio 2013
VisualStudioVersion = 12.0.30723.0
MinimumVisualStudioVersion = 10.0.40219.1
... 중략 ...
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "External", "External", "{F95C61E3-AF95-4CA9-8837-A203762B2B29}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "gtest", "External\gtest\gtest.vcxproj", "{C7A81BFC-6E28-4859-A8B5-2FEA80E012B2}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Test", "Test", "{042F2157-2118-44AA-8BB9-8B5DD01FA3A9}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "unittest", "Test\unittest.vcxproj", "{24A57754-D332-4575-AEBF-2AFCBC0A7E4B}"
EndProject
... 후략 ...
+
C#으로 sln 파일을 파싱해주는 적당히 괜찮은 코드가 인터넷 어딘가에 돌아다닌다. 이곳에 있는 놈을 가져다 붙였다. build configuration 같은 걸 얻어올 순 없지만 프로젝트 리스트 얻는 데에는 충분하다.
튜닝 : 느리다. 멀티 스레드로 돌리자
한때는 툴을 만들때 lua도 써보고 python도 써봤지만 요즘은 C#만 쓰게된다. 디버깅 하기도 편하고, 특히 멀티스레딩으로 돌리기가 너무 편하다. TPL, Concurrent Collection조금 갖다 끄적거리면 금방 병렬처리된다.
특히나 이런 식으로 병렬성이 좋은 툴은 훨씬 빠르게 돌릴 수 있게 된다. 커맨드 라인 인자로 --multi-thread
를 주면 주요 작업을 Parallel.ForEach
로 돌리도록 처리했다. 다만 멀티스레드로 돌리면 파일로 남기는 로그가 엉망이 되기 때문에… 단일 스레드로도 돌 수 있도록 남겨둠.
diff --git a/2014/09/30/cleanup-cpp-project-3rd/index.html b/2014/09/30/cleanup-cpp-project-3rd/index.html
index 8dd907d0..c8eaeb26 100644
--- a/2014/09/30/cleanup-cpp-project-3rd/index.html
+++ b/2014/09/30/cleanup-cpp-project-3rd/index.html
@@ -3,7 +3,7 @@
-
+
@@ -123,12 +123,12 @@
@@ -213,10 +213,11 @@
pch 파일 사이즈
팀에서 만지는 코드에서는, 290Mb에 육박하는 pch파일을 본 적이 있다(…) 그 땐 코드를 정리하면서 pch 사이즈 변화를 자주 확인해봐야 했는데, 탐색기나 커맨드 창에서 매번 사이즈를 조회하기가 불편했던 기억이 있어서 pch 사이즈 확인하는 걸 만들어봤다.
-
+
MSBuild로 단일 cpp 파일을 컴파일하면 이런 메시지가 나오는데,
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\amd64\CL.exe
/c
/ID:\Dev\uni\External\
/ID:\Dev\uni\Test\
/ID:\Dev\uni\
/Zi
/nologo
/W4
/WX
/sdl
/Od
/D WIN32
/D _DEBUG
/D _CONSOLE
/D _LIB
/D _UNICODE
/D UNICODE
/Gm
/EHsc
/RTC1
/MDd
/GS
/fp:precise
/Zc:wchar_t
/Zc:forScope
/Yc"stdafx.h"
/Fp"x64\Debug\unittest.pch"
/Fo"x64\Debug\\"
/Fd"x64\Debug\vc120.pdb"
/Gd
/TP
/errorReport:queue
stdafx.cpp
+
여기 cl.exe
로 들어가는 인자 중에 /Fp"x64\Debug\unittest.pch"
요 부분에 pch 경로가 있음. 그러니까 결국 툴에서 pch사이즈를 구하려면
- 프로젝트 리빌드하고
@@ -237,6 +238,7 @@ 팀에서 정한 컨벤션도 이 규칙을 그대로 따라야 해서.. 매번 코딩할 때마다 인클루드 순서에 신경쓰기 싫어서 자동화 처리를 작성. 더불어 경로 없이 파일명만 적은 경우나 상대경로를 사용한 인클루드도 지정된 path를 모두 적어주도록 컨버팅하는 처리도 만듦. 만드는 과정이야 대단한 건 없다. sln, vcxproj파일 파싱하는 것은 만들어 두었으니, 그냥 스트링 처리만 좀 더 해주면 금방 만들어진다. 툴로 sorting하고나면 아래처럼 만들어줌.
TestCode.cpp 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// system headers
// other project's headers
// inner project's headers
void main() {
return;
}
+
epilog
대충 이정도 돌아가는 툴을 만들어서 개인 pc에 셋팅해둔 jenkins에 물려놓고 사용중. 원래는 필요없는 include찾아주는 기능만 만들려다가 include sorting 기능은 그냥 한 번 추가나 해볼까 싶어 넣은건데, 아주 편하다. 코딩할 땐 순서 상관 없이 상대경로로 대충 넣어놓고 툴을 돌리면 컨벤션에 맞게 예쁘게 수정해준다.
불필요 인클루드를 찾는 동작은 회사 코드 기준으로 컨텐츠 코드 전체 검색시 50분 정도 걸리는 듯. 이건 매일 새벽에 jenkins가 한 번씩 돌려놓게 해놓고, 매일 아침에 출근해서 확인한다.
pch사이즈는 baseline 구축을 생각하고 만들어 본건데.. (박일, 사례로 살펴보는 디버깅 참고) baseline을 만들려면 지표들을 좀 더 모아야 하고, db도 붙여야 하니 이건 제대로 만들려면 시간이 필요할 것 같다(..라고 쓰고 ‘더이상 업데이트 되지 않는다’ 라고 읽는다.)
diff --git "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html" "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
index 54a92f88..7560bd45 100644
--- "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
+++ "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -127,12 +127,12 @@
@@ -219,7 +219,7 @@
예전에 트위터 하다가 읽었던 글인데, 개인적으로 마음에 들어서 부족하게나마 번역해 보았습니다.
원문은 슬랙 개발 블로그의 Technical Leadership: Getting Started라는 글입니다.
번역에 크게 자신이 없으니 부담이 없으신 분들은 원문을 보셔요.
-
+
테크니컬 리더십: 시작하기
내가 소프트웨어 엔지니어가 되기 전에는 이 직업에서 가장 중요한 점은 코딩이라고 생각했다. 그것은 잘못된 생각이었고, 소프트웨어 공학의 가장 중요한(그리고 가장 어려운)점은 다른 사람들과 원만하게 잘 협력하는 것이다.
나는 “관리자는 되지 않을거야!”라고 스스로에게 말해왔고, “그렇게 하면, 내 모든 에너지를 개발에만 집중시킬 수 있을거야!” 라고 생각했다. 내 이후의 경력도 기술 지향적인 실무자 위주로만 관리해 간다면 이 어려운 대인관계를 어느 정도 무시할 수 있을 거라고 생각했다.
diff --git "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
index 4b5e4da7..ba3c1335 100644
--- "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
+++ "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -129,12 +129,12 @@
@@ -220,10 +220,11 @@
C++에서 가장 기본적으로 사용했던 __FILE__, __LINE__, __FUNCTION__
등의 매크로와 유사한 효과를 내는 방법에 대해 적어본다. 이와 함께 나에게는 생소했던 string interning 개념에 대해서도 살짝 소개해본다. 자바 같은 managed 언어를 깊이 다뤄본 적이 없는 네이티브 개발자에게는 생소한 개념일 것이다.
UI가 없는 서버에서 동작의 내용을 확인하는 가장 기본적인 방법은 file로 남기는 log다. 정상 동작이나 오류상황에 대한 상세한 로그가 남아야 문제가 생겼을 때 파악하기가 쉽기 때문에, 간단한 동작이지만 아주 빈번하게 호출되는 부분이다. 로그 출력에서 성능을 많이 빼앗기지 않도록 기반을 다져놓으면 비즈니스 로직 구현을 위해 더 많은 H/W 리소스를 배분할 수 있다.
성능을 굳이 신경쓰지 않는다면 아래 있는 내용을 끝까지 모두 적용할 필요는 없다.
-
+
콜스택을 얻어와서 가장 마지막 함수를 찍는 방법
현재 스레드 컨텍스트에서의 StackFrame 정보를 얻어온 후, 프레임 데이터의 가장 마지막 부분을 읽어 호출자의 정보를 얻어낼 수 있다. C#으로 함수 호출 위치를 얻어올 때 가장 많이 쓰이는 방법이다. 가장 태초부터 있었던 방법이기 때문이다. 다음에 설명할 CompilerServices attribute는 .Net Framework 4.5부터 사용이 가능해졌기 때문에, 초창기 C#에서는 콜스택에서 읽어내는 방법 말고는 딱히 다른 선택지도 없었다.
1
2
3
4
5
6
7
8
9
StackTrace st = new StackTrace(new StackFrame(true));
Console.WriteLine(" Stack trace for current level: {0}", st.ToString());
StackFrame sf = st.GetFrame(0);
Console.WriteLine(" File: {0}", sf.GetFileName());
Console.WriteLine(" Method: {0}", sf.GetMethod().Name);
Console.WriteLine(" Line Number: {0}", sf.GetFileLineNumber());
Console.WriteLine(" Column Number: {0}", sf.GetFileColumnNumber());
+
C#에서 흔하게 사용하는 로깅 라이브러리인 Log4Net, NLog 등에서도 이 방법을 사용한다.
콜스택 기반 장점 : 가장 범용적이다. 프레임워크 호환성이 가장 좋음
.Net Framework의 태초부터 있었던 방식이므로 가장 범용적이다. 오래된 버전의 닷넷 프레임워크나 mono 프레임워크 등을 지원해야 하는 상황이라면 이 방법 말고는 마땅한 대안이 없다. 그래서 Log4Net, NLog 등의 유명한 라이브러리도 이 방법을 사용하고 있다. 이들은 불특정 다수의 환경에서 실행되어야 할 범용성이 중요한 모듈이기 때문이다.
콜스택 기반 단점 : 말해서 무엇하랴. 비용이 비싸고 느리다.
지금 회사에서 사용하는 게임서버 엔진은 처음에 Log4Net을 쓰다가, 나중에 NLog로 바꾸었다가, 현재는 자체 구현한 파일로그 모듈을 쓰고 있다. 외부 모듈로는 내가 만족하는 성능을 얻지 못했기 때문이다.
@@ -232,13 +233,16 @@ System.Runtime.CompilerServices
.NET Framework 4.5부터 새로운 방식으로 함수 호출자의 정보를 가져올 수 있게 되었다. 요즘 .NET 6에 대한 뉴스도 돌고 있는 현시점에서 보면 충분히 오래된 방식이다. 만들어야 하는 프로그램의 런타임을 특정 프레임워크만 사용하도록 한정할 수 있다면 이 방식을 사용하는 것을 추천한다. 게임서버는 런타임 환경을 단 하나의 프레임워크로 고정할 수 있으니, 크게 문제될 것이 없다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public void DoProcessing()
{
TraceMessage("Something happened.");
}
public void TraceMessage(string message,
[CallerMemberName] string memberName = "",
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
Trace.WriteLine("message: " + message);
Trace.WriteLine("member name: " + memberName);
Trace.WriteLine("source file path: " + sourceFilePath);
Trace.WriteLine("source line number: " + sourceLineNumber);
}
+
함수 인자에 기본값이 있기 때문에 작업자가 함수를 호출할 때 값을 전달하지는 않지만, 그래도 보이지 않게 뒤쪽 인자를 통해 호출자의 파일명, 라인수 등이 넘어가는 방식이다. 인자에 붙어있는 attribute로 인해 함수 호출 위치에 맞는 값들이 런타임에
채워진다.
과거의 오래된 프레임워크를 지원할 수 없다는 점이 거꾸로 단점이 될텐데, 사실 NLog같이 누구나 어디서나 사용해야할 로그모듈을 만들게 아니고, 게임서버처럼 특정 비즈니스 프로젝트로 사용처를 한정한다면 오래된 프레임워크 미지원은 그렇게 큰 단점은 아니다.
CompilerServices 장점 : 가볍고 빠르다.
위에서 언급했던 StackFramek 클래스를 사용하는 방식보다 훨씬 빠르다. C++의 __FILE__, __LINE__
은 매크로니까 이미 컴파일 타임에 문자열과 숫자로 치환되어 코드에 포함된다. CompilerServices 사용 방식은 런타임에 함수의 인자로 넘어가는 방식이니까 이것만큼 optimal할 수는 없지만, 콜스택을 긁어오는 것보다는 훨씬 빠르다.
CompilerService 단점 : 가변인자 인터페이스 사용이 불가능 해진다.
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
WriteLog("invalid value:{0}", value); // 불가능합니다.
}
public void WriteLog(string format,
params object[] list,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
함수의 뒷부분 인자를 사용하게 되니까, 위와 같은 사용이 불가능하다. 예시처럼 formatting이 될 문자열을 처음에 받고 두번째부터 가변 인자를 받는 방법은 C++에서 로그 인터페이스를 만드는 가장 익숙한 방식이다.
하지만 C#은 나름대로의 해결법이 있다. 보간 문자열을 이용해 문자열을 포매팅하면 된다. .NET Framework 4.6 과 함께 C# 문법이 6.0으로 올라갔고 이 때부터 보간 문자열이 사용 가능해졌다. 최신의 C#에서는 String.Format보다 보간 문자열의 사용이 더 권장된다. - Effective C#, 빌 와그너. Chapter 1.4 string.Format()을 보간 문자열로 대체하라
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
// WriteLog("invalid value:{0}", value); // C++스러워 보이지만, 촌스러운 방식이예요.
WriteLog($"invalid value:{value}"); // 가능합니다. 권장됩니다. Effective C# 읽어보세요.
}
public void WriteLog(string message,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
C#이 5.0이었을 시점만 해도 이건 큰 단점이었다. 하지만 현 시점에서 이것도 그리 문제될 것이 없다.
C++은 코드영역을 사용하지만, C#은 힙을 사용한다.
좀 더 성능에 집착해보자(?).
윗부분에서 잠시 언급했듯이, C++의 __FILE__, __LINE__
은 컴파일 시점에 이미 실제 값으로 변환을 완료하는 preprocessing 이다. 런타임에 함수 호출자 정보를 얻기 위해 추가로 들이는 비용이 거의 없다.
@@ -256,8 +260,10 @@
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
using System;
using System.IO;
using System.Runtime.CompilerServices;
public static class Log
{
public static void Debug(string message, [CallerFilePath] string file = "", [CallerLineNumber] int line = 0)
{
// ... 중략...
provider.Debug($"{message} ({BuildTag(file, line)})");
}
private static string BuildTag(string file, int line)
{
return string.Intern($"{Path.GetFileName(file)}:{line.ToString()}");
}
}
+
전달받은 파일명을 바로 사용하지 않고 string.Intern()으로 한 번 감싸서 사용한다. 로그를 출력하면 아래처럼 찍힌다.
1
2
3
4
5
2020-12-21 12:08:02.144 [Debug] [ConnectionMonitor] add uid:1 #connection:1 (ConnectionMonitor.cs:32)
2020-12-21 12:08:02.145 [Info] [Send] [20017] kREGISTER_GAME_SERVER_REQ actionId:3 (SerializableExt.cs:92)
2020-12-21 12:08:02.205 [Info] db connection Initialized. type:Auth server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.221 [Info] db connection Initialized. type:Contents server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.238 [Info] db connection Initialized. type:Game server:localhost count:16 (DbPool.cs:40)
+
interning은 입구만 있고, 출구는 없는 string pool이다. 풀에 등록은 할 수 있지만 해제할 수는 없다. 한 번 쓰고 마는 동적인 문자열은 당연히 interning해서는 안된다. 반복적으로 사용하더라도 빈도가 낮아서, heap의 할당과 해제에 큰 압력을 주지 않는다면 이것도 굳이 interning할 필요는 없다. 이런 문자열들을 interning하면 장시간 떠있어야 하는 서버 프로그램의 경우 오히려 더 악영향을 끼칠 수 있다. 용도에 맞게 적절하게 적용해야 한다.
C#에서 코드에 함께 적혀있는 literl text들은 기본적으로 interning된다. C++처럼 code segment를 직접 가르키지는 않지만, 비슷한 효과를 내기 위함이다. 그 외에 프로그램이 사용하는 나머지 문자열에 대해서는 어떤 것을 interning할지 직접 판단하고 선별 적용해야 한다. 로그 메세지에 반복적으로 찍히는 소스코드 파일명은 interning하기에 적합한 대상이다.
마치면서
로그파일에서 로그 출력 위치를 남기는 방식에 관련해 성능 위주의 고려사항을 정리해 보았다.
diff --git "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
index 598ca338..a6a335c2 100644
--- "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
+++ "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -133,12 +133,12 @@
@@ -227,7 +227,7 @@
2018년에 네트워크 레이어 성능을 끌어올리기 위해 도입했던 System.IO.Pipeline을 간단히 소개하고, 도입 후기를 적어본다.
윈도우 OS에서 고성능을 내기 위한 소켓 프로그래밍을 할 때 IOCP 의 사용은 오래도록 변하지 않는 정답의 자리를 유지하고 있다. 여기에서 좀 더 성능에 욕심을 내고자 한다면 Windows Server 2012부터 등장한 Registerd IO 라는 새로운 선택지가 있다. 하지만 API가 C++ 로만 열려 있어서, C# 구현에서는 사용하기가 쉽지 않다.
하지만 C#에도 고성능 IO를 위한 새로운 API가 추가되었다. Pipeline 이다.
-
+
System.IO.Pipeline 소개.
pipeline을 처음 들었을 때는 IOCP의 뒤를 잇는 새로운 소켓 API인줄 알았다. C++의 RIO가 iocp를 완전히 대체할 수 있는 것처럼.
RIO는 가장 핵심 요소인 등록된 버퍼(registered buffer)
외에, IO 요청 및 완료 통지 방식도 함께 제공하기 때문에 iocp를 완전히 드러내고 대신 사용할 수 있다. 반면 Pipeline은 RIO보다는 커버하는 범위가 좁아서, IOCP를 완전히 대체하는 물건이 될 수는 없다. 이벤트 통지는 기존의 방법들을 이용하면서, 메모리 버퍼의 운용만을 담당하는 라이브러리 이기 때문에 IOCP와 반드시 함께 사용해야 한다.
@@ -249,6 +249,7 @@
1
2
3
4
5
6
7
8
9
// msdn 블로그에 소개된 코드 일부 발췌. Pipe를 하나 만들면 읽기/쓰기 Task를 2개 만든다.
async Task ProcessLinesAsync(Socket socket)
{
var pipe = new Pipe();
Task writing = FillPipeAsync(socket, pipe.Writer);
Task reading = ReadPipeAsync(pipe.Reader);
return Task.WhenAll(reading, writing);
}
+
원인은 Pipeline과 함께 사용하는 task (System.Threading.Tasks.Task) 들이었다. class Pipe
인스턴스 하나를 쓸 때마다 파이프라인에 ‘읽기’와 ‘쓰기’를 담당하는 class Task
객체 두 개를 사용하게 된다. 수신버퍼에만 Pipe를 달면 소켓의 2배, 송수신 버퍼에 모두 달면 소켓의 4배수 만큼의 task가 생성 되어야 하기 때문이다. 게임서버 프로세스당 5,000 명의 동접을 받는다고 하면 최대 20,000개의 task가 생성되고, 이 중 상당수는 waiting 상태로 IO 이벤트를 기다리게 된다.
task가 아무리 가볍다고 해도 네트워크 레이어에만 몇 만개의 task를 만드는 것은 그리 효율적이지 않다. TPL에 대한 이야기를 시작하면 해야 할 말이 아주 많기 때문에 별도의 포스팅으로 분리해야 할 것이다. 과감히 한 줄로 정리해보면, task는 상대적으로 OS의 커널오브젝트인 스레드보다 가볍다는 것이지 수천 수만개를 만들만큼 깃털같은 물건은 아닌 것이다.
스레드가 코드를 한 단계씩 수행하다가 아직 완료되지 않은 task를 await 하는 구문을 만나면 호출 스택을 한 단계씩 거꾸로 올라가면서 동기 로직의 수행을 재개한다. 하지만 완료되지 않은 task를 만났다고 해서 그 즉시 task의 완료 및 반환값 획득을 포기하고 호출스택을 거슬러 올라가는 것은 아니다. 혹시 금방 task가 완료되지 않을까 하는 기대감으로 조금 대기하다가 완료될 기미가 보이지 않으면 그 제서야 태세를 전환하게 된다. 이 전략은 task가 동시성을 매끄럽게 처리하기 위해서는 바람직한 모습이지만, 아주 많은 개수의 task를 장시간(게임서버에서 다음 패킷을 받을 때까지의 평균 시간) 동안 대기시켜야 하는 네트워크 모델에 사용하기에는 적합하지 않다. 스레드들은 각 pipeline의 write task가 RecvComplete 통지를 받고 깨어나기를 기다리면서 수십만 cpu clock을 낭비하게 된다.
@@ -272,6 +273,7 @@ <
패킷을 보낼때는 데이터 타입을 버퍼로 직렬화 한 후, 이 버퍼를 메모리 복사 없이 소켓에 그대로 연결해주기 위한 추가 처리가 있어야 하는데, 이건 송신 버퍼에만 필요한 동작이라서 클래스를 별도로 나누었다. 각 용도에 특화된 메서드가 추가 구현 되어있을 뿐 코어는 모두 비슷하다. 모두 단위 버퍼를 줄줄이 비엔나처럼 연결해 들고 있는 역할을 한다.
이들 중에 가장 기본이 되는 ZeroCopyBuffer 를 조금 보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
namespace Cs.ServerEngine.Network.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
public int SegmentCount => this.segments.Count;
public int CalcTotalSize()
{
int result = 0;
foreach (var data in this.segments)
{
result += data.DataSize;
}
return result;
}
public BinaryWriter GetWriter() => new BinaryWriter(new ZeroCopyOutputStream(this));
public BinaryReader GetReader() => new BinaryReader(new ZeroCopyInputStream(this));
internal void Write(byte[] buffer, int offset, int count)
{
while (count > 0)
{
if (this.last == null || this.last.IsFull)
{
this.last = LohSegment.Create(LohPool.SegmentSize.Size4k);
this.segments.Enqueue(this.last);
}
int copied = this.last.AddData(buffer, offset, count);
offset += copied;
count -= copied;
}
}
internal LohSegment[] Move()
{
var result = this.segments.ToArray();
this.segments.Clear();
this.last = null;
return result;
}
internal LohSegment Peek()
{
return this.segments.Peek();
}
internal void PopHeadSegment()
{
var segment = this.segments.Dequeue();
segment.ToRecycleBin();
if (this.segments.Count == 0)
{
this.last = null;
}
}
}
}
+
본 주제와 관련한 인터페이스만 몇 개 간추려 보았다. Queue<LogSegment>
가 Pipeline 안에 있는 단위버퍼의 링크드 리스트 역할을 한다. Write()와 Move()는 메모리 복사 없이 데이터를 쓰는 인터페이스가 되고, Peek(), PopHeadSegment()는 데이터를 읽는 인터페이스가 되는데, internal 접근자니까 실제 사용계층에는 노출하지 않는다. Detail 하위의 *Stream 클래스를 위한 메서드들이다.
조각난 버퍼를 하나의 가상버퍼처럼 추상화해주는 로직은 *Stream들이 담고있다. System.IO.Stream을 상속했기 때문에 사용 계층에서는 보통의 파일스트림, 메모리 스트림을 다루던 방식과 똑같이 값을 읽고 쓰면 된다. 사용한 segment들을 새지 않게 잘 pooling하고, 버퍼 오프셋 계산할때 오차없이 더하기 빼기 잘해주는 코드가 전부인지라 굳이 옮겨붙이지는 않는다.
이렇게 하니 ZeroCopyBuffer
는 가상의 무한 버퍼 역할을 하고, 사용 계층에는 Stream 형식의 인터페이스를 제공하는 System.IO.Pipeline
의 유사품이 되었다. 제공되는 메서드 중에는 async method
가 하나도 없으니 cpu clock을 불필요하게 낭비할 일도 없다. 이렇게 디자인 하는것이 기존의 iocp 기반 소켓 구현에 익숙한 프로그래머에겐 더 친숙한 모델이면서, 성능상으로도 Pipeline보다 훨씬 낫고(tcp 기반 게임서버 한정), Unity3D처럼 최신의 Memory api가 지원 안되는 환경에서도 문제없이 사용할 수 있다.
diff --git "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html" "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
index a2bb2da9..aff0383e 100644
--- "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
+++ "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -131,12 +131,12 @@
@@ -223,7 +223,7 @@
프로그래밍에서 각 스레드별로 고유한 상태를 설정할 수 있는 공간을 Thread Local Storage (이하 TLS. transport layer security 아님) 라고 한다. VC++에서는 __declspec(thread)
키워드를 이용해서 tls 변수를 선언할 수 있다.
C#에도 ThreadLocal<T>
라는 클래스를 이용해 tls를 사용할 수 있지만, 막상 실제로 사용해보면 C++에서는 존재하지 않았던 큰 차이점이 있다. C# 5.0부터 들어온 async / await 문법을 이용해 비동기 프로그래밍을 구현했다면, await 대기 시점 이전과 이후에 스레드가 달라지기 때문이다.
이를 해결하는 방법과 주의해야 할 사항을 정리해본다.
-
+
알림 : 이 글을 처음 포스팅한 후 받은 피드백을 통해 보다 명확한 원인과 해결방법을 추가 확인하게 되어 내용을 수정/보완 했습니다. 최초 버전의 글도 유지하려 했으나 글의 문맥이 복잡해지고 읽기가 어려워져 최종 버전만 남겼습니다.
수정한 내용 요약 : 새로 깨어난 스레드인데도 AsyncLocal<T>
에 값이 남아있던 이유는, 기존의 값이 지워지지 않았기 때문이 아니라, 네트워크 이벤트 콜백으로 깨어난 스레드에도 AsyncLocal<T>
의 값을 복사하고 있었기 때문이었습니다.
@@ -238,6 +238,7 @@ ThreadLocal
우선 잠깐 언급했던 ThreadLocal<T>
클래스를 간단히 알아보자. 이를 이용해 일반적인 tls 변수를 선언하고 사용할 수 있다. 이보다 전부터 있었던 [ThreadStatic]
어트리뷰트로도 똑같이 tls를 선언할 수 있지만, 변수의 초기화 처리에서 ThreadLocal<T>
가 좀 더 매끄러운 처리를 지원한다. 일반적인 tls가 필요할 때는 좀 더 최신의 방식인 ThreadLocal<T>
를 사용하면 된다.
모든 tls 변수에 동일한 값의 복제본을 저장해 두려는 경우가 있다. 예를들어 스레드가 3개 있으면, 메모리 공간상에 각 스레드를 위한 변수 3개가 있고, 이들 모두에 같은 의미를 가지는 인스턴스를 하나씩 생성해 할당하는 경우를 말한다. 서로 다른 스레드끼리 공유해야 할 자원이 있을 때, 해당 자원에 lock이 없이 접근하고 싶다면 tls를 이용해 각 스레드마다 자원을 따로 만들어 각자 자기 리소스를 쓰게 하면 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
namespace Cs.Math
{
public static class RandomGenerator
{
public static int Next(int maxValue)
{
return PerThreadRandom.Instance.Next(maxValue);
}
// ... 중략
// 사용 계층에 노출할 인터페이스를 이곳에 정의. 사용자는 tls에 대해 알지 못한다.
// System.Random 객체는 멀티스레드 사용에 안전하지 않으므로 각 스레드마다 개별 생성.
private static class PerThreadRandom
{
private static readonly ThreadLocal<Random> Random = new ThreadLocal<Random>(() => new Random());
internal static Random Instance => Random.Value;
}
}
}
+
이런 경우는 비동기 메서드의 실행중 스레드의 교체가 발생하더라도 아무 문제가 되지 않는다. 어차피 어떤 스레드로 바뀌더라도 tls 변수가 하는 역할은 동일하기 때문이다. 0번 스레드가 불러다 쓰는 Random
객체가 어느순간 2번 스레드의 Random
객체로 바뀐다 해도 동작에 큰 영향이 없다.
AsyncLocal
문제는 스레드별로 tls의 상태가 서로 달라야 할 때 발생한다. 0번 스레드에는 tls에 “철수”가, 2번 스레드에는 “영희”가 적혀있어야 하고, 이를 사용해 스레드마다 다른 동작을 해야 하는 경우. 그런데 거기다 async/await를 이용한 비동기 프로그래밍을 함께 사용한 경우. 0번 철수 스레드가 코드 수행 도중 await 구문을 만나 task의 완료를 기다리고 있었지만, 대기가 풀렸을 때는 2번 스레드로 갈아타게 되면서 철수가 영희가 되버리는 경우다.
@@ -271,9 +272,11 @@ 원치 않는 AsyncLocal 복사는 꺼준다.
다행히 이 동작은 ExecutionContext.SuppressFlow / RestoreFlow 라는 메서드가 있어 쉽게 제어가 가능하다. 우선 스레드풀에 백그라운드 작업을 요청할 때는 SuppressFlow()
호출이 묶여있는 별도의 인터페이스를 만들고 이를 사용하게 한다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
public static class BackgroundJob
{
public static void Execute(Action action)
{
using var control = ExecutionContext.SuppressFlow();
ThreadPool.QueueUserWorkItem(_ => action());
}
}
public static class Program
{
public void Foo()
{
int a = 10;
int b = 20;
// 백그라운드 작업이 필요할 때. Wrapping한 인터페이스를 사용한다.
BackgroundJob.Execute(() =>
{
Console.WriteLine($"a + b = {a+b}");
});
}
}
+
작업 요청 후에는 RestoreFlow
를 불러 복구해주면 되는데, SuppressFlow
메서드가 IDisposable인 AsyncFlowControl 객체를 반환하니까 예시처럼 using을 쓰면 좀 더 심플하게 처리할 수 있다.
네트워크 구현부에도 수정이 필요하다. SocketAsyncEventArgs
객체를 사용해 비동기 요청을 수행하는 모든 곳에도 RestoreFlow
를 불러준다. (SocketAsyncEventArgs
는 win32의 OVERLAPPED
구조체를 거의 그대로 랩핑해둔 클래스다.) 예시로 하나만 옮겨보면 아래처럼 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public abstract class ConnectionBase
{
public void ConnectAsync(IPAddress ip, int port)
{
var args = new SocketAsyncEventArgs();
args.Completed += this.OnConnectCompleted; // 이 메서드가 새로운 스레드에서 불리게 될 것이다.
args.RemoteEndPoint = new IPEndPoint(ip, port);
using var control = ExecutionContext.SuppressFlow(); // 이걸 넣어주어야 콜백 스레드로 AsyncLocal을 복사하지 않는다.
if (!this.socket.ConnectAsync(args))
{
this.OnConnectCompleted(this.socket, args);
}
}
}
+
이런식으로 SendAsync, RecvAsync 등도 다 막아주어야 일반적인 iocp 콜백 사용 방식과 동일해진다. 다른 코드상에서 아무데도 AsyncLocal<T>
을 사용중이지 않다면 굳이 SuppressFlow 호출이 없어도 동작에는 문제가 없다. 그래도 어차피 사용하지도 않을 암묵적인 실행 컨텍스트간 연결 동작은 그냥 끊어두는 것이 성능상 조금이라도 이득일 듯한 기분이 든다.
정리
- C#의 비동기 메서드는 코드상으로는 매끈하게 이어져 있는듯 보이지만 실은 비동기 요청 지점을 전후로 분리 실행되며, 실행 스레드가 서로 다를 수도 있다.
diff --git "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
index 2f5cd397..64ba8ee7 100644
--- "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
+++ "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -134,12 +134,12 @@
@@ -227,7 +227,7 @@
이제 닷넷의 GC는 꽤나 쓸만하게 발전하여, 웬만한 경우는 프로그래머가 메모리 관리를 굳이 신경쓰지 않고 코딩할 수 있게 도와준다. 그리고 그것이 C++ 대신 C#을 선택하는 큰 이유이기도 하다. 하지만 C# 게임서버로도 성능에 욕심을 내고자 한다면, 짧은 순간 대량의 TPS를 낼 수 있는 네트워크 IO를 구현하려고 한다면 어느정도 메모리 운용에 대한 이해가 필요하다.
이번 포스팅에서는 네트워크 IO의 부하가 가중될 때 겪을 수 있는 메모리 단편화 현상에 대해서 정리해본다.
-
+
기본 용어 및 개념 정리
SOH / LOH / POH
가장 먼저 관리 힙(managed heap)
의 구분부터 이야기 해야한다. 관리힙은 사용 메모리의 크기와 용도 등에 따라 SOH
, LOH
, POH
로 나뉜다.
@@ -273,8 +273,10 @@ C# 고성능 서버 - System.IO.Pipeline 도입 후기에서 여러개의 단위버퍼를 이어붙여 가상의 스트림처럼 운용하는 ZeroCopyBuffer
의 구현에 대해 간단히 소개했었다. 이 때 등장했던 단위버퍼 LohSegment
클래스가 바로 LOH
에 할당한 커다란 청크의 일부분에 해당한다.
1
2
3
4
5
6
7
8
namespace Cs.ServerEngine.Netork.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
// ^ 여기 얘네들이예요.
...
+
LohSegment
를 생성, 풀링하고 관리하는 구현은 크게 대단할 것은 없다. 어차피 할당 크기가 85kb보다 크기만 하면 알아서 LOH
에 할당될 것이고.. 청크를 다시 잘 쪼개서 ConcurrentQueue<>
에 넣어뒀다가 잘 빌려주고 반납하고 관리만 해주면 된다.
조금 더 신경을 쓴다면 서비스 도중 메모리 청크를 추가할당 할 때의 처리 정도가 있겠다. Pool에 남아있는 버퍼의 개수가 좀 모자란다 싶을 때는 CAS 연산으로 소유권을 선점한 스레드 하나만 청크를 할당하게 만든다. 메모리는 추가만 할 뿐 해제는 하지 않을거니까 이렇게 하면 lock을 안 걸어도 되고, pool의 사용도 중단되지 않게 만들 수 있다. 해당 구현체의 멤버변수들만 붙여보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
namespace Cs.Memory
{
public sealed class LohPool
{
private const int ChunkSizeMb = 100;
private const int LowSegmentNumberLimit = 1000;
private readonly int segmentSizeKb;
private readonly int segmentSizeBytes;
private readonly List<byte[]> chunks = new List<byte[]>(capacity: 10);
private readonly ConcurrentQueue<ArraySegment<byte>> segments = new ConcurrentQueue<ArraySegment<byte>>();
private readonly AtomicFlag producerLock = new AtomicFlag(false);
private int totalSegmentCount;
...
}
}
+
정리
C++로만 만들던 게임서버를 C#으로 만든다고 했을 때 가장 신경쓰였던 것이 메모리 부분이었다. 초기구현과 서비스를 거치면서 메모리 누수, 관리힙 사이즈 증가등 많은 메모리 문제를 겪었다. 그 중에서 가장 크게 문제를 겪었던 단편화에 대해 정리해 보았다.
우리가 겪었던 메모리 단편화 가장 주된 요인은 네트워크 IO용 바이트 버퍼의 pinning 때문이었다. 적당한 수준의 부하로는 별 문제 없는데.. 부하를 세게 걸면 점유 메모리가 계속 증가하고 가라않질 않았다. 이건 C++도 마찬가지지만 외형적으로만 관측하면 메모리 누수처럼 보이기 때문에, 단편화가 원인일 것이라는 의심을 하기까지도 많은 검증의 시간이 필요했다.
SOH
에서는 pinning되는 메모리가 많으면 GC 능력이 많이 저하되고 단편화가 심각해진다. 네트워크 버퍼로 사용할 객체들을 LOH
에 할당하면 이런 문제를 해결할 수 있다.
참고자료
@@ -313,6 +315,9 @@
+
+ iTerm2 없이 맥 기본 터미널 꾸미기
+
diff --git "a/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/cursor_setting.png" "b/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/cursor_setting.png"
new file mode 100644
index 0000000000000000000000000000000000000000..d8a2af0054c21d6ff5c104fa45a3c73db3f5630d
GIT binary patch
literal 19238
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
P+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+iTerm2 없이 맥 기본 터미널 꾸미기 | leafbird/devnote
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 0%
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png" "b/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png"
new file mode 100644
index 0000000000000000000000000000000000000000..d9bd76870fa3b07f8663a79642714722985c338b
GIT binary patch
literal 523706
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
지금 참여중인 프로젝트에서 얼마전에 코딩 컨벤션을 통일하는 작업이 있었습니다.
본격적으로 컨벤션을 통일하고 이제 한 서너달? 정도 지난 것 같네요.
처음에는 팀원 대다수가 많이 혼란스러워 했지만 이제 어느 정도 시간이 지나고 나니 팀 내 프로그래머 모두가 거의 유사한 스타일의 코드를 작성하게 됐습니다. 이렇게 되니 전보다 코드 가독성이 좋아지고 협업을 할 때 이런 저런 많은 도움이 됩니다.
- +사실 컨벤션이 통일되면 좋다는 것은 아주 상식적인 말입니다만, 개개인이 선호하는 스타일이 다 다르기 때문에 통일을 하기가 쉽지 않다는 것이 문제입니다. 팀에서도 그동안 몇 차례 시도 했었지만 잘 안되었다가, 이번에서야 겨우 성공했어요.
이번에 컨벤션의 통일을 성공한 주된 요인 중의 하나는 구글 내부에서 사용하는 컨벤션을 정리해서 공개한 구글 C++ 스타일 가이드라고 볼 수 있습니다. 이 문서의 내용을 가져와 몇 가지 사항만 프로젝트에 맞게 조정하여 적용 하였지요. 구글 컨벤션의 코드들은 처음 볼 땐 좀 낮설었지만 적응하고 나니 이젠 괜찮군요.
diff --git a/2014/07/21/octopress-tips-on-windows/index.html b/2014/07/21/octopress-tips-on-windows/index.html index b369ca3c..81633968 100644 --- a/2014/07/21/octopress-tips-on-windows/index.html +++ b/2014/07/21/octopress-tips-on-windows/index.html @@ -3,7 +3,7 @@ - + @@ -128,12 +128,12 @@ @@ -218,7 +218,7 @@
개인적으로 Octopress를 윈도우에서 사용하도록 구성하면서 도움이 되었던 팁들을 몇가지 정리해 보려고 합니다.
앞으로 계속 사용해 가면서 추가적인 팁이 생길 때에도 이 포스팅에 업데이트 할 생각이예요.
-
+
윈도우 실행 (Windows + R) 창에서 블로그 패스로 바로 이동 하기
@@ -256,6 +256,7 @@ 1
2
3
4
5
6
7
8
cd %blogpath%
rmdir /s /q _deploy
mkdir _deploy
cd _deploy
git init
git remote add origin https://....
git pull
git check --track origin/gh-pages
+
diff --git a/2014/08/19/yoda-notation/index.html b/2014/08/19/yoda-notation/index.html
index ac16d676..845362e4 100644
--- a/2014/08/19/yoda-notation/index.html
+++ b/2014/08/19/yoda-notation/index.html
@@ -3,7 +3,7 @@
-
+
@@ -125,12 +125,12 @@
@@ -220,7 +220,7 @@
개인적으로 Octopress를 윈도우에서 사용하도록 구성하면서 도움이 되었던 팁들을 몇가지 정리해 보려고 합니다.
앞으로 계속 사용해 가면서 추가적인 팁이 생길 때에도 이 포스팅에 업데이트 할 생각이예요.
윈도우 실행 (Windows + R) 창에서 블로그 패스로 바로 이동 하기
@@ -256,6 +256,7 @@1 | cd %blogpath% |
이 책을 읽다가 ‘Yoda Notation’이란 표현을 처음 접했습니다. 표현이 재미있어서 블로그에 한 번 적어봅니다. 구글링해보면 Yoda Conditions 라고도 부르는 것 같네요. 프로그램 코드 상에서 조건문에 값 비교 구문을 적을 때 변수와 상수의 위치를 바꾸어 적는 것을 말합니다.
1 | int val = 20; |
조건문을 val == 20
으로 적는 것이 일반적인 언어 어순과 같아서 읽기가 좋지만
프로그래머의 실수로 val = 20
과 같이 잘못된 코드가 만들어지고 컴파일 에러 없이 그대로 실행되는 것을 막기 위해서
일부러 변수와 상수의 위치를 서로 바꾸는 거죠.
요다는 영화 스타워즈에서 영문권 사람들도 이해하기 어려울 정도로 꼬인 문법의 말을 사용합니다. 이를 빗대어 위와 같은 조건문 표기 방식을 Yoda Notation이라고 부르는군요. 재미있는 네이밍입니다 :)
diff --git a/2014/09/12/claenup-cpp-project-1st/index.html b/2014/09/12/claenup-cpp-project-1st/index.html index beb6816d..eefd426c 100644 --- a/2014/09/12/claenup-cpp-project-1st/index.html +++ b/2014/09/12/claenup-cpp-project-1st/index.html @@ -3,7 +3,7 @@ - + @@ -125,12 +125,12 @@ @@ -219,7 +219,7 @@Whole Tomato의 Spaghetti 처럼 인클루드간의 관계를 그래프로 보여주는 툴은 몇 번 본 적 있다. 조낸 멋지게 그래프까지 보여주었지만 정작 불필요한 놈이 무언지 콕 짚어주는 녀석은 없음. 참으로 척박한 현실이다.
그래서 한 번 직접 만들어보기로 했다.
- +프로젝트 내의 cpp 파일을 개별 컴파일 하기
일단은 만들려는 툴에서, 입력으로 받은 vc 프로젝트에 포함된 cpp 파일을 개별로 컴파일 할 수 있어야 한다.
그렇게 되면 cpp 파일마다 돌면서 코드 안에 있는 #include를 직접 하나씩 제거해보면서 컴파일이 성공하는지를 확인할거다. 그러면 불필요할 것이라 예상되는 #include의 후보를 만들 수 있다.
무식한 방법이다. cpu를 많이 먹을거고 시간도 오래 걸릴거다. 하지만 저렇게라도 알 수 있다면 새벽에 실행해서 리포트 뽑아놓도록 CI에 물려놓으면 그만이다.
diff --git a/2014/09/17/cleanup-cpp-project-2nd/index.html b/2014/09/17/cleanup-cpp-project-2nd/index.html index 2844494a..f02e445b 100644 --- a/2014/09/17/cleanup-cpp-project-2nd/index.html +++ b/2014/09/17/cleanup-cpp-project-2nd/index.html @@ -3,7 +3,7 @@ - + @@ -125,12 +125,12 @@ @@ -218,12 +218,14 @@
지워도 되는 인클루드를 찾아냈다
개별 파일 하나씩을 컴파일 할 수 있다면 이제 모든 인클루드를 하나씩 삭제하면서 컴파일 가능 여부를 확인해보면 된다. 이 부분은 간단한 file seeking과 string 처리 작업일 뿐이니 굳이 부연 설명은 필요 없다. 카페에서 여유롭게 음악을 들으며 즐겁게 툴을 만들자. 뚝딱뚝딱.
이정도 하고 나니 이제 vcxproj파일 경로를 주면 해당 프로젝트에 들어있는 소스코드에서 불필요한 인클루드를 색출해 위치정보를 출력해주는 물건이 만들어졌다.
1 | 작업 대상으로 1개의 프로젝트가 입력 되었습니다. |
이 정도 만들어서 회사에서 만들고 있는 프로젝트에 조금 돌려 보았는데, 덕분에 꽤나 많은 불필요 인클루드를 색출해 내었다. 회사 프로젝트는 덩치가 제법 크고, 아직 서비스 중이지 않은 코드여서 용감무쌍한 리팩토링이 자주 일어나기 때문에 관리가 잘 안되는 파일이 제법 있더라. 아무튼 덕을 톡톡히 보았다.
튜닝 : 솔루션 단위로 검사할 수 있게 만들자
프로젝트 파일 단위로 어느 정도 돌아가니까, 솔루션 파일 단위로도 돌릴수 있게 확장했다. sln 파일을 파싱해서 프로젝트 리스트만 얻어오면 끝나는 일이다.
하지만 sln 파일은 vcxproj 파일처럼 쉽게 파싱할 수는 없다. 이녀석은 xml 포맷이 아니라, 자체적인 포맷을 가지고 있다. 사실 sln 파일을 파싱해 본 게 이번이 처음이 아닌데, 예전에는 lua를 써서 직접 노가다 파싱을 했더니 별로 재미도 없고 잘 돌아가지도 않고 코딩하는 재미도 별로 없더라.
1 | // 솔루션 파일은 이렇게 생겼다. 왜죠... |
C#으로 sln 파일을 파싱해주는 적당히 괜찮은 코드가 인터넷 어딘가에 돌아다닌다. 이곳에 있는 놈을 가져다 붙였다. build configuration 같은 걸 얻어올 순 없지만 프로젝트 리스트 얻는 데에는 충분하다.
튜닝 : 느리다. 멀티 스레드로 돌리자
한때는 툴을 만들때 lua도 써보고 python도 써봤지만 요즘은 C#만 쓰게된다. 디버깅 하기도 편하고, 특히 멀티스레딩으로 돌리기가 너무 편하다. TPL, Concurrent Collection조금 갖다 끄적거리면 금방 병렬처리된다.
특히나 이런 식으로 병렬성이 좋은 툴은 훨씬 빠르게 돌릴 수 있게 된다. 커맨드 라인 인자로 --multi-thread
를 주면 주요 작업을 Parallel.ForEach
로 돌리도록 처리했다. 다만 멀티스레드로 돌리면 파일로 남기는 로그가 엉망이 되기 때문에… 단일 스레드로도 돌 수 있도록 남겨둠.
pch 파일 사이즈
팀에서 만지는 코드에서는, 290Mb에 육박하는 pch파일을 본 적이 있다(…) 그 땐 코드를 정리하면서 pch 사이즈 변화를 자주 확인해봐야 했는데, 탐색기나 커맨드 창에서 매번 사이즈를 조회하기가 불편했던 기억이 있어서 pch 사이즈 확인하는 걸 만들어봤다.
-
+
MSBuild로 단일 cpp 파일을 컴파일하면 이런 메시지가 나오는데,
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\amd64\CL.exe
/c
/ID:\Dev\uni\External\
/ID:\Dev\uni\Test\
/ID:\Dev\uni\
/Zi
/nologo
/W4
/WX
/sdl
/Od
/D WIN32
/D _DEBUG
/D _CONSOLE
/D _LIB
/D _UNICODE
/D UNICODE
/Gm
/EHsc
/RTC1
/MDd
/GS
/fp:precise
/Zc:wchar_t
/Zc:forScope
/Yc"stdafx.h"
/Fp"x64\Debug\unittest.pch"
/Fo"x64\Debug\\"
/Fd"x64\Debug\vc120.pdb"
/Gd
/TP
/errorReport:queue
stdafx.cpp
+
여기 cl.exe
로 들어가는 인자 중에 /Fp"x64\Debug\unittest.pch"
요 부분에 pch 경로가 있음. 그러니까 결국 툴에서 pch사이즈를 구하려면
- 프로젝트 리빌드하고
@@ -237,6 +238,7 @@ 팀에서 정한 컨벤션도 이 규칙을 그대로 따라야 해서.. 매번 코딩할 때마다 인클루드 순서에 신경쓰기 싫어서 자동화 처리를 작성. 더불어 경로 없이 파일명만 적은 경우나 상대경로를 사용한 인클루드도 지정된 path를 모두 적어주도록 컨버팅하는 처리도 만듦. 만드는 과정이야 대단한 건 없다. sln, vcxproj파일 파싱하는 것은 만들어 두었으니, 그냥 스트링 처리만 좀 더 해주면 금방 만들어진다. 툴로 sorting하고나면 아래처럼 만들어줌.
TestCode.cpp 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// system headers
// other project's headers
// inner project's headers
void main() {
return;
}
+
epilog
대충 이정도 돌아가는 툴을 만들어서 개인 pc에 셋팅해둔 jenkins에 물려놓고 사용중. 원래는 필요없는 include찾아주는 기능만 만들려다가 include sorting 기능은 그냥 한 번 추가나 해볼까 싶어 넣은건데, 아주 편하다. 코딩할 땐 순서 상관 없이 상대경로로 대충 넣어놓고 툴을 돌리면 컨벤션에 맞게 예쁘게 수정해준다.
불필요 인클루드를 찾는 동작은 회사 코드 기준으로 컨텐츠 코드 전체 검색시 50분 정도 걸리는 듯. 이건 매일 새벽에 jenkins가 한 번씩 돌려놓게 해놓고, 매일 아침에 출근해서 확인한다.
pch사이즈는 baseline 구축을 생각하고 만들어 본건데.. (박일, 사례로 살펴보는 디버깅 참고) baseline을 만들려면 지표들을 좀 더 모아야 하고, db도 붙여야 하니 이건 제대로 만들려면 시간이 필요할 것 같다(..라고 쓰고 ‘더이상 업데이트 되지 않는다’ 라고 읽는다.)
diff --git "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html" "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
index 54a92f88..7560bd45 100644
--- "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
+++ "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -127,12 +127,12 @@
@@ -219,7 +219,7 @@
예전에 트위터 하다가 읽었던 글인데, 개인적으로 마음에 들어서 부족하게나마 번역해 보았습니다.
원문은 슬랙 개발 블로그의 Technical Leadership: Getting Started라는 글입니다.
번역에 크게 자신이 없으니 부담이 없으신 분들은 원문을 보셔요.
-
+
테크니컬 리더십: 시작하기
내가 소프트웨어 엔지니어가 되기 전에는 이 직업에서 가장 중요한 점은 코딩이라고 생각했다. 그것은 잘못된 생각이었고, 소프트웨어 공학의 가장 중요한(그리고 가장 어려운)점은 다른 사람들과 원만하게 잘 협력하는 것이다.
나는 “관리자는 되지 않을거야!”라고 스스로에게 말해왔고, “그렇게 하면, 내 모든 에너지를 개발에만 집중시킬 수 있을거야!” 라고 생각했다. 내 이후의 경력도 기술 지향적인 실무자 위주로만 관리해 간다면 이 어려운 대인관계를 어느 정도 무시할 수 있을 거라고 생각했다.
diff --git "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
index 4b5e4da7..ba3c1335 100644
--- "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
+++ "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -129,12 +129,12 @@
@@ -220,10 +220,11 @@
C++에서 가장 기본적으로 사용했던 __FILE__, __LINE__, __FUNCTION__
등의 매크로와 유사한 효과를 내는 방법에 대해 적어본다. 이와 함께 나에게는 생소했던 string interning 개념에 대해서도 살짝 소개해본다. 자바 같은 managed 언어를 깊이 다뤄본 적이 없는 네이티브 개발자에게는 생소한 개념일 것이다.
UI가 없는 서버에서 동작의 내용을 확인하는 가장 기본적인 방법은 file로 남기는 log다. 정상 동작이나 오류상황에 대한 상세한 로그가 남아야 문제가 생겼을 때 파악하기가 쉽기 때문에, 간단한 동작이지만 아주 빈번하게 호출되는 부분이다. 로그 출력에서 성능을 많이 빼앗기지 않도록 기반을 다져놓으면 비즈니스 로직 구현을 위해 더 많은 H/W 리소스를 배분할 수 있다.
성능을 굳이 신경쓰지 않는다면 아래 있는 내용을 끝까지 모두 적용할 필요는 없다.
-
+
콜스택을 얻어와서 가장 마지막 함수를 찍는 방법
현재 스레드 컨텍스트에서의 StackFrame 정보를 얻어온 후, 프레임 데이터의 가장 마지막 부분을 읽어 호출자의 정보를 얻어낼 수 있다. C#으로 함수 호출 위치를 얻어올 때 가장 많이 쓰이는 방법이다. 가장 태초부터 있었던 방법이기 때문이다. 다음에 설명할 CompilerServices attribute는 .Net Framework 4.5부터 사용이 가능해졌기 때문에, 초창기 C#에서는 콜스택에서 읽어내는 방법 말고는 딱히 다른 선택지도 없었다.
1
2
3
4
5
6
7
8
9
StackTrace st = new StackTrace(new StackFrame(true));
Console.WriteLine(" Stack trace for current level: {0}", st.ToString());
StackFrame sf = st.GetFrame(0);
Console.WriteLine(" File: {0}", sf.GetFileName());
Console.WriteLine(" Method: {0}", sf.GetMethod().Name);
Console.WriteLine(" Line Number: {0}", sf.GetFileLineNumber());
Console.WriteLine(" Column Number: {0}", sf.GetFileColumnNumber());
+
C#에서 흔하게 사용하는 로깅 라이브러리인 Log4Net, NLog 등에서도 이 방법을 사용한다.
콜스택 기반 장점 : 가장 범용적이다. 프레임워크 호환성이 가장 좋음
.Net Framework의 태초부터 있었던 방식이므로 가장 범용적이다. 오래된 버전의 닷넷 프레임워크나 mono 프레임워크 등을 지원해야 하는 상황이라면 이 방법 말고는 마땅한 대안이 없다. 그래서 Log4Net, NLog 등의 유명한 라이브러리도 이 방법을 사용하고 있다. 이들은 불특정 다수의 환경에서 실행되어야 할 범용성이 중요한 모듈이기 때문이다.
콜스택 기반 단점 : 말해서 무엇하랴. 비용이 비싸고 느리다.
지금 회사에서 사용하는 게임서버 엔진은 처음에 Log4Net을 쓰다가, 나중에 NLog로 바꾸었다가, 현재는 자체 구현한 파일로그 모듈을 쓰고 있다. 외부 모듈로는 내가 만족하는 성능을 얻지 못했기 때문이다.
@@ -232,13 +233,16 @@ System.Runtime.CompilerServices
.NET Framework 4.5부터 새로운 방식으로 함수 호출자의 정보를 가져올 수 있게 되었다. 요즘 .NET 6에 대한 뉴스도 돌고 있는 현시점에서 보면 충분히 오래된 방식이다. 만들어야 하는 프로그램의 런타임을 특정 프레임워크만 사용하도록 한정할 수 있다면 이 방식을 사용하는 것을 추천한다. 게임서버는 런타임 환경을 단 하나의 프레임워크로 고정할 수 있으니, 크게 문제될 것이 없다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public void DoProcessing()
{
TraceMessage("Something happened.");
}
public void TraceMessage(string message,
[CallerMemberName] string memberName = "",
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
Trace.WriteLine("message: " + message);
Trace.WriteLine("member name: " + memberName);
Trace.WriteLine("source file path: " + sourceFilePath);
Trace.WriteLine("source line number: " + sourceLineNumber);
}
+
함수 인자에 기본값이 있기 때문에 작업자가 함수를 호출할 때 값을 전달하지는 않지만, 그래도 보이지 않게 뒤쪽 인자를 통해 호출자의 파일명, 라인수 등이 넘어가는 방식이다. 인자에 붙어있는 attribute로 인해 함수 호출 위치에 맞는 값들이 런타임에
채워진다.
과거의 오래된 프레임워크를 지원할 수 없다는 점이 거꾸로 단점이 될텐데, 사실 NLog같이 누구나 어디서나 사용해야할 로그모듈을 만들게 아니고, 게임서버처럼 특정 비즈니스 프로젝트로 사용처를 한정한다면 오래된 프레임워크 미지원은 그렇게 큰 단점은 아니다.
CompilerServices 장점 : 가볍고 빠르다.
위에서 언급했던 StackFramek 클래스를 사용하는 방식보다 훨씬 빠르다. C++의 __FILE__, __LINE__
은 매크로니까 이미 컴파일 타임에 문자열과 숫자로 치환되어 코드에 포함된다. CompilerServices 사용 방식은 런타임에 함수의 인자로 넘어가는 방식이니까 이것만큼 optimal할 수는 없지만, 콜스택을 긁어오는 것보다는 훨씬 빠르다.
CompilerService 단점 : 가변인자 인터페이스 사용이 불가능 해진다.
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
WriteLog("invalid value:{0}", value); // 불가능합니다.
}
public void WriteLog(string format,
params object[] list,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
함수의 뒷부분 인자를 사용하게 되니까, 위와 같은 사용이 불가능하다. 예시처럼 formatting이 될 문자열을 처음에 받고 두번째부터 가변 인자를 받는 방법은 C++에서 로그 인터페이스를 만드는 가장 익숙한 방식이다.
하지만 C#은 나름대로의 해결법이 있다. 보간 문자열을 이용해 문자열을 포매팅하면 된다. .NET Framework 4.6 과 함께 C# 문법이 6.0으로 올라갔고 이 때부터 보간 문자열이 사용 가능해졌다. 최신의 C#에서는 String.Format보다 보간 문자열의 사용이 더 권장된다. - Effective C#, 빌 와그너. Chapter 1.4 string.Format()을 보간 문자열로 대체하라
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
// WriteLog("invalid value:{0}", value); // C++스러워 보이지만, 촌스러운 방식이예요.
WriteLog($"invalid value:{value}"); // 가능합니다. 권장됩니다. Effective C# 읽어보세요.
}
public void WriteLog(string message,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
C#이 5.0이었을 시점만 해도 이건 큰 단점이었다. 하지만 현 시점에서 이것도 그리 문제될 것이 없다.
C++은 코드영역을 사용하지만, C#은 힙을 사용한다.
좀 더 성능에 집착해보자(?).
윗부분에서 잠시 언급했듯이, C++의 __FILE__, __LINE__
은 컴파일 시점에 이미 실제 값으로 변환을 완료하는 preprocessing 이다. 런타임에 함수 호출자 정보를 얻기 위해 추가로 들이는 비용이 거의 없다.
@@ -256,8 +260,10 @@
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
using System;
using System.IO;
using System.Runtime.CompilerServices;
public static class Log
{
public static void Debug(string message, [CallerFilePath] string file = "", [CallerLineNumber] int line = 0)
{
// ... 중략...
provider.Debug($"{message} ({BuildTag(file, line)})");
}
private static string BuildTag(string file, int line)
{
return string.Intern($"{Path.GetFileName(file)}:{line.ToString()}");
}
}
+
전달받은 파일명을 바로 사용하지 않고 string.Intern()으로 한 번 감싸서 사용한다. 로그를 출력하면 아래처럼 찍힌다.
1
2
3
4
5
2020-12-21 12:08:02.144 [Debug] [ConnectionMonitor] add uid:1 #connection:1 (ConnectionMonitor.cs:32)
2020-12-21 12:08:02.145 [Info] [Send] [20017] kREGISTER_GAME_SERVER_REQ actionId:3 (SerializableExt.cs:92)
2020-12-21 12:08:02.205 [Info] db connection Initialized. type:Auth server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.221 [Info] db connection Initialized. type:Contents server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.238 [Info] db connection Initialized. type:Game server:localhost count:16 (DbPool.cs:40)
+
interning은 입구만 있고, 출구는 없는 string pool이다. 풀에 등록은 할 수 있지만 해제할 수는 없다. 한 번 쓰고 마는 동적인 문자열은 당연히 interning해서는 안된다. 반복적으로 사용하더라도 빈도가 낮아서, heap의 할당과 해제에 큰 압력을 주지 않는다면 이것도 굳이 interning할 필요는 없다. 이런 문자열들을 interning하면 장시간 떠있어야 하는 서버 프로그램의 경우 오히려 더 악영향을 끼칠 수 있다. 용도에 맞게 적절하게 적용해야 한다.
C#에서 코드에 함께 적혀있는 literl text들은 기본적으로 interning된다. C++처럼 code segment를 직접 가르키지는 않지만, 비슷한 효과를 내기 위함이다. 그 외에 프로그램이 사용하는 나머지 문자열에 대해서는 어떤 것을 interning할지 직접 판단하고 선별 적용해야 한다. 로그 메세지에 반복적으로 찍히는 소스코드 파일명은 interning하기에 적합한 대상이다.
마치면서
로그파일에서 로그 출력 위치를 남기는 방식에 관련해 성능 위주의 고려사항을 정리해 보았다.
diff --git "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
index 598ca338..a6a335c2 100644
--- "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
+++ "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -133,12 +133,12 @@
@@ -227,7 +227,7 @@
2018년에 네트워크 레이어 성능을 끌어올리기 위해 도입했던 System.IO.Pipeline을 간단히 소개하고, 도입 후기를 적어본다.
윈도우 OS에서 고성능을 내기 위한 소켓 프로그래밍을 할 때 IOCP 의 사용은 오래도록 변하지 않는 정답의 자리를 유지하고 있다. 여기에서 좀 더 성능에 욕심을 내고자 한다면 Windows Server 2012부터 등장한 Registerd IO 라는 새로운 선택지가 있다. 하지만 API가 C++ 로만 열려 있어서, C# 구현에서는 사용하기가 쉽지 않다.
하지만 C#에도 고성능 IO를 위한 새로운 API가 추가되었다. Pipeline 이다.
-
+
System.IO.Pipeline 소개.
pipeline을 처음 들었을 때는 IOCP의 뒤를 잇는 새로운 소켓 API인줄 알았다. C++의 RIO가 iocp를 완전히 대체할 수 있는 것처럼.
RIO는 가장 핵심 요소인 등록된 버퍼(registered buffer)
외에, IO 요청 및 완료 통지 방식도 함께 제공하기 때문에 iocp를 완전히 드러내고 대신 사용할 수 있다. 반면 Pipeline은 RIO보다는 커버하는 범위가 좁아서, IOCP를 완전히 대체하는 물건이 될 수는 없다. 이벤트 통지는 기존의 방법들을 이용하면서, 메모리 버퍼의 운용만을 담당하는 라이브러리 이기 때문에 IOCP와 반드시 함께 사용해야 한다.
@@ -249,6 +249,7 @@
1
2
3
4
5
6
7
8
9
// msdn 블로그에 소개된 코드 일부 발췌. Pipe를 하나 만들면 읽기/쓰기 Task를 2개 만든다.
async Task ProcessLinesAsync(Socket socket)
{
var pipe = new Pipe();
Task writing = FillPipeAsync(socket, pipe.Writer);
Task reading = ReadPipeAsync(pipe.Reader);
return Task.WhenAll(reading, writing);
}
+
원인은 Pipeline과 함께 사용하는 task (System.Threading.Tasks.Task) 들이었다. class Pipe
인스턴스 하나를 쓸 때마다 파이프라인에 ‘읽기’와 ‘쓰기’를 담당하는 class Task
객체 두 개를 사용하게 된다. 수신버퍼에만 Pipe를 달면 소켓의 2배, 송수신 버퍼에 모두 달면 소켓의 4배수 만큼의 task가 생성 되어야 하기 때문이다. 게임서버 프로세스당 5,000 명의 동접을 받는다고 하면 최대 20,000개의 task가 생성되고, 이 중 상당수는 waiting 상태로 IO 이벤트를 기다리게 된다.
task가 아무리 가볍다고 해도 네트워크 레이어에만 몇 만개의 task를 만드는 것은 그리 효율적이지 않다. TPL에 대한 이야기를 시작하면 해야 할 말이 아주 많기 때문에 별도의 포스팅으로 분리해야 할 것이다. 과감히 한 줄로 정리해보면, task는 상대적으로 OS의 커널오브젝트인 스레드보다 가볍다는 것이지 수천 수만개를 만들만큼 깃털같은 물건은 아닌 것이다.
스레드가 코드를 한 단계씩 수행하다가 아직 완료되지 않은 task를 await 하는 구문을 만나면 호출 스택을 한 단계씩 거꾸로 올라가면서 동기 로직의 수행을 재개한다. 하지만 완료되지 않은 task를 만났다고 해서 그 즉시 task의 완료 및 반환값 획득을 포기하고 호출스택을 거슬러 올라가는 것은 아니다. 혹시 금방 task가 완료되지 않을까 하는 기대감으로 조금 대기하다가 완료될 기미가 보이지 않으면 그 제서야 태세를 전환하게 된다. 이 전략은 task가 동시성을 매끄럽게 처리하기 위해서는 바람직한 모습이지만, 아주 많은 개수의 task를 장시간(게임서버에서 다음 패킷을 받을 때까지의 평균 시간) 동안 대기시켜야 하는 네트워크 모델에 사용하기에는 적합하지 않다. 스레드들은 각 pipeline의 write task가 RecvComplete 통지를 받고 깨어나기를 기다리면서 수십만 cpu clock을 낭비하게 된다.
@@ -272,6 +273,7 @@ <
패킷을 보낼때는 데이터 타입을 버퍼로 직렬화 한 후, 이 버퍼를 메모리 복사 없이 소켓에 그대로 연결해주기 위한 추가 처리가 있어야 하는데, 이건 송신 버퍼에만 필요한 동작이라서 클래스를 별도로 나누었다. 각 용도에 특화된 메서드가 추가 구현 되어있을 뿐 코어는 모두 비슷하다. 모두 단위 버퍼를 줄줄이 비엔나처럼 연결해 들고 있는 역할을 한다.
이들 중에 가장 기본이 되는 ZeroCopyBuffer 를 조금 보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
namespace Cs.ServerEngine.Network.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
public int SegmentCount => this.segments.Count;
public int CalcTotalSize()
{
int result = 0;
foreach (var data in this.segments)
{
result += data.DataSize;
}
return result;
}
public BinaryWriter GetWriter() => new BinaryWriter(new ZeroCopyOutputStream(this));
public BinaryReader GetReader() => new BinaryReader(new ZeroCopyInputStream(this));
internal void Write(byte[] buffer, int offset, int count)
{
while (count > 0)
{
if (this.last == null || this.last.IsFull)
{
this.last = LohSegment.Create(LohPool.SegmentSize.Size4k);
this.segments.Enqueue(this.last);
}
int copied = this.last.AddData(buffer, offset, count);
offset += copied;
count -= copied;
}
}
internal LohSegment[] Move()
{
var result = this.segments.ToArray();
this.segments.Clear();
this.last = null;
return result;
}
internal LohSegment Peek()
{
return this.segments.Peek();
}
internal void PopHeadSegment()
{
var segment = this.segments.Dequeue();
segment.ToRecycleBin();
if (this.segments.Count == 0)
{
this.last = null;
}
}
}
}
+
본 주제와 관련한 인터페이스만 몇 개 간추려 보았다. Queue<LogSegment>
가 Pipeline 안에 있는 단위버퍼의 링크드 리스트 역할을 한다. Write()와 Move()는 메모리 복사 없이 데이터를 쓰는 인터페이스가 되고, Peek(), PopHeadSegment()는 데이터를 읽는 인터페이스가 되는데, internal 접근자니까 실제 사용계층에는 노출하지 않는다. Detail 하위의 *Stream 클래스를 위한 메서드들이다.
조각난 버퍼를 하나의 가상버퍼처럼 추상화해주는 로직은 *Stream들이 담고있다. System.IO.Stream을 상속했기 때문에 사용 계층에서는 보통의 파일스트림, 메모리 스트림을 다루던 방식과 똑같이 값을 읽고 쓰면 된다. 사용한 segment들을 새지 않게 잘 pooling하고, 버퍼 오프셋 계산할때 오차없이 더하기 빼기 잘해주는 코드가 전부인지라 굳이 옮겨붙이지는 않는다.
이렇게 하니 ZeroCopyBuffer
는 가상의 무한 버퍼 역할을 하고, 사용 계층에는 Stream 형식의 인터페이스를 제공하는 System.IO.Pipeline
의 유사품이 되었다. 제공되는 메서드 중에는 async method
가 하나도 없으니 cpu clock을 불필요하게 낭비할 일도 없다. 이렇게 디자인 하는것이 기존의 iocp 기반 소켓 구현에 익숙한 프로그래머에겐 더 친숙한 모델이면서, 성능상으로도 Pipeline보다 훨씬 낫고(tcp 기반 게임서버 한정), Unity3D처럼 최신의 Memory api가 지원 안되는 환경에서도 문제없이 사용할 수 있다.
diff --git "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html" "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
index a2bb2da9..aff0383e 100644
--- "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
+++ "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -131,12 +131,12 @@
@@ -223,7 +223,7 @@
프로그래밍에서 각 스레드별로 고유한 상태를 설정할 수 있는 공간을 Thread Local Storage (이하 TLS. transport layer security 아님) 라고 한다. VC++에서는 __declspec(thread)
키워드를 이용해서 tls 변수를 선언할 수 있다.
C#에도 ThreadLocal<T>
라는 클래스를 이용해 tls를 사용할 수 있지만, 막상 실제로 사용해보면 C++에서는 존재하지 않았던 큰 차이점이 있다. C# 5.0부터 들어온 async / await 문법을 이용해 비동기 프로그래밍을 구현했다면, await 대기 시점 이전과 이후에 스레드가 달라지기 때문이다.
이를 해결하는 방법과 주의해야 할 사항을 정리해본다.
-
+
알림 : 이 글을 처음 포스팅한 후 받은 피드백을 통해 보다 명확한 원인과 해결방법을 추가 확인하게 되어 내용을 수정/보완 했습니다. 최초 버전의 글도 유지하려 했으나 글의 문맥이 복잡해지고 읽기가 어려워져 최종 버전만 남겼습니다.
수정한 내용 요약 : 새로 깨어난 스레드인데도 AsyncLocal<T>
에 값이 남아있던 이유는, 기존의 값이 지워지지 않았기 때문이 아니라, 네트워크 이벤트 콜백으로 깨어난 스레드에도 AsyncLocal<T>
의 값을 복사하고 있었기 때문이었습니다.
@@ -238,6 +238,7 @@ ThreadLocal
우선 잠깐 언급했던 ThreadLocal<T>
클래스를 간단히 알아보자. 이를 이용해 일반적인 tls 변수를 선언하고 사용할 수 있다. 이보다 전부터 있었던 [ThreadStatic]
어트리뷰트로도 똑같이 tls를 선언할 수 있지만, 변수의 초기화 처리에서 ThreadLocal<T>
가 좀 더 매끄러운 처리를 지원한다. 일반적인 tls가 필요할 때는 좀 더 최신의 방식인 ThreadLocal<T>
를 사용하면 된다.
모든 tls 변수에 동일한 값의 복제본을 저장해 두려는 경우가 있다. 예를들어 스레드가 3개 있으면, 메모리 공간상에 각 스레드를 위한 변수 3개가 있고, 이들 모두에 같은 의미를 가지는 인스턴스를 하나씩 생성해 할당하는 경우를 말한다. 서로 다른 스레드끼리 공유해야 할 자원이 있을 때, 해당 자원에 lock이 없이 접근하고 싶다면 tls를 이용해 각 스레드마다 자원을 따로 만들어 각자 자기 리소스를 쓰게 하면 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
namespace Cs.Math
{
public static class RandomGenerator
{
public static int Next(int maxValue)
{
return PerThreadRandom.Instance.Next(maxValue);
}
// ... 중략
// 사용 계층에 노출할 인터페이스를 이곳에 정의. 사용자는 tls에 대해 알지 못한다.
// System.Random 객체는 멀티스레드 사용에 안전하지 않으므로 각 스레드마다 개별 생성.
private static class PerThreadRandom
{
private static readonly ThreadLocal<Random> Random = new ThreadLocal<Random>(() => new Random());
internal static Random Instance => Random.Value;
}
}
}
+
이런 경우는 비동기 메서드의 실행중 스레드의 교체가 발생하더라도 아무 문제가 되지 않는다. 어차피 어떤 스레드로 바뀌더라도 tls 변수가 하는 역할은 동일하기 때문이다. 0번 스레드가 불러다 쓰는 Random
객체가 어느순간 2번 스레드의 Random
객체로 바뀐다 해도 동작에 큰 영향이 없다.
AsyncLocal
문제는 스레드별로 tls의 상태가 서로 달라야 할 때 발생한다. 0번 스레드에는 tls에 “철수”가, 2번 스레드에는 “영희”가 적혀있어야 하고, 이를 사용해 스레드마다 다른 동작을 해야 하는 경우. 그런데 거기다 async/await를 이용한 비동기 프로그래밍을 함께 사용한 경우. 0번 철수 스레드가 코드 수행 도중 await 구문을 만나 task의 완료를 기다리고 있었지만, 대기가 풀렸을 때는 2번 스레드로 갈아타게 되면서 철수가 영희가 되버리는 경우다.
@@ -271,9 +272,11 @@ 원치 않는 AsyncLocal 복사는 꺼준다.
다행히 이 동작은 ExecutionContext.SuppressFlow / RestoreFlow 라는 메서드가 있어 쉽게 제어가 가능하다. 우선 스레드풀에 백그라운드 작업을 요청할 때는 SuppressFlow()
호출이 묶여있는 별도의 인터페이스를 만들고 이를 사용하게 한다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
public static class BackgroundJob
{
public static void Execute(Action action)
{
using var control = ExecutionContext.SuppressFlow();
ThreadPool.QueueUserWorkItem(_ => action());
}
}
public static class Program
{
public void Foo()
{
int a = 10;
int b = 20;
// 백그라운드 작업이 필요할 때. Wrapping한 인터페이스를 사용한다.
BackgroundJob.Execute(() =>
{
Console.WriteLine($"a + b = {a+b}");
});
}
}
+
작업 요청 후에는 RestoreFlow
를 불러 복구해주면 되는데, SuppressFlow
메서드가 IDisposable인 AsyncFlowControl 객체를 반환하니까 예시처럼 using을 쓰면 좀 더 심플하게 처리할 수 있다.
네트워크 구현부에도 수정이 필요하다. SocketAsyncEventArgs
객체를 사용해 비동기 요청을 수행하는 모든 곳에도 RestoreFlow
를 불러준다. (SocketAsyncEventArgs
는 win32의 OVERLAPPED
구조체를 거의 그대로 랩핑해둔 클래스다.) 예시로 하나만 옮겨보면 아래처럼 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public abstract class ConnectionBase
{
public void ConnectAsync(IPAddress ip, int port)
{
var args = new SocketAsyncEventArgs();
args.Completed += this.OnConnectCompleted; // 이 메서드가 새로운 스레드에서 불리게 될 것이다.
args.RemoteEndPoint = new IPEndPoint(ip, port);
using var control = ExecutionContext.SuppressFlow(); // 이걸 넣어주어야 콜백 스레드로 AsyncLocal을 복사하지 않는다.
if (!this.socket.ConnectAsync(args))
{
this.OnConnectCompleted(this.socket, args);
}
}
}
+
이런식으로 SendAsync, RecvAsync 등도 다 막아주어야 일반적인 iocp 콜백 사용 방식과 동일해진다. 다른 코드상에서 아무데도 AsyncLocal<T>
을 사용중이지 않다면 굳이 SuppressFlow 호출이 없어도 동작에는 문제가 없다. 그래도 어차피 사용하지도 않을 암묵적인 실행 컨텍스트간 연결 동작은 그냥 끊어두는 것이 성능상 조금이라도 이득일 듯한 기분이 든다.
정리
- C#의 비동기 메서드는 코드상으로는 매끈하게 이어져 있는듯 보이지만 실은 비동기 요청 지점을 전후로 분리 실행되며, 실행 스레드가 서로 다를 수도 있다.
diff --git "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
index 2f5cd397..64ba8ee7 100644
--- "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
+++ "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -134,12 +134,12 @@
@@ -227,7 +227,7 @@
이제 닷넷의 GC는 꽤나 쓸만하게 발전하여, 웬만한 경우는 프로그래머가 메모리 관리를 굳이 신경쓰지 않고 코딩할 수 있게 도와준다. 그리고 그것이 C++ 대신 C#을 선택하는 큰 이유이기도 하다. 하지만 C# 게임서버로도 성능에 욕심을 내고자 한다면, 짧은 순간 대량의 TPS를 낼 수 있는 네트워크 IO를 구현하려고 한다면 어느정도 메모리 운용에 대한 이해가 필요하다.
이번 포스팅에서는 네트워크 IO의 부하가 가중될 때 겪을 수 있는 메모리 단편화 현상에 대해서 정리해본다.
-
+
기본 용어 및 개념 정리
SOH / LOH / POH
가장 먼저 관리 힙(managed heap)
의 구분부터 이야기 해야한다. 관리힙은 사용 메모리의 크기와 용도 등에 따라 SOH
, LOH
, POH
로 나뉜다.
@@ -273,8 +273,10 @@ C# 고성능 서버 - System.IO.Pipeline 도입 후기에서 여러개의 단위버퍼를 이어붙여 가상의 스트림처럼 운용하는 ZeroCopyBuffer
의 구현에 대해 간단히 소개했었다. 이 때 등장했던 단위버퍼 LohSegment
클래스가 바로 LOH
에 할당한 커다란 청크의 일부분에 해당한다.
1
2
3
4
5
6
7
8
namespace Cs.ServerEngine.Netork.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
// ^ 여기 얘네들이예요.
...
+
LohSegment
를 생성, 풀링하고 관리하는 구현은 크게 대단할 것은 없다. 어차피 할당 크기가 85kb보다 크기만 하면 알아서 LOH
에 할당될 것이고.. 청크를 다시 잘 쪼개서 ConcurrentQueue<>
에 넣어뒀다가 잘 빌려주고 반납하고 관리만 해주면 된다.
조금 더 신경을 쓴다면 서비스 도중 메모리 청크를 추가할당 할 때의 처리 정도가 있겠다. Pool에 남아있는 버퍼의 개수가 좀 모자란다 싶을 때는 CAS 연산으로 소유권을 선점한 스레드 하나만 청크를 할당하게 만든다. 메모리는 추가만 할 뿐 해제는 하지 않을거니까 이렇게 하면 lock을 안 걸어도 되고, pool의 사용도 중단되지 않게 만들 수 있다. 해당 구현체의 멤버변수들만 붙여보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
namespace Cs.Memory
{
public sealed class LohPool
{
private const int ChunkSizeMb = 100;
private const int LowSegmentNumberLimit = 1000;
private readonly int segmentSizeKb;
private readonly int segmentSizeBytes;
private readonly List<byte[]> chunks = new List<byte[]>(capacity: 10);
private readonly ConcurrentQueue<ArraySegment<byte>> segments = new ConcurrentQueue<ArraySegment<byte>>();
private readonly AtomicFlag producerLock = new AtomicFlag(false);
private int totalSegmentCount;
...
}
}
+
정리
C++로만 만들던 게임서버를 C#으로 만든다고 했을 때 가장 신경쓰였던 것이 메모리 부분이었다. 초기구현과 서비스를 거치면서 메모리 누수, 관리힙 사이즈 증가등 많은 메모리 문제를 겪었다. 그 중에서 가장 크게 문제를 겪었던 단편화에 대해 정리해 보았다.
우리가 겪었던 메모리 단편화 가장 주된 요인은 네트워크 IO용 바이트 버퍼의 pinning 때문이었다. 적당한 수준의 부하로는 별 문제 없는데.. 부하를 세게 걸면 점유 메모리가 계속 증가하고 가라않질 않았다. 이건 C++도 마찬가지지만 외형적으로만 관측하면 메모리 누수처럼 보이기 때문에, 단편화가 원인일 것이라는 의심을 하기까지도 많은 검증의 시간이 필요했다.
SOH
에서는 pinning되는 메모리가 많으면 GC 능력이 많이 저하되고 단편화가 심각해진다. 네트워크 버퍼로 사용할 객체들을 LOH
에 할당하면 이런 문제를 해결할 수 있다.
참고자료
@@ -313,6 +315,9 @@
+
+ iTerm2 없이 맥 기본 터미널 꾸미기
+
diff --git "a/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/cursor_setting.png" "b/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/cursor_setting.png"
new file mode 100644
index 0000000000000000000000000000000000000000..d8a2af0054c21d6ff5c104fa45a3c73db3f5630d
GIT binary patch
literal 19238
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
P+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+iTerm2 없이 맥 기본 터미널 꾸미기 | leafbird/devnote
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 0%
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git "a/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png" "b/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png"
new file mode 100644
index 0000000000000000000000000000000000000000..d9bd76870fa3b07f8663a79642714722985c338b
GIT binary patch
literal 523706
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
pch 파일 사이즈
팀에서 만지는 코드에서는, 290Mb에 육박하는 pch파일을 본 적이 있다(…) 그 땐 코드를 정리하면서 pch 사이즈 변화를 자주 확인해봐야 했는데, 탐색기나 커맨드 창에서 매번 사이즈를 조회하기가 불편했던 기억이 있어서 pch 사이즈 확인하는 걸 만들어봤다.
- +MSBuild로 단일 cpp 파일을 컴파일하면 이런 메시지가 나오는데,
1 | C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\amd64\CL.exe |
여기 cl.exe
로 들어가는 인자 중에 /Fp"x64\Debug\unittest.pch"
요 부분에 pch 경로가 있음. 그러니까 결국 툴에서 pch사이즈를 구하려면
- 프로젝트 리빌드하고 @@ -237,6 +238,7 @@
- C#의 비동기 메서드는 코드상으로는 매끈하게 이어져 있는듯 보이지만 실은 비동기 요청 지점을 전후로 분리 실행되며, 실행 스레드가 서로 다를 수도 있다. diff --git "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" index 2f5cd397..64ba8ee7 100644 --- "a/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" +++ "b/2021/08/08/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-\353\251\224\353\252\250\353\246\254-\353\213\250\355\216\270\355\231\224/index.html" @@ -3,7 +3,7 @@ - + @@ -134,12 +134,12 @@ @@ -227,7 +227,7 @@
팀에서 정한 컨벤션도 이 규칙을 그대로 따라야 해서.. 매번 코딩할 때마다 인클루드 순서에 신경쓰기 싫어서 자동화 처리를 작성. 더불어 경로 없이 파일명만 적은 경우나 상대경로를 사용한 인클루드도 지정된 path를 모두 적어주도록 컨버팅하는 처리도 만듦. 만드는 과정이야 대단한 건 없다. sln, vcxproj파일 파싱하는 것은 만들어 두었으니, 그냥 스트링 처리만 좀 더 해주면 금방 만들어진다. 툴로 sorting하고나면 아래처럼 만들어줌.
TestCode.cpp 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// system headers
// other project's headers
// inner project's headers
void main() {
return;
}
+
epilog
대충 이정도 돌아가는 툴을 만들어서 개인 pc에 셋팅해둔 jenkins에 물려놓고 사용중. 원래는 필요없는 include찾아주는 기능만 만들려다가 include sorting 기능은 그냥 한 번 추가나 해볼까 싶어 넣은건데, 아주 편하다. 코딩할 땐 순서 상관 없이 상대경로로 대충 넣어놓고 툴을 돌리면 컨벤션에 맞게 예쁘게 수정해준다.
불필요 인클루드를 찾는 동작은 회사 코드 기준으로 컨텐츠 코드 전체 검색시 50분 정도 걸리는 듯. 이건 매일 새벽에 jenkins가 한 번씩 돌려놓게 해놓고, 매일 아침에 출근해서 확인한다.
pch사이즈는 baseline 구축을 생각하고 만들어 본건데.. (박일, 사례로 살펴보는 디버깅 참고) baseline을 만들려면 지표들을 좀 더 모아야 하고, db도 붙여야 하니 이건 제대로 만들려면 시간이 필요할 것 같다(..라고 쓰고 ‘더이상 업데이트 되지 않는다’ 라고 읽는다.)
diff --git "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html" "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
index 54a92f88..7560bd45 100644
--- "a/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
+++ "b/2018/11/12/\355\205\214\355\201\254\353\213\210\354\273\254-\353\246\254\353\215\224\354\213\255-\354\213\234\354\236\221\355\225\230\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -127,12 +127,12 @@
@@ -219,7 +219,7 @@
예전에 트위터 하다가 읽었던 글인데, 개인적으로 마음에 들어서 부족하게나마 번역해 보았습니다.
원문은 슬랙 개발 블로그의 Technical Leadership: Getting Started라는 글입니다.
번역에 크게 자신이 없으니 부담이 없으신 분들은 원문을 보셔요.
-
+
테크니컬 리더십: 시작하기
1 |
|
원문은 슬랙 개발 블로그의 Technical Leadership: Getting Started라는 글입니다.
번역에 크게 자신이 없으니 부담이 없으신 분들은 원문을 보셔요.
내가 소프트웨어 엔지니어가 되기 전에는 이 직업에서 가장 중요한 점은 코딩이라고 생각했다. 그것은 잘못된 생각이었고, 소프트웨어 공학의 가장 중요한(그리고 가장 어려운)점은 다른 사람들과 원만하게 잘 협력하는 것이다.
나는 “관리자는 되지 않을거야!”라고 스스로에게 말해왔고, “그렇게 하면, 내 모든 에너지를 개발에만 집중시킬 수 있을거야!” 라고 생각했다. 내 이후의 경력도 기술 지향적인 실무자 위주로만 관리해 간다면 이 어려운 대인관계를 어느 정도 무시할 수 있을 거라고 생각했다.
diff --git "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" index 4b5e4da7..ba3c1335 100644 --- "a/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" +++ "b/2020/12/26/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-FILE-LINE-\353\214\200\354\262\264\354\240\234/index.html" @@ -3,7 +3,7 @@ - + @@ -129,12 +129,12 @@ @@ -220,10 +220,11 @@
C++에서 가장 기본적으로 사용했던 __FILE__, __LINE__, __FUNCTION__
등의 매크로와 유사한 효과를 내는 방법에 대해 적어본다. 이와 함께 나에게는 생소했던 string interning 개념에 대해서도 살짝 소개해본다. 자바 같은 managed 언어를 깊이 다뤄본 적이 없는 네이티브 개발자에게는 생소한 개념일 것이다.
UI가 없는 서버에서 동작의 내용을 확인하는 가장 기본적인 방법은 file로 남기는 log다. 정상 동작이나 오류상황에 대한 상세한 로그가 남아야 문제가 생겼을 때 파악하기가 쉽기 때문에, 간단한 동작이지만 아주 빈번하게 호출되는 부분이다. 로그 출력에서 성능을 많이 빼앗기지 않도록 기반을 다져놓으면 비즈니스 로직 구현을 위해 더 많은 H/W 리소스를 배분할 수 있다.
성능을 굳이 신경쓰지 않는다면 아래 있는 내용을 끝까지 모두 적용할 필요는 없다.
-
+
콜스택을 얻어와서 가장 마지막 함수를 찍는 방법
현재 스레드 컨텍스트에서의 StackFrame 정보를 얻어온 후, 프레임 데이터의 가장 마지막 부분을 읽어 호출자의 정보를 얻어낼 수 있다. C#으로 함수 호출 위치를 얻어올 때 가장 많이 쓰이는 방법이다. 가장 태초부터 있었던 방법이기 때문이다. 다음에 설명할 CompilerServices attribute는 .Net Framework 4.5부터 사용이 가능해졌기 때문에, 초창기 C#에서는 콜스택에서 읽어내는 방법 말고는 딱히 다른 선택지도 없었다.
1
2
3
4
5
6
7
8
9
StackTrace st = new StackTrace(new StackFrame(true));
Console.WriteLine(" Stack trace for current level: {0}", st.ToString());
StackFrame sf = st.GetFrame(0);
Console.WriteLine(" File: {0}", sf.GetFileName());
Console.WriteLine(" Method: {0}", sf.GetMethod().Name);
Console.WriteLine(" Line Number: {0}", sf.GetFileLineNumber());
Console.WriteLine(" Column Number: {0}", sf.GetFileColumnNumber());
+
C#에서 흔하게 사용하는 로깅 라이브러리인 Log4Net, NLog 등에서도 이 방법을 사용한다.
콜스택 기반 장점 : 가장 범용적이다. 프레임워크 호환성이 가장 좋음
.Net Framework의 태초부터 있었던 방식이므로 가장 범용적이다. 오래된 버전의 닷넷 프레임워크나 mono 프레임워크 등을 지원해야 하는 상황이라면 이 방법 말고는 마땅한 대안이 없다. 그래서 Log4Net, NLog 등의 유명한 라이브러리도 이 방법을 사용하고 있다. 이들은 불특정 다수의 환경에서 실행되어야 할 범용성이 중요한 모듈이기 때문이다.
콜스택 기반 단점 : 말해서 무엇하랴. 비용이 비싸고 느리다.
지금 회사에서 사용하는 게임서버 엔진은 처음에 Log4Net을 쓰다가, 나중에 NLog로 바꾸었다가, 현재는 자체 구현한 파일로그 모듈을 쓰고 있다. 외부 모듈로는 내가 만족하는 성능을 얻지 못했기 때문이다.
@@ -232,13 +233,16 @@ System.Runtime.CompilerServices
.NET Framework 4.5부터 새로운 방식으로 함수 호출자의 정보를 가져올 수 있게 되었다. 요즘 .NET 6에 대한 뉴스도 돌고 있는 현시점에서 보면 충분히 오래된 방식이다. 만들어야 하는 프로그램의 런타임을 특정 프레임워크만 사용하도록 한정할 수 있다면 이 방식을 사용하는 것을 추천한다. 게임서버는 런타임 환경을 단 하나의 프레임워크로 고정할 수 있으니, 크게 문제될 것이 없다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public void DoProcessing()
{
TraceMessage("Something happened.");
}
public void TraceMessage(string message,
[CallerMemberName] string memberName = "",
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
Trace.WriteLine("message: " + message);
Trace.WriteLine("member name: " + memberName);
Trace.WriteLine("source file path: " + sourceFilePath);
Trace.WriteLine("source line number: " + sourceLineNumber);
}
+
함수 인자에 기본값이 있기 때문에 작업자가 함수를 호출할 때 값을 전달하지는 않지만, 그래도 보이지 않게 뒤쪽 인자를 통해 호출자의 파일명, 라인수 등이 넘어가는 방식이다. 인자에 붙어있는 attribute로 인해 함수 호출 위치에 맞는 값들이 런타임에
채워진다.
과거의 오래된 프레임워크를 지원할 수 없다는 점이 거꾸로 단점이 될텐데, 사실 NLog같이 누구나 어디서나 사용해야할 로그모듈을 만들게 아니고, 게임서버처럼 특정 비즈니스 프로젝트로 사용처를 한정한다면 오래된 프레임워크 미지원은 그렇게 큰 단점은 아니다.
CompilerServices 장점 : 가볍고 빠르다.
위에서 언급했던 StackFramek 클래스를 사용하는 방식보다 훨씬 빠르다. C++의 __FILE__, __LINE__
은 매크로니까 이미 컴파일 타임에 문자열과 숫자로 치환되어 코드에 포함된다. CompilerServices 사용 방식은 런타임에 함수의 인자로 넘어가는 방식이니까 이것만큼 optimal할 수는 없지만, 콜스택을 긁어오는 것보다는 훨씬 빠르다.
CompilerService 단점 : 가변인자 인터페이스 사용이 불가능 해진다.
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
WriteLog("invalid value:{0}", value); // 불가능합니다.
}
public void WriteLog(string format,
params object[] list,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
함수의 뒷부분 인자를 사용하게 되니까, 위와 같은 사용이 불가능하다. 예시처럼 formatting이 될 문자열을 처음에 받고 두번째부터 가변 인자를 받는 방법은 C++에서 로그 인터페이스를 만드는 가장 익숙한 방식이다.
하지만 C#은 나름대로의 해결법이 있다. 보간 문자열을 이용해 문자열을 포매팅하면 된다. .NET Framework 4.6 과 함께 C# 문법이 6.0으로 올라갔고 이 때부터 보간 문자열이 사용 가능해졌다. 최신의 C#에서는 String.Format보다 보간 문자열의 사용이 더 권장된다. - Effective C#, 빌 와그너. Chapter 1.4 string.Format()을 보간 문자열로 대체하라
1
2
3
4
5
6
7
8
9
10
11
12
public void DoProcessing()
{
// WriteLog("invalid value:{0}", value); // C++스러워 보이지만, 촌스러운 방식이예요.
WriteLog($"invalid value:{value}"); // 가능합니다. 권장됩니다. Effective C# 읽어보세요.
}
public void WriteLog(string message,
[CallerFilePath] string sourceFilePath = "",
[CallerLineNumber] int sourceLineNumber = 0)
{
...
}
+
C#이 5.0이었을 시점만 해도 이건 큰 단점이었다. 하지만 현 시점에서 이것도 그리 문제될 것이 없다.
C++은 코드영역을 사용하지만, C#은 힙을 사용한다.
좀 더 성능에 집착해보자(?).
윗부분에서 잠시 언급했듯이, C++의 __FILE__, __LINE__
은 컴파일 시점에 이미 실제 값으로 변환을 완료하는 preprocessing 이다. 런타임에 함수 호출자 정보를 얻기 위해 추가로 들이는 비용이 거의 없다.
@@ -256,8 +260,10 @@
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
using System;
using System.IO;
using System.Runtime.CompilerServices;
public static class Log
{
public static void Debug(string message, [CallerFilePath] string file = "", [CallerLineNumber] int line = 0)
{
// ... 중략...
provider.Debug($"{message} ({BuildTag(file, line)})");
}
private static string BuildTag(string file, int line)
{
return string.Intern($"{Path.GetFileName(file)}:{line.ToString()}");
}
}
+
전달받은 파일명을 바로 사용하지 않고 string.Intern()으로 한 번 감싸서 사용한다. 로그를 출력하면 아래처럼 찍힌다.
1
2
3
4
5
2020-12-21 12:08:02.144 [Debug] [ConnectionMonitor] add uid:1 #connection:1 (ConnectionMonitor.cs:32)
2020-12-21 12:08:02.145 [Info] [Send] [20017] kREGISTER_GAME_SERVER_REQ actionId:3 (SerializableExt.cs:92)
2020-12-21 12:08:02.205 [Info] db connection Initialized. type:Auth server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.221 [Info] db connection Initialized. type:Contents server:localhost count:16 (DbPool.cs:40)
2020-12-21 12:08:02.238 [Info] db connection Initialized. type:Game server:localhost count:16 (DbPool.cs:40)
+
interning은 입구만 있고, 출구는 없는 string pool이다. 풀에 등록은 할 수 있지만 해제할 수는 없다. 한 번 쓰고 마는 동적인 문자열은 당연히 interning해서는 안된다. 반복적으로 사용하더라도 빈도가 낮아서, heap의 할당과 해제에 큰 압력을 주지 않는다면 이것도 굳이 interning할 필요는 없다. 이런 문자열들을 interning하면 장시간 떠있어야 하는 서버 프로그램의 경우 오히려 더 악영향을 끼칠 수 있다. 용도에 맞게 적절하게 적용해야 한다.
C#에서 코드에 함께 적혀있는 literl text들은 기본적으로 interning된다. C++처럼 code segment를 직접 가르키지는 않지만, 비슷한 효과를 내기 위함이다. 그 외에 프로그램이 사용하는 나머지 문자열에 대해서는 어떤 것을 interning할지 직접 판단하고 선별 적용해야 한다. 로그 메세지에 반복적으로 찍히는 소스코드 파일명은 interning하기에 적합한 대상이다.
마치면서
로그파일에서 로그 출력 위치를 남기는 방식에 관련해 성능 위주의 고려사항을 정리해 보았다.
diff --git "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
index 598ca338..a6a335c2 100644
--- "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
+++ "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -133,12 +133,12 @@
@@ -227,7 +227,7 @@
2018년에 네트워크 레이어 성능을 끌어올리기 위해 도입했던 System.IO.Pipeline을 간단히 소개하고, 도입 후기를 적어본다.
윈도우 OS에서 고성능을 내기 위한 소켓 프로그래밍을 할 때 IOCP 의 사용은 오래도록 변하지 않는 정답의 자리를 유지하고 있다. 여기에서 좀 더 성능에 욕심을 내고자 한다면 Windows Server 2012부터 등장한 Registerd IO 라는 새로운 선택지가 있다. 하지만 API가 C++ 로만 열려 있어서, C# 구현에서는 사용하기가 쉽지 않다.
하지만 C#에도 고성능 IO를 위한 새로운 API가 추가되었다. Pipeline 이다.
-
+
System.IO.Pipeline 소개.
pipeline을 처음 들었을 때는 IOCP의 뒤를 잇는 새로운 소켓 API인줄 알았다. C++의 RIO가 iocp를 완전히 대체할 수 있는 것처럼.
RIO는 가장 핵심 요소인 등록된 버퍼(registered buffer)
외에, IO 요청 및 완료 통지 방식도 함께 제공하기 때문에 iocp를 완전히 드러내고 대신 사용할 수 있다. 반면 Pipeline은 RIO보다는 커버하는 범위가 좁아서, IOCP를 완전히 대체하는 물건이 될 수는 없다. 이벤트 통지는 기존의 방법들을 이용하면서, 메모리 버퍼의 운용만을 담당하는 라이브러리 이기 때문에 IOCP와 반드시 함께 사용해야 한다.
@@ -249,6 +249,7 @@
1
2
3
4
5
6
7
8
9
// msdn 블로그에 소개된 코드 일부 발췌. Pipe를 하나 만들면 읽기/쓰기 Task를 2개 만든다.
async Task ProcessLinesAsync(Socket socket)
{
var pipe = new Pipe();
Task writing = FillPipeAsync(socket, pipe.Writer);
Task reading = ReadPipeAsync(pipe.Reader);
return Task.WhenAll(reading, writing);
}
+
원인은 Pipeline과 함께 사용하는 task (System.Threading.Tasks.Task) 들이었다. class Pipe
인스턴스 하나를 쓸 때마다 파이프라인에 ‘읽기’와 ‘쓰기’를 담당하는 class Task
객체 두 개를 사용하게 된다. 수신버퍼에만 Pipe를 달면 소켓의 2배, 송수신 버퍼에 모두 달면 소켓의 4배수 만큼의 task가 생성 되어야 하기 때문이다. 게임서버 프로세스당 5,000 명의 동접을 받는다고 하면 최대 20,000개의 task가 생성되고, 이 중 상당수는 waiting 상태로 IO 이벤트를 기다리게 된다.
task가 아무리 가볍다고 해도 네트워크 레이어에만 몇 만개의 task를 만드는 것은 그리 효율적이지 않다. TPL에 대한 이야기를 시작하면 해야 할 말이 아주 많기 때문에 별도의 포스팅으로 분리해야 할 것이다. 과감히 한 줄로 정리해보면, task는 상대적으로 OS의 커널오브젝트인 스레드보다 가볍다는 것이지 수천 수만개를 만들만큼 깃털같은 물건은 아닌 것이다.
스레드가 코드를 한 단계씩 수행하다가 아직 완료되지 않은 task를 await 하는 구문을 만나면 호출 스택을 한 단계씩 거꾸로 올라가면서 동기 로직의 수행을 재개한다. 하지만 완료되지 않은 task를 만났다고 해서 그 즉시 task의 완료 및 반환값 획득을 포기하고 호출스택을 거슬러 올라가는 것은 아니다. 혹시 금방 task가 완료되지 않을까 하는 기대감으로 조금 대기하다가 완료될 기미가 보이지 않으면 그 제서야 태세를 전환하게 된다. 이 전략은 task가 동시성을 매끄럽게 처리하기 위해서는 바람직한 모습이지만, 아주 많은 개수의 task를 장시간(게임서버에서 다음 패킷을 받을 때까지의 평균 시간) 동안 대기시켜야 하는 네트워크 모델에 사용하기에는 적합하지 않다. 스레드들은 각 pipeline의 write task가 RecvComplete 통지를 받고 깨어나기를 기다리면서 수십만 cpu clock을 낭비하게 된다.
@@ -272,6 +273,7 @@ <
패킷을 보낼때는 데이터 타입을 버퍼로 직렬화 한 후, 이 버퍼를 메모리 복사 없이 소켓에 그대로 연결해주기 위한 추가 처리가 있어야 하는데, 이건 송신 버퍼에만 필요한 동작이라서 클래스를 별도로 나누었다. 각 용도에 특화된 메서드가 추가 구현 되어있을 뿐 코어는 모두 비슷하다. 모두 단위 버퍼를 줄줄이 비엔나처럼 연결해 들고 있는 역할을 한다.
이들 중에 가장 기본이 되는 ZeroCopyBuffer 를 조금 보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
namespace Cs.ServerEngine.Network.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
public int SegmentCount => this.segments.Count;
public int CalcTotalSize()
{
int result = 0;
foreach (var data in this.segments)
{
result += data.DataSize;
}
return result;
}
public BinaryWriter GetWriter() => new BinaryWriter(new ZeroCopyOutputStream(this));
public BinaryReader GetReader() => new BinaryReader(new ZeroCopyInputStream(this));
internal void Write(byte[] buffer, int offset, int count)
{
while (count > 0)
{
if (this.last == null || this.last.IsFull)
{
this.last = LohSegment.Create(LohPool.SegmentSize.Size4k);
this.segments.Enqueue(this.last);
}
int copied = this.last.AddData(buffer, offset, count);
offset += copied;
count -= copied;
}
}
internal LohSegment[] Move()
{
var result = this.segments.ToArray();
this.segments.Clear();
this.last = null;
return result;
}
internal LohSegment Peek()
{
return this.segments.Peek();
}
internal void PopHeadSegment()
{
var segment = this.segments.Dequeue();
segment.ToRecycleBin();
if (this.segments.Count == 0)
{
this.last = null;
}
}
}
}
+
본 주제와 관련한 인터페이스만 몇 개 간추려 보았다. Queue<LogSegment>
가 Pipeline 안에 있는 단위버퍼의 링크드 리스트 역할을 한다. Write()와 Move()는 메모리 복사 없이 데이터를 쓰는 인터페이스가 되고, Peek(), PopHeadSegment()는 데이터를 읽는 인터페이스가 되는데, internal 접근자니까 실제 사용계층에는 노출하지 않는다. Detail 하위의 *Stream 클래스를 위한 메서드들이다.
조각난 버퍼를 하나의 가상버퍼처럼 추상화해주는 로직은 *Stream들이 담고있다. System.IO.Stream을 상속했기 때문에 사용 계층에서는 보통의 파일스트림, 메모리 스트림을 다루던 방식과 똑같이 값을 읽고 쓰면 된다. 사용한 segment들을 새지 않게 잘 pooling하고, 버퍼 오프셋 계산할때 오차없이 더하기 빼기 잘해주는 코드가 전부인지라 굳이 옮겨붙이지는 않는다.
이렇게 하니 ZeroCopyBuffer
는 가상의 무한 버퍼 역할을 하고, 사용 계층에는 Stream 형식의 인터페이스를 제공하는 System.IO.Pipeline
의 유사품이 되었다. 제공되는 메서드 중에는 async method
가 하나도 없으니 cpu clock을 불필요하게 낭비할 일도 없다. 이렇게 디자인 하는것이 기존의 iocp 기반 소켓 구현에 익숙한 프로그래머에겐 더 친숙한 모델이면서, 성능상으로도 Pipeline보다 훨씬 낫고(tcp 기반 게임서버 한정), Unity3D처럼 최신의 Memory api가 지원 안되는 환경에서도 문제없이 사용할 수 있다.
diff --git "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html" "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
index a2bb2da9..aff0383e 100644
--- "a/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
+++ "b/2021/01/01/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-Thread-Local-Storage/index.html"
@@ -3,7 +3,7 @@
-
+
@@ -131,12 +131,12 @@
@@ -223,7 +223,7 @@
프로그래밍에서 각 스레드별로 고유한 상태를 설정할 수 있는 공간을 Thread Local Storage (이하 TLS. transport layer security 아님) 라고 한다. VC++에서는 __declspec(thread)
키워드를 이용해서 tls 변수를 선언할 수 있다.
C#에도 ThreadLocal<T>
라는 클래스를 이용해 tls를 사용할 수 있지만, 막상 실제로 사용해보면 C++에서는 존재하지 않았던 큰 차이점이 있다. C# 5.0부터 들어온 async / await 문법을 이용해 비동기 프로그래밍을 구현했다면, await 대기 시점 이전과 이후에 스레드가 달라지기 때문이다.
이를 해결하는 방법과 주의해야 할 사항을 정리해본다.
-
+
알림 : 이 글을 처음 포스팅한 후 받은 피드백을 통해 보다 명확한 원인과 해결방법을 추가 확인하게 되어 내용을 수정/보완 했습니다. 최초 버전의 글도 유지하려 했으나 글의 문맥이 복잡해지고 읽기가 어려워져 최종 버전만 남겼습니다.
수정한 내용 요약 : 새로 깨어난 스레드인데도 AsyncLocal<T>
에 값이 남아있던 이유는, 기존의 값이 지워지지 않았기 때문이 아니라, 네트워크 이벤트 콜백으로 깨어난 스레드에도 AsyncLocal<T>
의 값을 복사하고 있었기 때문이었습니다.
@@ -238,6 +238,7 @@ ThreadLocal
우선 잠깐 언급했던 ThreadLocal<T>
클래스를 간단히 알아보자. 이를 이용해 일반적인 tls 변수를 선언하고 사용할 수 있다. 이보다 전부터 있었던 [ThreadStatic]
어트리뷰트로도 똑같이 tls를 선언할 수 있지만, 변수의 초기화 처리에서 ThreadLocal<T>
가 좀 더 매끄러운 처리를 지원한다. 일반적인 tls가 필요할 때는 좀 더 최신의 방식인 ThreadLocal<T>
를 사용하면 된다.
모든 tls 변수에 동일한 값의 복제본을 저장해 두려는 경우가 있다. 예를들어 스레드가 3개 있으면, 메모리 공간상에 각 스레드를 위한 변수 3개가 있고, 이들 모두에 같은 의미를 가지는 인스턴스를 하나씩 생성해 할당하는 경우를 말한다. 서로 다른 스레드끼리 공유해야 할 자원이 있을 때, 해당 자원에 lock이 없이 접근하고 싶다면 tls를 이용해 각 스레드마다 자원을 따로 만들어 각자 자기 리소스를 쓰게 하면 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
namespace Cs.Math
{
public static class RandomGenerator
{
public static int Next(int maxValue)
{
return PerThreadRandom.Instance.Next(maxValue);
}
// ... 중략
// 사용 계층에 노출할 인터페이스를 이곳에 정의. 사용자는 tls에 대해 알지 못한다.
// System.Random 객체는 멀티스레드 사용에 안전하지 않으므로 각 스레드마다 개별 생성.
private static class PerThreadRandom
{
private static readonly ThreadLocal<Random> Random = new ThreadLocal<Random>(() => new Random());
internal static Random Instance => Random.Value;
}
}
}
+
이런 경우는 비동기 메서드의 실행중 스레드의 교체가 발생하더라도 아무 문제가 되지 않는다. 어차피 어떤 스레드로 바뀌더라도 tls 변수가 하는 역할은 동일하기 때문이다. 0번 스레드가 불러다 쓰는 Random
객체가 어느순간 2번 스레드의 Random
객체로 바뀐다 해도 동작에 큰 영향이 없다.
AsyncLocal
문제는 스레드별로 tls의 상태가 서로 달라야 할 때 발생한다. 0번 스레드에는 tls에 “철수”가, 2번 스레드에는 “영희”가 적혀있어야 하고, 이를 사용해 스레드마다 다른 동작을 해야 하는 경우. 그런데 거기다 async/await를 이용한 비동기 프로그래밍을 함께 사용한 경우. 0번 철수 스레드가 코드 수행 도중 await 구문을 만나 task의 완료를 기다리고 있었지만, 대기가 풀렸을 때는 2번 스레드로 갈아타게 되면서 철수가 영희가 되버리는 경우다.
@@ -271,9 +272,11 @@ 원치 않는 AsyncLocal 복사는 꺼준다.
다행히 이 동작은 ExecutionContext.SuppressFlow / RestoreFlow 라는 메서드가 있어 쉽게 제어가 가능하다. 우선 스레드풀에 백그라운드 작업을 요청할 때는 SuppressFlow()
호출이 묶여있는 별도의 인터페이스를 만들고 이를 사용하게 한다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
public static class BackgroundJob
{
public static void Execute(Action action)
{
using var control = ExecutionContext.SuppressFlow();
ThreadPool.QueueUserWorkItem(_ => action());
}
}
public static class Program
{
public void Foo()
{
int a = 10;
int b = 20;
// 백그라운드 작업이 필요할 때. Wrapping한 인터페이스를 사용한다.
BackgroundJob.Execute(() =>
{
Console.WriteLine($"a + b = {a+b}");
});
}
}
+
작업 요청 후에는 RestoreFlow
를 불러 복구해주면 되는데, SuppressFlow
메서드가 IDisposable인 AsyncFlowControl 객체를 반환하니까 예시처럼 using을 쓰면 좀 더 심플하게 처리할 수 있다.
네트워크 구현부에도 수정이 필요하다. SocketAsyncEventArgs
객체를 사용해 비동기 요청을 수행하는 모든 곳에도 RestoreFlow
를 불러준다. (SocketAsyncEventArgs
는 win32의 OVERLAPPED
구조체를 거의 그대로 랩핑해둔 클래스다.) 예시로 하나만 옮겨보면 아래처럼 된다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public abstract class ConnectionBase
{
public void ConnectAsync(IPAddress ip, int port)
{
var args = new SocketAsyncEventArgs();
args.Completed += this.OnConnectCompleted; // 이 메서드가 새로운 스레드에서 불리게 될 것이다.
args.RemoteEndPoint = new IPEndPoint(ip, port);
using var control = ExecutionContext.SuppressFlow(); // 이걸 넣어주어야 콜백 스레드로 AsyncLocal을 복사하지 않는다.
if (!this.socket.ConnectAsync(args))
{
this.OnConnectCompleted(this.socket, args);
}
}
}
+
이런식으로 SendAsync, RecvAsync 등도 다 막아주어야 일반적인 iocp 콜백 사용 방식과 동일해진다. 다른 코드상에서 아무데도 AsyncLocal<T>
을 사용중이지 않다면 굳이 SuppressFlow 호출이 없어도 동작에는 문제가 없다. 그래도 어차피 사용하지도 않을 암묵적인 실행 컨텍스트간 연결 동작은 그냥 끊어두는 것이 성능상 조금이라도 이득일 듯한 기분이 든다.
정리
이제 닷넷의 GC는 꽤나 쓸만하게 발전하여, 웬만한 경우는 프로그래머가 메모리 관리를 굳이 신경쓰지 않고 코딩할 수 있게 도와준다. 그리고 그것이 C++ 대신 C#을 선택하는 큰 이유이기도 하다. 하지만 C# 게임서버로도 성능에 욕심을 내고자 한다면, 짧은 순간 대량의 TPS를 낼 수 있는 네트워크 IO를 구현하려고 한다면 어느정도 메모리 운용에 대한 이해가 필요하다.
이번 포스팅에서는 네트워크 IO의 부하가 가중될 때 겪을 수 있는 메모리 단편화 현상에 대해서 정리해본다.
-
+
기본 용어 및 개념 정리
SOH / LOH / POH
가장 먼저 관리 힙(managed heap)
의 구분부터 이야기 해야한다. 관리힙은 사용 메모리의 크기와 용도 등에 따라 SOH
, LOH
, POH
로 나뉜다.
@@ -273,8 +273,10 @@ C# 고성능 서버 - System.IO.Pipeline 도입 후기에서 여러개의 단위버퍼를 이어붙여 가상의 스트림처럼 운용하는 ZeroCopyBuffer
의 구현에 대해 간단히 소개했었다. 이 때 등장했던 단위버퍼 LohSegment
클래스가 바로 LOH
에 할당한 커다란 청크의 일부분에 해당한다.
1
2
3
4
5
6
7
8
namespace Cs.ServerEngine.Netork.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
// ^ 여기 얘네들이예요.
...
+
LohSegment
를 생성, 풀링하고 관리하는 구현은 크게 대단할 것은 없다. 어차피 할당 크기가 85kb보다 크기만 하면 알아서 LOH
에 할당될 것이고.. 청크를 다시 잘 쪼개서 ConcurrentQueue<>
에 넣어뒀다가 잘 빌려주고 반납하고 관리만 해주면 된다.
조금 더 신경을 쓴다면 서비스 도중 메모리 청크를 추가할당 할 때의 처리 정도가 있겠다. Pool에 남아있는 버퍼의 개수가 좀 모자란다 싶을 때는 CAS 연산으로 소유권을 선점한 스레드 하나만 청크를 할당하게 만든다. 메모리는 추가만 할 뿐 해제는 하지 않을거니까 이렇게 하면 lock을 안 걸어도 되고, pool의 사용도 중단되지 않게 만들 수 있다. 해당 구현체의 멤버변수들만 붙여보면 아래와 같다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
namespace Cs.Memory
{
public sealed class LohPool
{
private const int ChunkSizeMb = 100;
private const int LowSegmentNumberLimit = 1000;
private readonly int segmentSizeKb;
private readonly int segmentSizeBytes;
private readonly List<byte[]> chunks = new List<byte[]>(capacity: 10);
private readonly ConcurrentQueue<ArraySegment<byte>> segments = new ConcurrentQueue<ArraySegment<byte>>();
private readonly AtomicFlag producerLock = new AtomicFlag(false);
private int totalSegmentCount;
...
}
}
+
정리
C++로만 만들던 게임서버를 C#으로 만든다고 했을 때 가장 신경쓰였던 것이 메모리 부분이었다. 초기구현과 서비스를 거치면서 메모리 누수, 관리힙 사이즈 증가등 많은 메모리 문제를 겪었다. 그 중에서 가장 크게 문제를 겪었던 단편화에 대해 정리해 보았다.
우리가 겪었던 메모리 단편화 가장 주된 요인은 네트워크 IO용 바이트 버퍼의 pinning 때문이었다. 적당한 수준의 부하로는 별 문제 없는데.. 부하를 세게 걸면 점유 메모리가 계속 증가하고 가라않질 않았다. 이건 C++도 마찬가지지만 외형적으로만 관측하면 메모리 누수처럼 보이기 때문에, 단편화가 원인일 것이라는 의심을 하기까지도 많은 검증의 시간이 필요했다.
SOH
에서는 pinning되는 메모리가 많으면 GC 능력이 많이 저하되고 단편화가 심각해진다. 네트워크 버퍼로 사용할 객체들을 LOH
에 할당하면 이런 문제를 해결할 수 있다.
참고자료
@@ -313,6 +315,9 @@
+
+ iTerm2 없이 맥 기본 터미널 꾸미기
+
C++에서 가장 기본적으로 사용했던 __FILE__, __LINE__, __FUNCTION__
등의 매크로와 유사한 효과를 내는 방법에 대해 적어본다. 이와 함께 나에게는 생소했던 string interning 개념에 대해서도 살짝 소개해본다. 자바 같은 managed 언어를 깊이 다뤄본 적이 없는 네이티브 개발자에게는 생소한 개념일 것이다.
UI가 없는 서버에서 동작의 내용을 확인하는 가장 기본적인 방법은 file로 남기는 log다. 정상 동작이나 오류상황에 대한 상세한 로그가 남아야 문제가 생겼을 때 파악하기가 쉽기 때문에, 간단한 동작이지만 아주 빈번하게 호출되는 부분이다. 로그 출력에서 성능을 많이 빼앗기지 않도록 기반을 다져놓으면 비즈니스 로직 구현을 위해 더 많은 H/W 리소스를 배분할 수 있다.
성능을 굳이 신경쓰지 않는다면 아래 있는 내용을 끝까지 모두 적용할 필요는 없다.
- +콜스택을 얻어와서 가장 마지막 함수를 찍는 방법
현재 스레드 컨텍스트에서의 StackFrame 정보를 얻어온 후, 프레임 데이터의 가장 마지막 부분을 읽어 호출자의 정보를 얻어낼 수 있다. C#으로 함수 호출 위치를 얻어올 때 가장 많이 쓰이는 방법이다. 가장 태초부터 있었던 방법이기 때문이다. 다음에 설명할 CompilerServices attribute는 .Net Framework 4.5부터 사용이 가능해졌기 때문에, 초창기 C#에서는 콜스택에서 읽어내는 방법 말고는 딱히 다른 선택지도 없었다.
1 | StackTrace st = new StackTrace(new StackFrame(true)); |
C#에서 흔하게 사용하는 로깅 라이브러리인 Log4Net, NLog 등에서도 이 방법을 사용한다.
콜스택 기반 장점 : 가장 범용적이다. 프레임워크 호환성이 가장 좋음
.Net Framework의 태초부터 있었던 방식이므로 가장 범용적이다. 오래된 버전의 닷넷 프레임워크나 mono 프레임워크 등을 지원해야 하는 상황이라면 이 방법 말고는 마땅한 대안이 없다. 그래서 Log4Net, NLog 등의 유명한 라이브러리도 이 방법을 사용하고 있다. 이들은 불특정 다수의 환경에서 실행되어야 할 범용성이 중요한 모듈이기 때문이다.
콜스택 기반 단점 : 말해서 무엇하랴. 비용이 비싸고 느리다.
지금 회사에서 사용하는 게임서버 엔진은 처음에 Log4Net을 쓰다가, 나중에 NLog로 바꾸었다가, 현재는 자체 구현한 파일로그 모듈을 쓰고 있다. 외부 모듈로는 내가 만족하는 성능을 얻지 못했기 때문이다.
@@ -232,13 +233,16 @@System.Runtime.CompilerServices
.NET Framework 4.5부터 새로운 방식으로 함수 호출자의 정보를 가져올 수 있게 되었다. 요즘 .NET 6에 대한 뉴스도 돌고 있는 현시점에서 보면 충분히 오래된 방식이다. 만들어야 하는 프로그램의 런타임을 특정 프레임워크만 사용하도록 한정할 수 있다면 이 방식을 사용하는 것을 추천한다. 게임서버는 런타임 환경을 단 하나의 프레임워크로 고정할 수 있으니, 크게 문제될 것이 없다.
1 | public void DoProcessing() |
함수 인자에 기본값이 있기 때문에 작업자가 함수를 호출할 때 값을 전달하지는 않지만, 그래도 보이지 않게 뒤쪽 인자를 통해 호출자의 파일명, 라인수 등이 넘어가는 방식이다. 인자에 붙어있는 attribute로 인해 함수 호출 위치에 맞는 값들이 런타임에
채워진다.
과거의 오래된 프레임워크를 지원할 수 없다는 점이 거꾸로 단점이 될텐데, 사실 NLog같이 누구나 어디서나 사용해야할 로그모듈을 만들게 아니고, 게임서버처럼 특정 비즈니스 프로젝트로 사용처를 한정한다면 오래된 프레임워크 미지원은 그렇게 큰 단점은 아니다.
CompilerServices 장점 : 가볍고 빠르다.
위에서 언급했던 StackFramek 클래스를 사용하는 방식보다 훨씬 빠르다. C++의 __FILE__, __LINE__
은 매크로니까 이미 컴파일 타임에 문자열과 숫자로 치환되어 코드에 포함된다. CompilerServices 사용 방식은 런타임에 함수의 인자로 넘어가는 방식이니까 이것만큼 optimal할 수는 없지만, 콜스택을 긁어오는 것보다는 훨씬 빠르다.
CompilerService 단점 : 가변인자 인터페이스 사용이 불가능 해진다.
1 | public void DoProcessing() |
함수의 뒷부분 인자를 사용하게 되니까, 위와 같은 사용이 불가능하다. 예시처럼 formatting이 될 문자열을 처음에 받고 두번째부터 가변 인자를 받는 방법은 C++에서 로그 인터페이스를 만드는 가장 익숙한 방식이다.
하지만 C#은 나름대로의 해결법이 있다. 보간 문자열을 이용해 문자열을 포매팅하면 된다. .NET Framework 4.6 과 함께 C# 문법이 6.0으로 올라갔고 이 때부터 보간 문자열이 사용 가능해졌다. 최신의 C#에서는 String.Format보다 보간 문자열의 사용이 더 권장된다. - Effective C#, 빌 와그너. Chapter 1.4 string.Format()을 보간 문자열로 대체하라
1 | public void DoProcessing() |
C#이 5.0이었을 시점만 해도 이건 큰 단점이었다. 하지만 현 시점에서 이것도 그리 문제될 것이 없다.
C++은 코드영역을 사용하지만, C#은 힙을 사용한다.
좀 더 성능에 집착해보자(?).
윗부분에서 잠시 언급했듯이, C++의 __FILE__, __LINE__
은 컴파일 시점에 이미 실제 값으로 변환을 완료하는 preprocessing 이다. 런타임에 함수 호출자 정보를 얻기 위해 추가로 들이는 비용이 거의 없다.
1 | using System; |
전달받은 파일명을 바로 사용하지 않고 string.Intern()으로 한 번 감싸서 사용한다. 로그를 출력하면 아래처럼 찍힌다.
1 | 2020-12-21 12:08:02.144 [Debug] [ConnectionMonitor] add uid:1 #connection:1 (ConnectionMonitor.cs:32) |
interning은 입구만 있고, 출구는 없는 string pool이다. 풀에 등록은 할 수 있지만 해제할 수는 없다. 한 번 쓰고 마는 동적인 문자열은 당연히 interning해서는 안된다. 반복적으로 사용하더라도 빈도가 낮아서, heap의 할당과 해제에 큰 압력을 주지 않는다면 이것도 굳이 interning할 필요는 없다. 이런 문자열들을 interning하면 장시간 떠있어야 하는 서버 프로그램의 경우 오히려 더 악영향을 끼칠 수 있다. 용도에 맞게 적절하게 적용해야 한다.
C#에서 코드에 함께 적혀있는 literl text들은 기본적으로 interning된다. C++처럼 code segment를 직접 가르키지는 않지만, 비슷한 효과를 내기 위함이다. 그 외에 프로그램이 사용하는 나머지 문자열에 대해서는 어떤 것을 interning할지 직접 판단하고 선별 적용해야 한다. 로그 메세지에 반복적으로 찍히는 소스코드 파일명은 interning하기에 적합한 대상이다.
마치면서
로그파일에서 로그 출력 위치를 남기는 방식에 관련해 성능 위주의 고려사항을 정리해 보았다.
diff --git "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" index 598ca338..a6a335c2 100644 --- "a/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" +++ "b/2020/12/27/C-\352\263\240\354\204\261\353\212\245-\354\204\234\353\262\204-System-IO-Pipeline-\353\217\204\354\236\205-\355\233\204\352\270\260/index.html" @@ -3,7 +3,7 @@ - + @@ -133,12 +133,12 @@ @@ -227,7 +227,7 @@2018년에 네트워크 레이어 성능을 끌어올리기 위해 도입했던 System.IO.Pipeline을 간단히 소개하고, 도입 후기를 적어본다.
윈도우 OS에서 고성능을 내기 위한 소켓 프로그래밍을 할 때 IOCP 의 사용은 오래도록 변하지 않는 정답의 자리를 유지하고 있다. 여기에서 좀 더 성능에 욕심을 내고자 한다면 Windows Server 2012부터 등장한 Registerd IO 라는 새로운 선택지가 있다. 하지만 API가 C++ 로만 열려 있어서, C# 구현에서는 사용하기가 쉽지 않다.
하지만 C#에도 고성능 IO를 위한 새로운 API가 추가되었다. Pipeline 이다.
- +System.IO.Pipeline 소개.
pipeline을 처음 들었을 때는 IOCP의 뒤를 잇는 새로운 소켓 API인줄 알았다. C++의 RIO가 iocp를 완전히 대체할 수 있는 것처럼.
RIO는 가장 핵심 요소인 등록된 버퍼(registered buffer)
외에, IO 요청 및 완료 통지 방식도 함께 제공하기 때문에 iocp를 완전히 드러내고 대신 사용할 수 있다. 반면 Pipeline은 RIO보다는 커버하는 범위가 좁아서, IOCP를 완전히 대체하는 물건이 될 수는 없다. 이벤트 통지는 기존의 방법들을 이용하면서, 메모리 버퍼의 운용만을 담당하는 라이브러리 이기 때문에 IOCP와 반드시 함께 사용해야 한다.
1 | // msdn 블로그에 소개된 코드 일부 발췌. Pipe를 하나 만들면 읽기/쓰기 Task를 2개 만든다. |
원인은 Pipeline과 함께 사용하는 task (System.Threading.Tasks.Task) 들이었다. class Pipe
인스턴스 하나를 쓸 때마다 파이프라인에 ‘읽기’와 ‘쓰기’를 담당하는 class Task
객체 두 개를 사용하게 된다. 수신버퍼에만 Pipe를 달면 소켓의 2배, 송수신 버퍼에 모두 달면 소켓의 4배수 만큼의 task가 생성 되어야 하기 때문이다. 게임서버 프로세스당 5,000 명의 동접을 받는다고 하면 최대 20,000개의 task가 생성되고, 이 중 상당수는 waiting 상태로 IO 이벤트를 기다리게 된다.
task가 아무리 가볍다고 해도 네트워크 레이어에만 몇 만개의 task를 만드는 것은 그리 효율적이지 않다. TPL에 대한 이야기를 시작하면 해야 할 말이 아주 많기 때문에 별도의 포스팅으로 분리해야 할 것이다. 과감히 한 줄로 정리해보면, task는 상대적으로 OS의 커널오브젝트인 스레드보다 가볍다는 것이지 수천 수만개를 만들만큼 깃털같은 물건은 아닌 것이다.
스레드가 코드를 한 단계씩 수행하다가 아직 완료되지 않은 task를 await 하는 구문을 만나면 호출 스택을 한 단계씩 거꾸로 올라가면서 동기 로직의 수행을 재개한다. 하지만 완료되지 않은 task를 만났다고 해서 그 즉시 task의 완료 및 반환값 획득을 포기하고 호출스택을 거슬러 올라가는 것은 아니다. 혹시 금방 task가 완료되지 않을까 하는 기대감으로 조금 대기하다가 완료될 기미가 보이지 않으면 그 제서야 태세를 전환하게 된다. 이 전략은 task가 동시성을 매끄럽게 처리하기 위해서는 바람직한 모습이지만, 아주 많은 개수의 task를 장시간(게임서버에서 다음 패킷을 받을 때까지의 평균 시간) 동안 대기시켜야 하는 네트워크 모델에 사용하기에는 적합하지 않다. 스레드들은 각 pipeline의 write task가 RecvComplete 통지를 받고 깨어나기를 기다리면서 수십만 cpu clock을 낭비하게 된다.
@@ -272,6 +273,7 @@<
패킷을 보낼때는 데이터 타입을 버퍼로 직렬화 한 후, 이 버퍼를 메모리 복사 없이 소켓에 그대로 연결해주기 위한 추가 처리가 있어야 하는데, 이건 송신 버퍼에만 필요한 동작이라서 클래스를 별도로 나누었다. 각 용도에 특화된 메서드가 추가 구현 되어있을 뿐 코어는 모두 비슷하다. 모두 단위 버퍼를 줄줄이 비엔나처럼 연결해 들고 있는 역할을 한다.
이들 중에 가장 기본이 되는 ZeroCopyBuffer 를 조금 보면 아래와 같다.
1 | namespace Cs.ServerEngine.Network.Buffer |
본 주제와 관련한 인터페이스만 몇 개 간추려 보았다. Queue<LogSegment>
가 Pipeline 안에 있는 단위버퍼의 링크드 리스트 역할을 한다. Write()와 Move()는 메모리 복사 없이 데이터를 쓰는 인터페이스가 되고, Peek(), PopHeadSegment()는 데이터를 읽는 인터페이스가 되는데, internal 접근자니까 실제 사용계층에는 노출하지 않는다. Detail 하위의 *Stream 클래스를 위한 메서드들이다.
조각난 버퍼를 하나의 가상버퍼처럼 추상화해주는 로직은 *Stream들이 담고있다. System.IO.Stream을 상속했기 때문에 사용 계층에서는 보통의 파일스트림, 메모리 스트림을 다루던 방식과 똑같이 값을 읽고 쓰면 된다. 사용한 segment들을 새지 않게 잘 pooling하고, 버퍼 오프셋 계산할때 오차없이 더하기 빼기 잘해주는 코드가 전부인지라 굳이 옮겨붙이지는 않는다.
이렇게 하니 ZeroCopyBuffer
는 가상의 무한 버퍼 역할을 하고, 사용 계층에는 Stream 형식의 인터페이스를 제공하는 System.IO.Pipeline
의 유사품이 되었다. 제공되는 메서드 중에는 async method
가 하나도 없으니 cpu clock을 불필요하게 낭비할 일도 없다. 이렇게 디자인 하는것이 기존의 iocp 기반 소켓 구현에 익숙한 프로그래머에겐 더 친숙한 모델이면서, 성능상으로도 Pipeline보다 훨씬 낫고(tcp 기반 게임서버 한정), Unity3D처럼 최신의 Memory api가 지원 안되는 환경에서도 문제없이 사용할 수 있다.
프로그래밍에서 각 스레드별로 고유한 상태를 설정할 수 있는 공간을 Thread Local Storage (이하 TLS. transport layer security 아님) 라고 한다. VC++에서는 __declspec(thread)
키워드를 이용해서 tls 변수를 선언할 수 있다.
C#에도 ThreadLocal<T>
라는 클래스를 이용해 tls를 사용할 수 있지만, 막상 실제로 사용해보면 C++에서는 존재하지 않았던 큰 차이점이 있다. C# 5.0부터 들어온 async / await 문법을 이용해 비동기 프로그래밍을 구현했다면, await 대기 시점 이전과 이후에 스레드가 달라지기 때문이다.
이를 해결하는 방법과 주의해야 할 사항을 정리해본다.
- +알림 : 이 글을 처음 포스팅한 후 받은 피드백을 통해 보다 명확한 원인과 해결방법을 추가 확인하게 되어 내용을 수정/보완 했습니다. 최초 버전의 글도 유지하려 했으나 글의 문맥이 복잡해지고 읽기가 어려워져 최종 버전만 남겼습니다.
수정한 내용 요약 : 새로 깨어난 스레드인데도
@@ -238,6 +238,7 @@AsyncLocal<T>
에 값이 남아있던 이유는, 기존의 값이 지워지지 않았기 때문이 아니라, 네트워크 이벤트 콜백으로 깨어난 스레드에도AsyncLocal<T>
의 값을 복사하고 있었기 때문이었습니다.ThreadLocal
우선 잠깐 언급했던
ThreadLocal<T>
클래스를 간단히 알아보자. 이를 이용해 일반적인 tls 변수를 선언하고 사용할 수 있다. 이보다 전부터 있었던[ThreadStatic]
어트리뷰트로도 똑같이 tls를 선언할 수 있지만, 변수의 초기화 처리에서ThreadLocal<T>
가 좀 더 매끄러운 처리를 지원한다. 일반적인 tls가 필요할 때는 좀 더 최신의 방식인ThreadLocal<T>
를 사용하면 된다.모든 tls 변수에 동일한 값의 복제본을 저장해 두려는 경우가 있다. 예를들어 스레드가 3개 있으면, 메모리 공간상에 각 스레드를 위한 변수 3개가 있고, 이들 모두에 같은 의미를 가지는 인스턴스를 하나씩 생성해 할당하는 경우를 말한다. 서로 다른 스레드끼리 공유해야 할 자원이 있을 때, 해당 자원에 lock이 없이 접근하고 싶다면 tls를 이용해 각 스레드마다 자원을 따로 만들어 각자 자기 리소스를 쓰게 하면 된다.
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22 namespace Cs.Math
{
public static class RandomGenerator
{
public static int Next(int maxValue)
{
return PerThreadRandom.Instance.Next(maxValue);
}
// ... 중략
// 사용 계층에 노출할 인터페이스를 이곳에 정의. 사용자는 tls에 대해 알지 못한다.
// System.Random 객체는 멀티스레드 사용에 안전하지 않으므로 각 스레드마다 개별 생성.
private static class PerThreadRandom
{
private static readonly ThreadLocal<Random> Random = new ThreadLocal<Random>(() => new Random());
internal static Random Instance => Random.Value;
}
}
}이런 경우는 비동기 메서드의 실행중 스레드의 교체가 발생하더라도 아무 문제가 되지 않는다. 어차피 어떤 스레드로 바뀌더라도 tls 변수가 하는 역할은 동일하기 때문이다. 0번 스레드가 불러다 쓰는
Random
객체가 어느순간 2번 스레드의Random
객체로 바뀐다 해도 동작에 큰 영향이 없다.AsyncLocal
문제는 스레드별로 tls의 상태가 서로 달라야 할 때 발생한다. 0번 스레드에는 tls에 “철수”가, 2번 스레드에는 “영희”가 적혀있어야 하고, 이를 사용해 스레드마다 다른 동작을 해야 하는 경우. 그런데 거기다 async/await를 이용한 비동기 프로그래밍을 함께 사용한 경우. 0번 철수 스레드가 코드 수행 도중 await 구문을 만나 task의 완료를 기다리고 있었지만, 대기가 풀렸을 때는 2번 스레드로 갈아타게 되면서 철수가 영희가 되버리는 경우다.
@@ -271,9 +272,11 @@원치 않는 AsyncLocal 복사는 꺼준다.
다행히 이 동작은 ExecutionContext.SuppressFlow / RestoreFlow 라는 메서드가 있어 쉽게 제어가 가능하다. 우선 스레드풀에 백그라운드 작업을 요청할 때는
SuppressFlow()
호출이 묶여있는 별도의 인터페이스를 만들고 이를 사용하게 한다.+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 public static class BackgroundJob
{
public static void Execute(Action action)
{
using var control = ExecutionContext.SuppressFlow();
ThreadPool.QueueUserWorkItem(_ => action());
}
}
public static class Program
{
public void Foo()
{
int a = 10;
int b = 20;
// 백그라운드 작업이 필요할 때. Wrapping한 인터페이스를 사용한다.
BackgroundJob.Execute(() =>
{
Console.WriteLine($"a + b = {a+b}");
});
}
}작업 요청 후에는
RestoreFlow
를 불러 복구해주면 되는데,SuppressFlow
메서드가 IDisposable인 AsyncFlowControl 객체를 반환하니까 예시처럼 using을 쓰면 좀 더 심플하게 처리할 수 있다.네트워크 구현부에도 수정이 필요하다.
SocketAsyncEventArgs
객체를 사용해 비동기 요청을 수행하는 모든 곳에도RestoreFlow
를 불러준다. (SocketAsyncEventArgs
는 win32의OVERLAPPED
구조체를 거의 그대로 랩핑해둔 클래스다.) 예시로 하나만 옮겨보면 아래처럼 된다.+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15 public abstract class ConnectionBase
{
public void ConnectAsync(IPAddress ip, int port)
{
var args = new SocketAsyncEventArgs();
args.Completed += this.OnConnectCompleted; // 이 메서드가 새로운 스레드에서 불리게 될 것이다.
args.RemoteEndPoint = new IPEndPoint(ip, port);
using var control = ExecutionContext.SuppressFlow(); // 이걸 넣어주어야 콜백 스레드로 AsyncLocal을 복사하지 않는다.
if (!this.socket.ConnectAsync(args))
{
this.OnConnectCompleted(this.socket, args);
}
}
}이런식으로 SendAsync, RecvAsync 등도 다 막아주어야 일반적인 iocp 콜백 사용 방식과 동일해진다. 다른 코드상에서 아무데도
AsyncLocal<T>
을 사용중이지 않다면 굳이 SuppressFlow 호출이 없어도 동작에는 문제가 없다. 그래도 어차피 사용하지도 않을 암묵적인 실행 컨텍스트간 연결 동작은 그냥 끊어두는 것이 성능상 조금이라도 이득일 듯한 기분이 든다.정리
이제 닷넷의 GC는 꽤나 쓸만하게 발전하여, 웬만한 경우는 프로그래머가 메모리 관리를 굳이 신경쓰지 않고 코딩할 수 있게 도와준다. 그리고 그것이 C++ 대신 C#을 선택하는 큰 이유이기도 하다. 하지만 C# 게임서버로도 성능에 욕심을 내고자 한다면, 짧은 순간 대량의 TPS를 낼 수 있는 네트워크 IO를 구현하려고 한다면 어느정도 메모리 운용에 대한 이해가 필요하다.
이번 포스팅에서는 네트워크 IO의 부하가 가중될 때 겪을 수 있는 메모리 단편화 현상에 대해서 정리해본다.
- +기본 용어 및 개념 정리
SOH / LOH / POH
가장 먼저
관리 힙(managed heap)
의 구분부터 이야기 해야한다. 관리힙은 사용 메모리의 크기와 용도 등에 따라SOH
,LOH
,POH
로 나뉜다.@@ -273,8 +273,10 @@
C# 고성능 서버 - System.IO.Pipeline 도입 후기에서 여러개의 단위버퍼를 이어붙여 가상의 스트림처럼 운용하는
ZeroCopyBuffer
의 구현에 대해 간단히 소개했었다. 이 때 등장했던 단위버퍼LohSegment
클래스가 바로LOH
에 할당한 커다란 청크의 일부분에 해당한다.+
1
2
3
4
5
6
7
8 namespace Cs.ServerEngine.Netork.Buffer
{
public sealed class ZeroCopyBuffer
{
private readonly Queue<LohSegment> segments = new Queue<LohSegment>();
private LohSegment last;
// ^ 여기 얘네들이예요.
...
LohSegment
를 생성, 풀링하고 관리하는 구현은 크게 대단할 것은 없다. 어차피 할당 크기가 85kb보다 크기만 하면 알아서LOH
에 할당될 것이고.. 청크를 다시 잘 쪼개서ConcurrentQueue<>
에 넣어뒀다가 잘 빌려주고 반납하고 관리만 해주면 된다.
조금 더 신경을 쓴다면 서비스 도중 메모리 청크를 추가할당 할 때의 처리 정도가 있겠다. Pool에 남아있는 버퍼의 개수가 좀 모자란다 싶을 때는 CAS 연산으로 소유권을 선점한 스레드 하나만 청크를 할당하게 만든다. 메모리는 추가만 할 뿐 해제는 하지 않을거니까 이렇게 하면 lock을 안 걸어도 되고, pool의 사용도 중단되지 않게 만들 수 있다. 해당 구현체의 멤버변수들만 붙여보면 아래와 같다.+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 namespace Cs.Memory
{
public sealed class LohPool
{
private const int ChunkSizeMb = 100;
private const int LowSegmentNumberLimit = 1000;
private readonly int segmentSizeKb;
private readonly int segmentSizeBytes;
private readonly List<byte[]> chunks = new List<byte[]>(capacity: 10);
private readonly ConcurrentQueue<ArraySegment<byte>> segments = new ConcurrentQueue<ArraySegment<byte>>();
private readonly AtomicFlag producerLock = new AtomicFlag(false);
private int totalSegmentCount;
...
}
}정리
C++로만 만들던 게임서버를 C#으로 만든다고 했을 때 가장 신경쓰였던 것이 메모리 부분이었다. 초기구현과 서비스를 거치면서 메모리 누수, 관리힙 사이즈 증가등 많은 메모리 문제를 겪었다. 그 중에서 가장 크게 문제를 겪었던 단편화에 대해 정리해 보았다.
우리가 겪었던 메모리 단편화 가장 주된 요인은 네트워크 IO용 바이트 버퍼의 pinning 때문이었다. 적당한 수준의 부하로는 별 문제 없는데.. 부하를 세게 걸면 점유 메모리가 계속 증가하고 가라않질 않았다. 이건 C++도 마찬가지지만 외형적으로만 관측하면 메모리 누수처럼 보이기 때문에, 단편화가 원인일 것이라는 의심을 하기까지도 많은 검증의 시간이 필요했다.
SOH
에서는 pinning되는 메모리가 많으면 GC 능력이 많이 저하되고 단편화가 심각해진다. 네트워크 버퍼로 사용할 객체들을LOH
에 할당하면 이런 문제를 해결할 수 있다.참고자료
@@ -313,6 +315,9 @@
+ + iTerm2 없이 맥 기본 터미널 꾸미기 +
H#%Lgn8;Q=!K7y`gRY!&5no`EJ(Z)`nK)- z(P$t*7527dtP$`N3cGPbWH}P=3Sx&38Pa9DQ;b7~>x>@27aqGsxWV1vV%*W%AoKdk zFE|ijnUM&i$@Gml!R;rptO*fw5S9o$$;#GC3)02ci2iEA8U-%!N35)2Pv1UN5zKAk zZJfevC);lYT5qZ;fCAhTC~B9a4^svw*^1-n*WC>ze41UJ7J-Ig{Q^RY3poCEk+jlC z-7NGM#g)M9UL-|PV@VIP;yr+wVB`H1sk*(oeuR2S>j$&ojn-Vm?F7!n^RnP+#M!M8 z?!yoAU(l-wxxETThYkH&s0F6O4Hh-vyd;DD)u-R>+!4HEQU{a4-61}&IPc6#Gk<&5 zxSqMckzCSlDJFLngW5J)wP_`0stZ~6F@oh!Vz}T-%;e(b=71&!81B{Ab22wxLKe+k z=VpIGfou#zLO~(1y0i|(eULAq`g;Q8UisC zb&IV9gdx~=3sH}sf9uN;)Mbw)gs>DedLgk-B(q8IA7TY)@M~ePBquTqY2n#KIk8Bo z#LN-D5_s(>HInQk9W%z+kQ|{&V*L^NJh4hexmtf~;3!te@m9vt%mIX3t>Ny>uE zBeW)H{U8Q$+G!j&%$3MIA;yBGX@|QnJVBsx*mJ#dOun(f-y5jt(8qfQ{@B%^(GJ@* z_|%{a9MWoWE=KqdL~$XM?>;zviP(bS!psku8cN?veM0O2I1bluAzcN$;Reev5&Z%1 z!Ptqg5GOOGDv3~0+L7Xs<%IZFMqI^9k)0sdMqW5EmLdO$VvUrIJdHva*d1WlA>9Fq z5}PGmPU?_WCPS rp_Hy-TS-~@ zSV^d6U4>X>r=E9$w?MNXu`pi6xG-XaVI%i5%0}E~-{y6Jq3XUed4YaG`vmWP`9%GM z{)BTLip>hgl&y&EhAqwNY@Vz9S}wW7x)Qr$bWX3JRs6Q(fD}i9wfMW0-iqIf#tOAg z0*3OqOiXQRt$Nu{-D=fpLtWKXab9KLERWO&z_|my+^|YSZF2PwIm`S>_gqC%cu6M7 zD@i&6Wx<`B$j3HP_jkAFw$e6)wk0>g x+SBVV{Ap|=F69fw^JLV%MEG9M ze}=V;I#!-Cu3g(Wa;2wAHK$jP-zgv|h$&E#Cn$0$^5tvgP~~Feapf*Em49PdU|UpA zto(kNh?^k&ZJD){x%rDomx->CZc!)ayO*Q2d8S$GbmQnvW@;V!YSl>9 wSD9>i_LK}2~(M#=011^iBvyUdwQJbipu{AQjF>|$;TH@WMKMdtckyWAE9bp_4b z%1Pl#*PQHJ!`45oSNa?+Yi^~j5-kjF_O9 iar+7DJP%3Dm7K%AKRla})+r|}lNFom zqZo&qhaL;_GYO|0vo}@C5LmNYW1eR>XAI8*r$70}li6e3`9R>H5vdT4;OF7xpljee z2+eR(u+=c<3D0o&NT0l*iOJ~9#77W*5oeFrnLkFfMNGolBdNl~z*WQhVmaV4AUehg zk&2LNh_A&pMWRV?hzC=7%vV+T&S=c279kBHn--Z?ndA+`N9AJsQp96$Qaf0#wR?R& znO}RN)S!~V*hkq!?V{SEZc=_BtCc%ZAjsvTeHMuhh$brKPEE yMtjOBIs$s!5emAL?x}3eAt)90)X#_*_rM^+Lk<+4kDr#&wk2NDZWi_!p zB|UA4WFGARdX*AaK98eS){K${;I4R`(`X^n%_Y}CPdJ*NxT#n0C2)_IZ1I~R84|2N zY&EQ)oP17OVAc@Zc2oTEuQ^P`Kpix-yH$8UNKc7Xx#Y}S3xSNmoS)ttEWG|6t9U=S z;STP8BjmN45||rIc5KGr$7o`7=jO9@y9aNFw89a*qrA!L181jYZ%Cy6D=y}C3`7hM zCNHBw^OG)h{heQ?skZlWI{6y;VIcmk?O=VVENhwvgRAZ@V{YeGr{{b0E?SS8c`fax zo0+Oe^| bxHGPrQL zbh~J{vDI7{P`o|V7?;lh!?C`G*U|cYsIkls&RKRljZzo2Iqx~{TKAme-QIk)%K_8j zas$v_+_~8K%cHz^(%juDx1`Q<=}AA`1M1A7uDO15tzb^+7t~qOnRgeb{pG#C@$1S1 z>%$UZ1DBG2qDMm$z&dB+&t}TP{Cdvp+5*bT?BdCS&sAc7;dz8Sq9*=~K;s$J{!vJA z=x}sA0v;y*C2x}Vj`C{BFJ8)IMFaZ;>q|a#kCU_Gf;q}5rYSt$Q~!r6?kQLLL+rzB zh8BIRGpBQ|r}ooJDBg7*T*fv-yRJRw%AdA&OEcqL>56(VEiNxKuP0w^la|`*DD}F% zP2b`!vOBV;9QHSS+}p1n4tZTKQ7+OpRJ%0;Hn##M2sr}T+}hm CG>DBA=~~_72bd&Gdlj*M?ov-Q7$@>HNHayqB+cr90IVON)-i zn-_=&2#C>KCh=#QAff0JBOqJ%9v~IeAk$mVu`CJ!AIa!q0T!vmSNRQZu~f7UAoKm7 zj~N0_p040Q{JPuMa3|GqP()d -xw#Ri)7tVLbtxDmd{B1L?^${2h#&Gv`P_k# zuZI{?>iRuX=iML`Km9^pR%z0Kh$78gOWHzS9)t!cLxX$)MF9Z^N}#|$5KtVDFaMB1 zKx9C1|1GP4QvIt87zjv&H3-DN%IE;^e?N)93#k3CJNUP75Gdd;6yOzB0QT?FI|bnX zmN$TTAi}Dm($c`Ys;P^)xr3{fqg#mu*x$auI7w-{f`DL<|Ghw^RmiSDK)_b5)wJBS z ?c(O7$ zx>zzYb8~YuGO;kSu+Rfb(7Sp&xEXuVJGhemvy%T^kC?fusf)Ffo3*0@(cgNFO&s0b z_(@3qHuUe$Kl^F!W&K|*Ik^67Sik`?{>@=zW?*9cpVZu}E&d;Be{=q+_K$J>vpK%M zmGP*%n!AWP+S{8uxC#8%jPw1YrT-)Izxw%4MI~!5b2}|DYoMkpa7+R$EFAyR`tLda zqo($MYO?&N=6~e;hvwfQ@Ti!(I@-DaokDd7Yc~O)+W(aN-?g; Q7F`?oA%fo_~Zj%|Kg0kVFgFiJ2}X*+Q^^g#=L)F+k&hLJ<{29R jAaWt%{uTlM|5@Z3Q3^ *Z8AURr)iij=0F^VeKVq;`~9%5X1`BEr6CA+e|yr(Q6hk7vxc zE~k2fPOF`P^7ohTt~va^9QZtLQaND6MY-_y _i++E*3e=pk?b~V wfg zi1j_!f1(i*UNWP9%gvQ1C-+(D1E+gO20)NVh|PN>@IPQJ)M}=m+>BV|wz*s1mQAp^ z>`Bqk(V@-id2Nf|^+FLU)vo-cbBf1%FeD}5c1h`az2F@ebnrM|5f}Vu`Sx;uN-Ma3 zBv4p?cBf8?3 Kk%^dF;8anO2@dB4vn^Pc z>)|Au$sV*PBk1~+? Z#TV^(XiL_!g(Zyxm&6e3>9_3kig84GYvaUldpqB_4m z2p$28l`m8;L38}{zP?A@&4>2caC|u9zPmj9u;2DQt!-9G-7~{sw@F!Odf$#9wAzbI za%+h_s3jNMw1Vgh15S5jYZvE6hIoHCLU9}}=h!I)1;uO_3~I;*472@;?A=Lqy-wo$ zxnp2)_vgFgO{_lpZa$VGH8u53EVm3@;G6{M78!8H2S$@AXJWBgYd-XVo8=f-meKuW zp4rN8lJ}BtgWI?!2b;|bdENhUoq(my?O2Yn`-a6h6%jJZq4gdE$@9Gc5XlAxz-7m0 z+0)T^S @>a4n87r#N=3Vib zPs0g@CPHQ=;c(oD9pdMRw^^u?u0T+nhsQHg6!L71gcG!915*$M&N&2fr%&!a8=spG zusLBO6aRt8j@o!N(k&$j5*^a;5b1OV{R#?BMpUoXl_(r?I2RMsJI-UV>-lX_Nura< z8kl!=cd57_SHSc_kn62P`5Bpr5b8DAnB9BTq_`03OsjXXss{>jL6jGY`L6)=LlWRI zx7IO3%^QV0EyfqcqT5{s)D?4c*f>hb6$74qd19Hhh6}AgiHFnCZA^g#f(@Wp^n0=X zL=PzCW^?kGQv!fTBc-y%sir#vP@0^;&23DE29+O3ruuPT&4URlFLrnkr?4y?7DTZl zowEF*o*M%^L;tVt5miM(BiQJ~WVym6D`+1<=RCp46%OlLND&jfvOr^n-i8hi3|)N< z9MUWaGr6jXlOT!)IFSK_J4`
u2B|XMUme0s zU8K+VEXZs2IINl5Yc`Ula33kBQ`dhS vDhgYZE}MdHz}?2Xq;AgnhG=k=zn7vF|F{vJ#ZT( z4`f8Y?@! IxvV*`A78CDN DH^Av_Z9Ix zD=AZYwb{Phr)H=_xme v(8n@LG3_f@0^>3sGCIl9If!Gd9NeYA~-ava;bw!3kSDk(3ocR)(u*>S5 zY~ra}re}IBiSLi}>`v+Tr;Br uQtjasS7(-kgx08B{+|N9@E@RXL z#(SU!9q?#f4l8%nU!nFYzT5c0Cm}& UF1+^?yt3aYa7 zWJE#I&G BW2zml<9eS*lj5VH`70t%+7W!k1{L^1Cnw=*W@JrUJX2tL0)ZQ~ z(|ZnQblI2v@gi2v$%&Tv@vAgj|B5^+Yqb(d1OGq!}DR2`8bBna-;ci8Fe@AhUeYU zjE0+I*F8nt&cSyU?;0VG{_y*-q 6UTrn)mMWa*^kq;77)lBZk>!1rOw4Kn z3+QHs9yCa6Qga&5*Bvs?+aqyhgodSArb&2$Yw$C5yfC!{r9!wUe5H_&O|FLue!OqL zt=q N8K>D?oRUZt?dPqiuzgR`~Rw79mXwbTd2zSYYZ|7cqZ>7 zihX?*y?;KMDX!3O_i#I@EQggyZ1y ?ZRCo RS1%3MNSz=SL ztP5l~aNF%_?4bsP_sb+wN$cmEeGR_L&PM`-_Tw@YF!eV@f%_7G;42o;3OZQ=?n-`_ zJF3o`8(KLGQ;2(@@p14KvN`n|DMlTm9QEU6*Q
9~%E*=#DhgPathdw-7*beckRb*qeW~6S(v33S(^zSzduQWP zNwcM(VOmfm6*LoF7$I|CdaC6J#*BygfE>7pG>(%gwrCz;(W)&PwJ#$eB^#YAEE{;v z1Imadc~0qcMt@FrcplEM%N3=hpy^s;8aNTNJIrdWt^Bf=H4N;G70|wdseN-MN5{aB zF?9ITVC>fW1>C-$Ru&xbo? ASQsPsoEG#&kv zXk@@ul+a$}h_py365h81{6jYwO~DHL6y^i8h2(eiFC}4zEv025)WTjEAruS=v>6>7 z(X!Mq4toQ&y7S?hbF-b#)WT0lJL21}p0woM@G -gzf)pbp-G_|Qsi_$IJ%AeVSJ-i~SYwS4B5D}OpHHI( zA&qG_WPx;nRno9 LJ z jxl1{c;=Y4Cz z=6<4vU8CLU69+%A^=`Ura{PAtI(@a>U+J*UbE9f(Igw?*0g2HKTVBrqK_V$O$vUs) zUd;kXxCOtNK0CoKA>;82qb$`#pH(kkrF8AjA8dM}tV1NH`)B}#aULhDG>r2!cfun| ztyO+FTRPfp@x$KZ$fM^}t>dMp wD^tn66zVyv_JYF`{`U6R;k~PA)m>T zdC}nt0eliMz*B$>^-x+`I$Tb=ez-j7TXJ%R=j8@p 9Z{MtqlJWm$cUQRVITWcuKkeKYH0l^?K zM@?bME)c1~veB(q^00(R6}X(W#jr`*9s<3l_}(wNWwCUz?l!glINjy{T4CS*>+Xzo zYHTg%ThIz@aURmm5gDWbQ^ey|C=wPSZq%kg*B3a9=@WL_H4rxPw$e>ghm>63yCY!) zTs9@;^tKBVlh4QdrP5DrC6F3@iO#?u6!OO*aEvA2O@~!PM8sl}X`Pk5FqQX&27c%q z&h@#EiU<`)R?c4d_-yZr_~hGmbvGTH#7$68Y#-PY<%#nb60JqIh85&Tg}7*B`&9yr z9c{Oe5YMpXwb!Zz@)z*LT?Rl2^oL%IT57=BWOpl}?zY?9PbGkuwy8FiN%HZe`m+!- zFEE&L(vf42Mk}^np|WKt4p-9K+q ^Advt0}g @O2&U^)aIK3~ zgRcCbS!4$D_Kbt%MxaYWL=T&vADnHUA5eDLkD-wIVw@XJ;0X9UDNN_rhxxu0&Ze*H zqzt1klZc?j(cfKRLh)?|2A)tZzzNDBN+4>4)I-4-HP>i)-Pv>C1tqX5bN}SGQCtNK z(0;n)prFRa^#>RZ#_16?R`=lUsTvb!s~TZ-0cOY5wIKrrVN;D>RqLMCQSiJ{O8v&5 zDpG34Ngkh^dy6b4bO G-r=%JFlH(rh-uC`V)!%jfNO=3jN6e2aRDafqr;1-|teC@T^(oi&99d zFyGfjWZ*6CR80Fs`r5p!3Uo^ry!u_D8)BP~wyYBwF&WD;SuMwA+g&HQBeKinTd8wt zsy$d{=dAIO*8JYChf_vv<$2xCfF~$NZ9#MWn+d*<*nG6uJI}tdj{-cso^330l|^M+ z+9Yf;pe$5ars#vNJh0qPCKenZ8{yLYJ(7Zajp{&Ujb9vBI3@R{48mKG_SK~;&5~^~ zCFYCJ@j#xthGG_zG2eurf0 Ts&TDW#!~F-P@uKtmMC3bA=I< zi#hxAJvsgc2=VJ+l9Q9oSJl?r+$&ixN2K=LD_3%`z~YHWvh=l_by8{jyY#Zz>-EKM zHPj0ye3uu)Vbaheg#UOT#2m3uY*YKmA4vP1{R;BemUzqPW158xjfqy3I*9&V1<(WM z#?!>E))KSge#7Q+65^I(7Hg>|Mi8UYINvIlA0*ytQC(|jEDL&l)1qukKE&+) Le$5LVeQN%gDBP>Np{LkTXAv1X{8%P0|&^m}k3aw5j<1JV+K&>+{K z5nr|Mtwx8}im7}>o*;PEN)9wwJV}ucz%D^0?DwH)p-|5o$%biUDyN;-Pjqr;RkY$F zX}%MjsVT0@rW%1lfX?RvG#3)6B%6GvF+jw5A{?M3=UDI=sqG^!#x0j&OPem}2=k&% zimVUK^(_)s#M K!pRg#%g+T;i$h z3Q&^eiloR4K$@WcYg4===@t}_2@u?}qKp%20kRG7n6o?taY2N@{P&>ZTsE+6AXUMv zCw1z@1{Q$qba(e9-V)i}tVRT05^<+RNRE8xO1I{EU^#2SR_zd-qhmk aGS6{5DM^aQ z#WpD>kcN@xBBv7&h+j(DIb4orIB->s_MXrcRwl;h_REOJ<0heuTG+yAY|M%vw3z6q z)@Hq=EoHymG2=S@gUE) ?)qP-r@hijm5y+uD;g};S}$QTK#t5(m}<+hhR>y#^;-}ID;n0H(c(Qzv% zW0~FzB=gl2rY}_9b0*A7ny|2H+cGty$n2T9YTf_|z`@~NBxh|Sm~UtMV7EqV+SZNA z49qox*X%Z{4`}__AGpjAc%ou{Ge}p=m$f=ScS0Sjl~EqSXXe$&QgD*s67UFqe}Q8+ zf%!yv3fd77ctkxcBO9P>fIYMKBV@$YBn`I#0f>5TA53Hqmis2-;PpMw-9?->(l~mO zwEZ#<7H3G#%97F4cTctZMEU5A>a^RxmDH?#k>* 6SEa!K)+oBOm8@pet%oWEIp4DtM z$~)%SfEZCFGI9f1)3Fzf%tYvS1?s)D#YN}!_H> GLSnI`rI58 z#pg00MNF)N^2gKr{eFqHi(#Lc0Q62&3~+VkB~C>R^*~qv={Id}e}P%1CSNEfz>M<~ zB0lkvs8I7|3j-CEwzv%IcQ1v04iAF%>*M9)&3TRFW7ar>xs?xXW7`@!&dG_3b9X2~ zw60_8*Tq_0Mg3>44 FxJ$r4qlxY+-%oR3pCN&u#72RvC!yw%p|4$a1)OE62?b zC{B0InRG)23$QxWH=p|xanqsrBvuP2t?LLve=$=6Y*F>r<3Ndo?yJJy!)a{G9AeVB zy2yKdGUP}uz>mgwX6F-WSGM@
iRU#j^}J;ndM6OwmnmPyy1IcOs{zA zMPtT(e>^ulS^W!+^>6JX;P-PjdB{I?8_3w0So>11B1z3kOG;pw`(rJYX14hWz4rjm zPAyPj7*vKsTV*kYbLCS;?i;>JnzO`<$xr;BMzNIyemSuTS?*s+yFlo`w7PF6dBc*2 zBal8Z^_rrPfp38#oGwYnDfIynp|DkZa^@iz)hNG4G^q =3k8P5XW{d}@8Wi7#yp8WG4-y<=#gVOY}O5Ii4e1SvPeD0`wN`^-F zrL@Vv9L@j=2c2rnZU8>~iJ17f5%ITR_#YT_d+40Rznnwk9>U%n*Pdw4x4acQeq6)s zWX`bDujr~L_8Lz^xVWrYnoZCn8Rk9# cHv7CUAk#AfD%)aoilV0p>JNkGF#qrc=jd}F<%zD_(QjSqV& zE7Y4u$wSL&Rptabg* N`6G+Pd4R*GNKdTBiH##XH0 xukicqmks6!M!>tL*bZiHE!M)zYHuNcTw{m2`jNW*uS z??GIPPWgt6M7V*Jh({XJ=iC;|kt7a$Z9qUA(V7Hq69(Fq55?iAve%K9I=NWK?&D)* zR6xOGdiaSOBFi(0_o0jlqz#g-(O0_>(ISU_-Tr(UHs4vuHPX=1@?iyy-+1W5>Mw5d zzwGpGG#UK1e>#*RX!&5*H$}>G=_QB#{&HXHygTGA!^Ru>=g4*=OYR}@2qXOK?dLFo zzgj%Dv+Hy-K&XdVY@po~7d3wHPp2j4!bE-l#Q2IH?SL|~R3yrUh0>p}NI8Q$MkIV5 zt21->#4zNqS)%N7b}`k~)?&3U26#$m>sozLNq5)igwS3+2OC1a3wlG%`s=najpu#a zHnSJYMu3jqbQJ$#e9tR}cT$1}5h;vvG8##8>?MxcRVrKmI3l2NN8;2|VI(4AKQ{9F zn{rQ9hc6f}>^E w}vWqXgilr@;hN&7<7E7<% zA}PP<{3-Vn2^ob|&9I^IU2PvW_uP!fwAuA6Dsw+w49n-3i3-|9OmK<#UQr iWNqC5@ur^Ytj5KuN-J<2Xh0uVaZ; z+2TYq$^a-8b6&cQ(f)NTrBbopSBo(MrI~C`p8eFnjwP9t%op_{%;4$8@UO@I&Uk@7 zK5b{rzYonFv`k@1vjeoH<$tOzV*S?5b8;) _Yy<~Hwh3NOF zXgaZOl&_+x)(zD#`onHFt>nSbb9veAxWB?$EOKMSSRMNcBn6LY7fZ}?;8clcBBw=b z-o3sMdVf#ml-5k?b$$(nGW<>1!mqEaJUt+tY_-(`XSM!vPdxZNZoCKghXo)$J8ZeH zjexObOT=d<>Y8}e)rUxOAyUTFNmXDUXG})?nTnHl*Q@-?!)qmfR0aBV|HX@lfE%?y zA%P>bf^lagdNH%t#0fi)FdYi+F&&QI2jeK{yK(QOgtL0NJ9b-lU;5$(|52r0trand zvwThbD*9WV 4JdzdAp|9`c=!foUwT2a`lM#3{(~tj4p#NzvN4zw{Vr99lY}5lf zzu?EtHk l{}i=isy1SUwShSYB2I}o9C7(4 zxol}vN*GLafWv%6QY2^q)7XaB&Et~Sr$y{}3biVH0yJF?RiX8qK~a6{aot`t6u=;h z4GQtB{F%^i#8|eSm@i(6IWkhQE*FMx!J{zO<`A0XqL~eHsfcVN4k;IXI<-RJXI*_E zoWv;N9^U6L5dt)A8+vA Qf3q`DhaH_p(W^Wa=9>D^Zedla%2 zK}xc~9;Fz-8T+lQj-ZcrU34JI>-RiX&On5~pewx &+k1&`a2 z`&zw^{2kE?YKQwNhw3uCO*$4ZaORLYTTrSLzB~R}BDgE|#{M#2u~iLhy@=(l$U3g0 zVmw0f75B^;&T7NO>-9*+w-$n OWfT?V^}Km=ta2lp)A0cCo1}7r5r-{OBDN)2Wdc0ScByVq?1l3+ zdvHwb@WyCV?pfFuRn6(~a&wau0ZSQAFn|vo4P)BAd0m25qXrqJSR(i3?1u|TI_%cT z_?H)!gV)u&QzBJq=P6eAjKxqS0kQJD6?t*_Y);EB^Roby#w{Q}Jy)L3Kq6 7%q$`f=b|^`sC%n3fnK=Lg4?|en zW{35ovFf@M>NFrrnY~!AJ2gktJae@gKBvv^>k|goF~+>{DfOcKjO7KB#D?t={p~HR zqoE(pLjd}mcnR&N*R@HXVr(v7g3!$C7Bq>;iE!rDsR%j>JN0IECcL~-a31~1H>IIm zU2fX`a>K&|xdG3^PTC3fZUXt?6F-tQ1Wr9h!N(-E8m25(OODR>#ZRh3FGTmVdFA;U z;}s|$u`>B=2_Ql%%wKwwLt6U;S;|mU$`|lQ6QkpA!3 e1Hl`n7dIn=;!rdvfLAxQZFXuFE&GD+~!hpzp2Ptg(Z+jP=0 zEm-Gr0f2Muo36qBfq|u?quUEE*>yo9(*R&gbP+jxQ}=ri$Jnll+=xce`E`cNlb0@= zuIB<1hs7 kAxXlTGLQ!)gvA9-g#|Y#s?2L@{GU zEPNAn;FyZO|1zy-Gp(EO!(Nsi`|^4Y&4N7;%OolM&WEv199^q{Ul=*bM%g`69f3ES zXP<5<=~=!dQ3C8Z?kfsPpNBQ0IWNWqGH+ZfW-#SNE$C{z8HKgDpK1tvxjTQ=>{G;! zReCTw?+5y3R5b$XM{phWaRa~`c8`IpYtMSRN3}kD&q0ZcW~wkfrg8QJ;xQ6+W)>^< znUp$(2xSxEd6^?iILCTTK)f3jC-gf{c}J|;{60~Q@cWC~Xlc4uYP95i->>YzRXJQv zyAlTdHl=J1dpi@c-q=D6dfn*ktfkckXHx&q^+$%!pv2G7f~YMUA)76+*;xCLP_y0) z!vJkrI1IW50Vk_KEW_kkmDsbG?Mmt?WnJ-Vy}H52vvu0%uv~WUH+cTcjH}@z8VzY` z>~Ob*MQVIa^M)usKqlSMrdqXw4g3L&_a4ZYf)nImpVCx#UxZFkho@ 8C$B^S zE}Ob<%Y VvCoY84If^!p zD_#rK*Qhd9{b3=0JY}K>62tf{`I|XA0vd8}twCp7Bf-P%R5#P0x2#7(>CKvCP9#>5 z A^I8?6QiCdp6Mny)Hw>qhMvS zt>6z@ndD@O1C@TC%*trhV!IK;&e*}03Jdjvj+v3+MNCXiqMY|@eQI3{QQ+_6Lls@s z^^Wl(7RyvWso0B_5*d6I9C46NNfW`kLLv#?KUn~X4QOJtGk9EV4CcP-6 2_;P qQW62b1M67{KdA zr2lSlkR2?F%??e!F%m{I{A)F;6XYfOXw{g|pm-?GJ4z>OKAeTT_dN>BICqbMmO=bB z?k7}en1wwRO>H4_#w$*u`o>U2F!!Pp)0a!lV1Rmo73UvNwWG~vAZhr0XTi2YG~%I5 z&X27Rv}=_%?0OLhYIt#RLQRhqDbx&d+d6nkFfgSkh*2lojd0jWFJ~=7Oa`ISyp36z zF#I%ggjHL2N<>{E5b=+zXzTa5yMCc#D0lkYTaP3Xhvi G^vV (jcMUm5(3}~S+#?yDE7Zs6~pFBhXOc$bMF*G`~F64vxS!sWX%YM zNbL>Q!vy;M^ZZVvt?@PQl(B _Fg9&l77ImF;|KXo;2(Dr7TaFbSKNVkH4k!nzQFT$kA*bpLw zhVgPf?lm~UGEqSkCZ)eM-c@G8fl||chJs_Mm=NlB6^rVCN-I$yk-g#~SKh1wjIYz8 z{-NHj)&z{X!?Ncto71HR!l0Uz 9`wMUGxHjc4AR4n 7(5gejsc8*?<+I|RCy;dhfkdeg3>z{iq-a8L5PR|aV^>oGpOdJ zLIGo-Y?=P?b&4U{EUz*N;mvxJ1o6FNy6ieGCKLAa)#I2ihrJciu~Ixx$#N0x`g;BH z 32{Z7KLY1T3z^i?&yX)u!|HW<|8GD?AcCH^89V)Vp{>!R;{9%~sd+ zy>U^bI38o|ZIrFZGHd3ga6=%2g4_r)GNt`sE#DG_bC@4DSJo*8e2RBHAD1=RAIS-V zg+)ao<6Q#P#RMPqfuqv9%gf6t+1a+OmAF)R`rl2y0OLLN-NvZPscc(6-fpLWj(PYQ z1VNxxXA+@0?my~+l#`Ss4K%0B&3SpX9du{j;QR?UAfZ?e%?_upb9OfrZv57NE;$Q! zgr(7G+no|P$O7$S+lW$Moh#7giRkbGl(lpoXDdPsx@R2vAz HBvJ1BsMUp8=i;CG2EJS~ED?F(IBl`f;jNJYd{fLJ3BC!%;jp8S^cnXLA-D~n zdny5c4&)aSkHM-Ga>iizODOW+vsGh8mY=p@*f0IU2io+}0#94uID=n&PUbC-o8}a% zr`aHA@W!NkADTXyfFljPs?O8kS8}HO+709ejUlnG;TB5BhNu0(wT0uXaWoSOX{4D` zl21`+oEzG^dsRzCNf{aQ7wZifvtn_bYfH}_-&!S2tTsAYqh;zU3a8ORqGDn! XMZvL1i%sd}HCi&_Wl0WUI8y0d}Ot`=Uruc5< z`lcp3K3?Q}&VMddNGDTxOj6bYx!j6GK>*1|u_PY5@eTFuJ_W^)GbT)`f5DQXz;jq* zW24n{K@1i3Ooch%A=|MF0C<0Wd_?{#fD37F CvrI0%IxU^P`4n4+kR@wEq2(eYAmATd|NOLK})StBPLdm(lvy zyimrUr}Je7miH+2N)5*jdEOSV_eaj*?dbISZ7E7WT5%UP!zgO1D#K^-OHTn~y2g-B z-D9f-zXZCcp2IBeJsvRO0k^le$3wV|HyFpa-cMJ7&o###;OO69?sIbN#!TGLxYu;J z!VMRhS6ZBly%16(+qFF@;32D1MlDn@_Ao0XpCfgUlwEdddI1Vf73@1#8+r9i+jC%b z2%^53cX#jvLRj*dd@SDg3!1)EgMJUomg0=NUo0jL2}FOCO&k?Q5V$orUKCofFWP!5 z>ggS8lP+x9ZFcc@UiIB-c&$~G+4YA%g!0- +-MJ*2@7`#IubZk zaojZA`ScJi*f(!7kQNvyERqUXU}GOQ`Apc1Uo=m2Yd?NCsKr&)UGWB&^8x>b;D9k> zcb!kx86p`M7Qo0)8_&bxhJL~rKwpHO?WINm5$attQ%snqJU6E(7#EI2=pdab_zC{< za$2t)>WtrZR1`z^D&(L 4wrD7!GP_I=pOuHc}1O|cq! zu14FnO0%9oUAA_Jhrw0_VbK)^KMiXu>tToOIpc3wLlAWvNN)x{ug5IVJ4X(!Lp7dW zza?DA>OJs8SEb+ni=2j(G_>42O>1h#X;+Kn;haF$GdEudTdzGXGhdPS!TaIaW+}2T z$sdI-mbF#-g>EUl5E(~=2`5T8{Z?zAEi29@=pc^M;yP#3O=CtYwM;Ja_t&a2^l}>o z9Sjam)1la(-w`IOeB4b_9;{xJSA($ilKbcD_Gw~02$WAno=>B2jCN1gQBiiRC(r&@ zH|P4#_Swhry9uEcO;!}?<`itsLI{gfs-y=YjY V)Or&*a9aqY> z3N1~wj@=NpHcgu`5mX(bb!-mE)Sdm@f5!dvdT>3uUf OphnA6BR_+t8!;NBjr;+eWFVMSQX8= z3mJ#uFbj&_*u@6}!HA-q1`C}oNAu$5>f#{$o3j@>S3&$Zo{rX@r$PG;Wl<=o4_ DMwjIyEWtgI|GD$sW9@KluAH1Dcw{xE3>y@?29&mmkIN3l4nzfl>6{JXpot9^Zr z{|dH5q (h_D+{aE;+pM z+z=l-Wzf3zHt0j0mID-R#Z*X6S0Kv*Rx1E6b6;!{VmHWiP=(A`Np-G1Nr9gg*)XZ? zd5=k3WB#$MSo!%!bBIksA);RL#3*(4+_QC2Oq2RXQzzl=cQ2#uZ`A9E{mHkhadgP1 z#zhmwsd*O^D%a62Qx7@W0DPLxw?_-iNH*8l#^?mpCLQrJ;qJ(=X#GqNE`5BLaVVc= zi{c_0aXS0#plz-YDGR$QvVprti;4`fcO0Moj}o@V^y3Q*a6mzFf2gx}SGxRFC05;R zxRnMJ$gAx&!CqE1mg3J#Lf!)S{kJQR)Tmb|yR@<6x38d&Opjte=bCu^@G(Iyz#FUE z)`fCo<>G{On 3QY35w=1vT93Y}w$HHT`fM@&!aogwYeY8g ziW#*J7~TTBq})V@5*_-L%QP2wN1$xRTJS|+d2%7cf;Cefp;AWGp^q1P2s2j;3)-vB zVOAnzSvhV;^VX6Y%1Wnob#-}-mz dQi^c-){|z3`~g! zDdu4$G-42595&&tHCTE5=)wp_`r(Eu{^1Fnb4Ym*M)ysg_Scigq$u@kn!+YiHJKQn;TxYc<3=X2oxoJbh zb-#W;r|MfuzSOmMb|h3~@sbC?5Q1fo+o+T^6BtMx5k;dJedU!{_PVs{Pw>U0{P8#= z*MK{wG+-J#Q4x(-9w-x_Uv$MBQrG2eE(|K=oBhpt_TT%KB)-9Cn-;OGm3rww^6Bey z-2CefFV}96eBqP6kyKUo aD&ALL2OFw<^Yewt<}_?20fS*m^SIWWjdJ&G Lj>l8 z0t|C_&29qgI%7CqCgyslZiya86>&pOct)zGe&Gbd++LQk+!exL@H)p6!t|NV D#JT=T3E0NY36#q+D~sB!hzEeH*QDu|!zk 9y?o8@|Wq3 P+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + iTerm2 없이 맥 기본 터미널 꾸미기 | leafbird/devnote + + + + + + + + + + + + + + + + + + + + + ++ + + + + + + +++ + ++ + + + + + ++ + + + + + + +++ + + ++++++++ + 0% ++ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png" "b/2023/10/09/iTerm2-\354\227\206\354\235\264-\353\247\245-\352\270\260\353\263\270-\355\204\260\353\257\270\353\204\220-\352\276\270\353\257\270\352\270\260/mac_terminal.png" new file mode 100644 index 0000000000000000000000000000000000000000..d9bd76870fa3b07f8663a79642714722985c338b GIT binary patch literal 523706 zcmaI719WB0wl*Bw>DabytK+1TPRF)w+qOFF*tYEsI<{@^f4}d+J>&oGxoeEIt5#Lb zs$H`tYCg4Agpz_3A{;Ip2nYzGjI_842nZxL2nhHm3>2_Lf6=KG1O!3ILQG6aMof%Y z$knJG6%C7-p_kV!W_9C`3{4CPV_R@K+dy`%UX$a$#x~sK7`9op1IR zq+p!RYT|ug8^~NShc>a`X~)|&YU%7$gqM8|yzYFQj(PyuFEbfVW|v*y{;LkL(#cWf z;PF)SC?imB3rVUfCqx_pja`OJi?3z?KL%WW zUqLJoa@<{KT|qA7U2u@?MePLOe=kVp%F-lGG}H)4#fE~pA*Gp4-m|1pNZS)&&3e|r z9J~ObF0<#}l>_<4B$BH;Iu(pt{(-^==K)3nV(A?2b9+m9N30OEg1Z_{oO;SO?>9U4 zo@M%4OBt5L6Mf*6fKd!0(oLPl_5qL^0Wf;BC6W-O)|MMbh#3|;g?e;ku<^)6su5qJ zmq ?ED>Z`&TtOMY z2vk7-QoBd86ylC5B*d&>&>+LlqrL-gGl|lW4);kfMSn;4;G&n9)cftYXL`2*<2Bt< zS=}3L@Jsj fod>%ShNiB|6@=zpxJ*uo>@lBQ({sb1(+r&d%KZ1i&Wq&t2 zlb?C_N(ntEpGv?JhVf9?=v`2g6Hoo~j&`lAHwl}8bXZ; pxZf)UOGzY z> frZf19jgfXq@^@(Ldq%*ATn>C{T_&UE-Wyxz8C;`9q_(i8gs^9Su6$YQMe# z1cU~C&C=sxzcVM2#5p&S$Qlx}_+yJAkgjgOwjy7Kgbh>>RVr|UKVfH%xOw%Xi(>7N z?BM>)vbRdi*LYV=M$N}Ng{E;#_%vd)m;H4T`L?&IL_oX8+bUQ)qLWWVc?mDjA(~no zu9b=Ls<`Tx)rYJoW+3HCUbv5HEL8t6L#Ae 2&V$PI^VRt(eqZ2x?Vt-mVd!p(bqB&jgk?jp;}rIhTW T0R!F(!HkSF9_)(2ZEu zdRAfx9?@xVErt0EMsOpR?mgN=hHb-gW90?T45w|UJR^0Y+Ktp~BVYTz;{|+WCSF11 zhqV@EB}rmVQ4*!5vL?eP&kpn|3%ib$CO<`~3cs{xDnV(8U<;QGKZ`&d+#6)vCEEpw z5T7Uelh7%nOpa9M|4md=YE^<)vR&?!#79X*omJgY1y1Fw8X7GIT?*aBH{NpRA17t= zX7#*(0?%b)N$*A%#wJF!#;W$C_6cvzBB6#NcjY5Wja3hoX{jHQRg*iCxyHxGOU4Pu zS;oN*+Qu=)y^?2Wg_J&j6_goP^sC_1kShNuuh%(f9cM`4`bN8$cq%1djH#5SVpT>} z_Ebjn&7vHs+*&R76n~L+QF3vjoM~~?64O$yDZ*01^1$+Kk+J-tENPKp@y99t!=F>N zQ-)Kn-_Y#lxJK*+?6>Tx=I6h;OK;?oiY&@-evK_?=eJ4R6&;e{O0pH!nQO0lud1)o zXvSeGPkfE4N~uySY0|1tt Ny$yeACv*95erYdmM{Hkq7CM=G0DEw}S3l-B*;p8Puz4`LFFm!J6)N81 zQn4ypmcAUFPk58u X`LZ?R%lWVCOVY}2@U{7bop zWol(aL%(zNIsL||oij&fruh5p+Q|nc6eS5ITGA9{4rQKvl^nWUlsul?Rfh5;wkeKj z#nkHL>r~7X*`!(Ka>iCOu@*CZJ^hkqcAdMOg-M2S+id;VZAMBp##;Gk`SfWu$KvX; zXQWHagBo4|;sE7{Y1b5m*6*c7&WYyn#{vS&BU7qcExTooNak^)WczPZzwjPuALZUe z-+14kk$91IkcN=tk(i{i;uHwF4DU1Mw(xZboCsQYH*pGiD4peQ(wA6ja;$S&71R{I z=afy0Ogm*~<>
sXoE~0Mx>mTIxp28DI@P%L^vxQIv!yam zd!q2a3mm%RKRzFy9RApDo4I3R@~XkF$ o?IkE VxH+-|oLxO#JcZJRbS8ZI z?)It h{k(n8kMi`8?P_RK_#|H)-b&q`j4 zFHKHMT_*kg Ri zoDW`C(imZG2Lmv8rL2;NX`l528F8F!|F=|kB~9-ORvKCWx{ z4LtCN_mhaZ9Y%yEy3?IoQ3O%nF?(|I*n3<8b^_br2|v)@Wp#kuY26 F@)(rtOxqN%y}&M^An@h6R9o#M!k;Ld8OCP #zf7E^7GX}2*}G*%Q=9d!M4K=r86>b{gUQ9o#+1(b(c2AvKq zUM=4(>1}Se{PZo{8Lp4X ds~fH_@rHMh-ASd=LT|}^iMi3b;QX*LS?jjN zvc1|w?I`S8>S}f^?VC1nG0!Qgc3XbdNppohx2 zEP-=!gPdNAJ=CZkZ@G*E> zePnxFCaUFD@`-n?ZA7)m-dx#AUi`h0J-@z)wmQFby6AZwKk)M+Odjbw!JJ_IIrYJD zU}4ZmWGo^+7Qq!?g2%4%T2V6}Rg$8vO`OFQKZfh+`APl))eQ3tKHr(o<2BEW6T=bC zQ5IvXj`_L$1^08u*%dV31}`2{yPkFTzC&4)mG$!6M0c8^Hf*coEA889h*iRJdo`7I zkB8BF%w<+*){O1Jrl(8C_2Utr(-qof>ZWSXci*jT-zg$aKX&I17a|Xo>-;@~^#Q)P z);L}MX}|Ykvp)3Gq}$SAMXNj>0lsy--(Dv#tw#b(;!J{1Deq-BW)HGwY0#gyZxw|? zZ9PXR&x_k<6n4Npx8K=qvkkH5_Gd?@Ti#Zh@9bOc9@*YrhN4Vfu5a#Z$bIo{#nkeW zox#>6(jg*JB)4Jg`FD^YjHywO?FUzoUo;@I+b_|q3cjC77~;OBDJ0i S<7c>m5z zf>MKk|6L9S0up8c0`bo_3c&QQD;{|NMe~moJTVjm8u)|;yxsG`{?!^1J0JXCdGJqQ z9f*jkn2ZcCRW))nF|l <{?CH_llVU?|4GQt z^w-?~gBSl`^xvgGP7A{EGyQwj1mS4X7tVkSiEkmU_zjo>#q6&O6af68{znSTLx@#8 z!bWC;fCz)gh>Lu42R+w;^v6)c60}RYggnu~?ZCk3s0G&&K|tw1FUG)tl)&w{Yw`2r zLxIn_Oubz72E0t?@bTF_UaWneV033Z&&tR$>uzIt%5s`Pv|ejwNKZ@@g@lAmPEC~z z2?>En%gm%bl8}%f`3#5e5hf dV*OGvDh4Uw#(zekK!~PJpgP4ZVMPc_BII zMRw>sSnIU$9o^Cse7EM|meR)C+Ei`5{dlsw>eK3;T00Con;)0rZFQeOb_0yg7^>rb za>l0CJQp&We?--MSiRBx0jzdQya}=8g2qK21C$TV@_ZzxGC2xq)yhYoEk-!;yY{$; z;osJoO}GF2sYATkwjX>>%gtq!3SQ%nA8v-sLLSC^USol|aX|9RCKJ33YH&Dji!qA3 zZn;sW+yu8KjK_F_^BZjO7>&3C_oE{kzuhD%*v3UN7+pRDKI6S#IEi!j$5X{>cJJ0a zD6ZvQa9QV( aDOjwj$^t)*j>m=$ga73t{FeBip@ z2EGpLb- fLBzC!Blp_JU`ZbRC}Z{VN@j z!5AZv2}Of9onGTp%>mt~CII0jKmnaG;j!joCK`Da@FgxQVK~qDu_w>>m8Qx1Pa-QD z+lB+;!=Ko;Us;dq X2^YmrBI&`rV_2@Io7#<^Q;I zYYOd~OtieLl5N6QR&F}RZ!WQ1J;$}$!vu-pW^E4NrP>TsbtaC=gt=djpejr-`A$dn zED728mBh7tz`ep;_%#9~1ZHofM)ZDzzxf($QJi q_}%OypjmehCX8&iP;amev1Kn6aezC*=`HML z`Ve$#xU-XgF0~Oilv7~*!BTMbJ$`9CxYf0?Y3DJVnXh>lABl;1^9IYo27lk8rpmju z`BU0%VrY) V=4ndVmN&*GLI z zvUxUVD)B0cMtpW1KF1o>9*nM7;yf^GL1U(_Gxj4{2gcqTc?<` zU)-O 8Lda+U>=7r z ;q$G+Kt6b|O(xQ=f-KQ|rSK9dKa zBybhlIxnYd z0SljsZ$cM sa0$Hxcpz_m>0{{WYw7h z+#x8{UqFuRw+kv8_6rWSg7w8E?O_IaKJ8<{9BkvLy%$R48(l9n%g2Wg&K4_VAMlKo zHOmc{;kgB=^i>j?kkW<4dHH`Oe;Jt9Byk-o6sg_M;lZ~Y^RE>&8BtK+`RtdSSR_)c z!2p#IMpc6N^8Y5%gkZ%iXeMmrbz`-K;}P=Zw{eKJi~<{#Dqtg6`mu~0AspmCherS+ zgn=_!b%v0Ds^rDdCadL=Ob#o!6PR7pX~&Rl_z!WiYH-(x#xy1NBK^7?33G;Ot(Iw& zsLG!!^(OG9EDIsxjk3jkuNAUi0*txx%nxX)G9 #rn@zcr5y&sZPf>-7e2>g_4Nnx?SzE%)6hxB>gzItQ*wW^^yhj2~cG~!=oYd zi#sr2P{lkxYF68Nxtd{dTMix${#S2Z4Rypll?)7ZUphH42i||<36N0%*eD=W*!s83 z931kgN{V@cVvX1h_4UEV5OpvyQr97=#^Sg?`m8yycSvYsrcojG4yUp#UTzQS58HJ* zIMH-RKZ%JKQ=q}VGN(e9XO{lAIRYmx> @xZZghZw*Zrf%86SgAUPP& z5Nzbn@g;+azPSx1an6#FQK$XeIX$P{QuMO^QG}m!fqCUKic%np;5vKC|1|_FDl=}B zMWg*3sb-HaIEVSHaH`z*9iJcDy+oQ6gT2EsctQGjJ3ACuX$)G!lg9Fvo1HiZb%>G^ za+In{QxkFiXwkmn_nQB^1pO^m`GzPUdg-|dGErCzC5u)|N^I()5PdMWEDQ|t!ToLK z%z+xg1E^We^grr@x$I$;vN)?e2%74Ks8R1rvr&}->#{+Y&i}iVDnS?ugM1BJiSQhr z{LzocX|wumRH8#0_Xp(4bb<9PSWq-E)-p3*8&FkN&GNcv+}=1BwWC3=2McNY(z!!3 zgZ^*s_@^4e)%bs2v bQIWh5Uvd0{;%%jAo9n!otCVd`_gGOqtz we5`hKbsg$`hv3tT|4qS#Ur0a#QEgWnalQqO4Yj+RjfXM?#Ncs3{p@<45dtVx zX*N+;hzL+%Ph9aNCp4t-(vVrI1nH#I79Eyn(16{Lg0P|v?xroI&MVR_P{(Vgz>1qQ zWfEL1%&R 6C4f+^H-5?FuYFx62zpRHiGe<=ZHmJFp5!V|D`m(Bl zCx zGnG~d%VfKH&L0zy85g(TwrqF zYBUZG&9@}Zg$M>#^BPRVUz#O9SZ&TZFXE(*l2Q=?)2 zOAJKBo@IX-c;RRm{mb{GJU`VBC`4lkXMY wd=h1289Uya*r?qe^paa#DG%&4 zq(j!eH+V}Vt2dz*FB`m^HWt$UcvJEe*aRun)?q>2WiWkgKVkQ|&|`P|K+vqWK&{$r zRtd!WHdbKT)KI2&@!06q)m3J*5xZ&3l6{7Dg55j+iw^`e-A1F+o#o+;CFORO!eK;h za5YrIIti5#5`ygeTEF*_Aq3B8u%RR`dW@X7A&rY>J1o_uStPk3Dv^g+`Zwd@V2Yc1 zt4|XFX$7Jp=ka2rEQph$u1sZ9(~`M;Nf8-)rp{+Ho6XL#sj`uSw5ZqCv$`O~d>men z+nPq>F*MEL5*FdrW~=2?#?Ec9g#EUo+){w=ZA5lyY4O4@WyLXlP~?>ppM%Bk6bM2O zXN#rqjNDsYOG$|^$stdrdA^cPhtm$|x!&_KzsuF=o;;;;w#D`ymbXU5eFMIDoR*cU zv`jE=C=Xfjz!KNeHBOArBkg)19E(ky4g8+=pSbD)OjqO|E|3y7{Hf+st5OMJY(EzL zRGK5DF&d7&%%WXOCs53hBcB59|7ErmGxtp$aN{7|Q|DU8!*z;Yf2eP);;ibi&q(b3 z?ckMiVT3Krmd<&;6@OK;?0whO2Rh6?jLNQ2CuhqsP53eAHn!5aL%W`WDIs5}CRWzx z;-Hr5LozKt_Mv?&W|4TQwPu@A#Fw^jg{o%d4uf;wiU$bCz7+oMyj_+nW{B#}uZrp^ zTx|+JkTsJ3g#gE_9FUR(YR#OGC8gDJgq~GiWXTZwlXfb$U=qqJCDY6h^e4n#bd%r0 z(?oZX48U8Ah9jLH^?ja(fg>l7My{FJ_rESV28G!=Z z2tuwfjSURA5&ijcho!Wo#}<)AjB$h9?ek@SV%+?zfhekMG5nvP7m=@3iL|oCs;#h) z*8{Re$`w;8mWQMsVBzlg5q|DJUAjqd=dK`C(vyu1>)~vQcS=p$pe&PIq6EBj$dVYd zwvLs_=;Y|^Pa7@Rtyk<<8_UwKgSBne8h?reK}CiORJSGyUu(Ka#1T5r%TSF|NN=rO zwJty@CsE3quk6LOEqkIx3bVTleLge4o*d _UlSX^~I7MM KjP*Yy0jyNosF4~72*C?T0t zOo3g`$27yq%}D6@Wq!3(aMF0N4*NqxWxHC&nqKfozR2H}{agv+T0t;Pi2aa_Yw?#d znHaMnjW%Ml&Qg(#(VVGFsCbs(Tl$jUJK>^ k_xGNIVThjk{KVT~S-e!qNUroI(Ra-_y(Kw*wZ58hq}Q^FL0 z$&pP+^@*-FTi{h~XeU`V^F@^(WUE_l-ay;)#J+j&K;PfIyIEL0RDCNpMf_@F2%(u5 zZot{z%X6mBq6d~(6t0)pVzVx{$o0KANh?R5s*!)g6k}*^-Q^1^M@fgMvppv{Z+h)8*%`;z9qFW81ONkgnTI!)}bVf-5CYm$C|g>0D`!cXd8GOyxZ zOEN0@$uL1OvtHk_6FCLbB2`a}0#ququOl$vO=FG+AN?PjURMkCCKK8YGu(UkDpcTZ z>mFDPnvJ6|R*IbvdtzdQB|zC3fSMCSMsnpib%i7y=&B>IM?>69F#%&Uo5pXinfYL( zg+A{Q+VD6cxO5? 1VoWvab&WOvC6JSYI~0C#vdi zsEq%L3kB}(gMWQ@N#=5`i>8?SJyU w<7M#2uWl z*xSIZJ5 eeRHnB{V_Wnh*!`Vb0{TAMKw{W>A6}Sf zlY)0L+?X@0s(hz4JxR0XcBNaoH|VwsRR~&Su!6o(2qQpV#llZ7j-Q?`<)eoTA=XZ) z3?wl^F!@dS^7#OJb8%Z_Z&<$@)3+G!z}jz87VY6{@Tw2 D~z%M*D5*m-#3}opSA!X6~!~ILtR&!UglR_Pp&l=GPakl?ZD*~qZ~eRx%isH zOYn78y+SQ&vGvc#z(mQG?-7A!oj2r~{<$1gu6y7VDa|Uit!c-zOr!hv64*(==M#<3 z(}vscbRo`Mr)i#d-C8Y`T(s16f#+Eit{PXHwfWuv@bxo$Dq_FkSOTeqQblCg;rjQ( z&Q-8|veY~#lPNZ)KMeriw>ggGdo;2I5?Hq#c%XsyYt8d{ zi4%PNCH`(t_$>YKJDjRaG6r`iu<)@$?juOgJbj`Un(<7yQuGczGu!3#_s-B)3mH7N z@d~^8dapR3NO?_^TOVa{*_F`Mw69{oYyKjRDs(xB(V;hzVShk>!YH# ^d+ww)diYVxtZVOnx_HbOCKzmnuqNA zOP~| w)<`*N#Qsi&04=STwH?p5)~N6xA* k1kueO!?u?MOE{Q znt`$(V!k5AQ$rx|RJi^s+!~Up2>8?xjYzk*dF#+tFr?HlD#^>~fCko}Q+#`L6ZY`M z!=F?9_uNJo-*BHs_P(uzbLHtzNigSaOUb=N=Zzl4H$>-459GrY2Qs^cLdY9vxwIuW z(}q;9o|&F%^w4J|ga*T=NY;D_h!hiM$3B`VodK7l{&ujD^P &o8gOFZM0xmCg5{T?yL>QMHi@v>B>IG=Nz vK9w4AbaRgf7J$R~o@&+iqH1H$3Nx28xI} z@U(uA7T1i{0%P&9#0T@6SQD_IxBxb@sR9nGB^VFg9$$g#8XjAnyDhF BlviO`5Bu*OrU4Qud)a<~?*( zI)- 2x=csI0OdJ()r+|$)@n`642Z4SsM zj&r*6U2Y}-`LO#MLWbS*@u-E%W7&vzG%JQgvLgH7o9uU1)p9b`vgx>o?>#Hxyk^tV zzI>CN91_Jflfh?^79p5dRmV0yN27$=+9l??SjRHVc}*sdx( z&bg(`oU%tjE@FfJ%M%*1 -fv1#9I3SV 9DM@&-_p-b1}hMOKGI^W#!oY98KkTjq7%HI95p5NRy zG?C+;DBszq;8WW&ci$l Q~o?jO=!4tpbE*6#XyeM@CM@}vk5cda+*5Q=!qUJ%NjK((07jaK6h zGw~tvd9LfoYT-h94Wz5-42%_c#IAAEKs$1!Y?h41#&PVChNzmRYeP&a`GKXVw~s-& zd7rQLpdaDNjvdpw}P;4tYBSWrj&HlShDok+L=uq_RfRII!aPGza)Mtu=KQ#5d7G2S& z>$pI6{d0g})a`a nK#zA)wNv5G@SFNY9}}9QKQ$@_Yd7b}_xI zM%2%-t`C|*c`qtg@38l#1&hTe9}Vz)%!$56u!*qSj70R8K~}s8ngSk)@Gh~iYjNWM zsQ%jscPB!4EZYJoDTJbEPYSAuI%!_74QJ2iG{J9$5 |^YC zXdaUr1Di+`xfpcC+z8mySC?YQ^RhY^B;q24LrDE=#(|h^QCzUTT%p` !4Glkn?20>_(eq#35 -!b5lADTWt#*@vO|EJ9cOa*Koa#h{S1RSa1mIii0T z+1fYI0T>UIT2#W~PmAC=`E4GTu-D^RFm{})@Lv2@-Po_y^IYC|3jR>qmfS^;URd6; z&oPhn`~Ye+qVDMjQO)<2y9Gs|7{;!BG_Fa--QN{jajdLtqU>24quyWz^?rcv%9His zGx?iG3C<+(d8y3NLLreJLjrbY==-Z9OC2qMd2Fiwx#R7a^UV+zD!Zr%eyRksWKxS> z5bB2udlrtwI3F6LbW4H_p}=fQUI&eog$IGdAZjqh FTg;iRMx9JrXnCC6bf%_ZFQF)YUS{8<%htz2DnxT%WG?W>Hj94x} zESn_&n#tQ^V^Fpaj4E#$uiIGy%AtdyVN*XS$xh{hehDc!6&*&B68BjMkk8EHbT@)g zgh3^j*XHPFun=Ri+3HD#!NHSf*~qsw9DDZsxxRezfnnF+{otXBMJXW8EhVfa2xs<3 zf;l@Z(t1BcXm14YBZ?*DKufHY>-?)(Bd0704}0{T$rs8{PZ}^jG*Fai4Z%AHdqrK- zl&@-F7NPp=1mGBfO2%oVxKY+BAQ-s>S?0;E0f$CwunGj930-o+k&QG<#{13^ox1J* z@`U?`7_&4M3)Fmkyoi$Ys*oA}Sf)MT0ZO>2dlc9Pe6|o*hNmtk*4;l{&eR+Io0L1n zQFh&_DnFnRk`Iz5+?T7tmU bjQM8Nuy))1GNS!c~&&&W72t3WbynAU1GYi_~!jn<{bqD$t*_zDuH_ zX=2OeMaxz -!y(wBU06;jVIJA50i$VDqjUac1Sl5PGaoZgu Fy%;VT zov`6EcqaZM$~*LEPLQHw$))Ef@9_o^M{%D46%D?d<^Uj`!freo^q83I`-<~=-!QXo zH42Rmt^vkn^co%Sx*CvX_GFeg$$QnMC6t^s@G sZD>w_r~F4kkOm*)lhJhYdO7(wx-dokb+BgwC7 zzPbm_n~J5F`))M~#k>-2KAR8vMPY#xvrTpY(!-zrV#`lyR0_vD>!N8{w|<=$sWSIj@0!$my@>z2)~q zm6wv%4xrZJMiXH^DbZW2u^WV41W3226evgZ$#Jyg!@(B`@I$xnhEwgV+M|`!t$e z@W>bO#-3qrg^tLFpoL&o74m(kn7CKAC`12Tbm5nYE9YXkVN#lXre|r6E3OrL4(S96 z70U^0ZrayZ8F*Rdf~&U2)ibeh9CMQmKY)*DwgJyEx+1?!k6iAg3U1ig!}E=i7-!8j zdSLMdDdL+p^8JNXLjh-%)`I>L`yHR3@1{w~=UBn_0njI>4HvH2%qFXKdWJa& vlI1Ptb$@%g0lVr248+h7e}z_7 zVObPFlI}&)RlCBn?gtb*xsFj-vkFenVD2O0pJN;1)Vj>!9uf^`M(X)|G?6#R0zVJ3 z+s^Ofr0buziO VpBh4tRT0Qc#Gcw;8@& zQnQ|zJM*U+RY8fKRd`rk0rz-XcT(&Se~RJSI8ThP#qiwfdTPfl{%i(c^PAyk>$92Q z+H$lC$Ha9F9DxQy8SC{sZ-u@8c-rbH@Mv=X@E}8zUf=BUniGL0pbl*@Xx?s^5prAD z8?+ryFxN{q_Z&s5Cir%A#AZB7b~%E(jhGb*P3R7iNIo?r#vJ;VZU{L(HvKcpwwr~f zqc&{dfSHpH N&VZ*L{N&S>LUpr$)B zmhV!dO##X^BGwFre6 Fze|xfKnfCKFnKSQF z?Dv8{9u)@;B_(S>>N;96nK@xK+_Cha-tuqB-6vpCKDE*cvXtJ^k!LtfSxn9w3z9-A z)&q8W4hM#bUDj=10M&_8I$##Sbv93vF8oHnmYR~hjsFaBFo5GBvbdug?R`B!v|G&F zr!iPGSg&^S`?v^J8m*<{VS=vAAH!qby-lIkU)C5$n6`l3$v-<*j- o$kY*)_D?vYyCFX+S7NQ3QBMVQI z5 r!!a)y`e{5*(h5bKAi&Z1KcP z0ph@up3;?@dfz(ypE~zhQfDlwjS0J=YlzK@ )O6VRDokYyINx@}t4OJgV2)?~{-I- e@Ht z{kS(oThqea6@$0={j1cT7D>};qh0567esM|$L6%b$HFk}{UHr78x%Ao2Xc9EOZdGN z_L{_CFq}$T{u_jTQqbGg)mduSnr(-2Pj^XI2$@5E8B`3%neZnPHg~w`WV%7u^X8O_ zm7h*b6Vq3A0f^g{Ag37~DfWOa%|hM&flY`@D>N&G!WpJ14_DY23Ima%^R{n}n0r zy;! nY<>~a1s&NyqbMN z;n}Lv^e3;Tg7fwQ2ZO@mEyG8WYz)A-YbazfRj2Rl(kMg+uT8FUB^WdfT11vEol>O= z<>t(H3nW-!5X^#^j|kg>3-oP7tPukM@kBIOQ+iS{Gv3P)L|Z@K{ATh!t8ks>h^2&? zSH1DIL1@xZCBOc{$ZmJAw-gZ0w+9LTLcezyy#$1!XL8=Vr JBbzkm`)WI%QOyi>gvnQMFUd`@F7SU206UjSW+Lj%~ngqP`AiMcVX| F4 zkPJ2;t!ix&C@^sYym^nZ8*J>0Nw7bjz(If79J+0KiL6X8bxB*i?~GXS&16AkVpsiW zK$pd>qqF*WwGJhNJE9UOkVaEWR )C`u>)#CjFieY*sOy|GM{sM6*`t{kia5 zoB{Ub2&B0$JPt}X>|mL0rMlc@2S)NdSitMin&qxGBEps)b!(iw;5#_#3ByYS!47oo z82A}5raajp8N$2N0L;e%+gE^|%I~!#z}T?KwSU-fEp=1R-N( Tr`Jo)quT; zfr&UDCk+VSQk1*dTUn=bx9^9i_4Iy3{ILe1&6KUM?8hIo+*IU_@MMJZ_Xm!p8w5w- zM|Z@8+UyT(DjTAN2Y)`%fEZuaKQTUZFcJu|H6D1wqqdL74L%YaEN7vxOb#2GLA+;) zjG-t@BN$}U@$HB%6br|YlkT4*a>TwdOS=BhV&=HO*Yncr^ZY8fxnmnlu6_h2Oay7m z@x$=!Ou*0Qd($hLUiQJvNJTL12Pa@aP;)Dp(pl`RyZpYd6o(yVEAy?`Fjj#{gm_$2 zqI^c>=5bq5;&Fq)81xsX(V(32tsbrHqJHZCv^uQHKkA_FGmrnhl>-_uWsPgF69{>) zOk%}sTB6Lmig)E7@d$!wbWY3Ql7|O=+O=YT5Qi;c{yRLlx&KB(??<@Dc@FHAH#?!L zh4g?Rq_?;hco{NYv<{dmOp@1CbwncZq~g Dt>P(T7i$5dY?x zIn3~k;9E8&|A+IWgg!bQQy+}{4xzwGXjLaoMqJR-6Ah<)3c@)W!Hj* q{wE3x7 zQF{n5#QUINEm`&YUHA_V014V@ MmuSbIifeT2(Xj(csLMw5x8=0 z$Wz^mc2da?XIkWx8%oZe#r!4hDtQ{xX_}bC0h!w@Ea)dCG1mK!w*(G|pqG$FXA`tk zX}>Aiq6YUes)_HxCb{oa5{2|o16qRneX_!EVX&^(*SwFzXjJO2hR?S&E*MM+g1qza z;azNYl%CZv-|&IfUt5~!@M>DNNVSYMRmN$nZ#>l8U%N;C s9jR)2DDXt^!>2iC4mkydlGWrXvL?(%FXA|AQlI|43u z{A#n!p6(v`dg51E=2sa=?87UktuB%i2NutJ?AO;UJ8i!nN=1{ueL#SS^D}`f3lu73 zl?1oBrNJK-{9KNS}cxKBp!68~CT7`yhV2!T*o1zl@5jS);a5g1aVYa8Gde#wAz+ zNpSbz?lczM3GNQT-QC>+!QBb&(DHSjXYY4>=bU}sUyRWMn$^{{s_u2qIj;(iRR25w zcmK}+SwI=tOgC`k;5Cy4%>Ug%dlfC ;hf=WU{Z zCI#9VZTF2envSvzaP{8`Xzx~a4_vqVoUY$_lxh-#jTRBwfHCUNj!#c)>qqr6OPGge zxej{^g_qhV%oY#RyIt5F1qMsOoSV8_>&dYY!m0Z~m}QWf%!^*lz;@&RvXs~2Mm;hi zumV$Ed(O9JhKAOvcn&vB(S@aPNI|(|;6L@#`55diJ)Qs5JEX9B$LMdp!=L_ts+|!s zwhhjO!bO9B8)rE1RK(pG0tyrONV&bJWKp3MP7acM#2O-Eso&W3rOOt6a=+>!@TG>& z)e9yYrrV^R*uxZ4%IwA2?t7IgfKQ&+vX|qduisGS$!CA9=Cm`(neS%pk(lDu5g>(p zQH5S9&!# KC)I{o8NpDK16Ro7bXSX7Iia_p}nDSDP zOs_j&)Qz1h$n0E-K8}+8`?Ud`DQ%c^fdi635N#wCarnrN^_(F|V;qZ*0rPRk>HY!h zFTSN@yJcvA!=RAg2&|O*=!qLgKc|H2Gl6LGg<-umkw^YU@|YXGqSx{SXcr(T>C}L2 z#SfwdM-ZSGQJrlMgwP(w_nH =7kfLtz7UZ1@E4>cC~TSX!O{9Q~8IoR_=1d?NZjmY@XD5>0yq0 zwo+kj`{i^uXy-XdX<*KkMT!EZ6Fz$L;|0oj;zy-U^oJC>Qa$C`qE*f!W1Wn5KCb?x zC#Jqhq>Zo@HBPx?%pta`cZ#jK3&H873iapYO9;406u2bgy)MH)Km=(IWqH)cWh@t$ zcb^UYv#wu1GhSaJgy_H2m#*Rfxadr8UT<-_o_y{_wCWSI@tVt2e*AGTMnn8*)4+Ff z=~kNJ_}EIai&%I!uXV$3IO|%Z;=(LNUvdeA!A7A4Zt*~q1wyyhwbqgiRygCIzunx% z25j4`(QE(r31EudzQUxb(;iw&GfbMQ!L-BY9}DjnY5^J~GN^ls2cYdTCs*^@F8;ta z%y`j!m-Fg7?ywO;Isb;wy#6(^y1Tr{Y5afdnmTFWWU4BI1Bd? |I-W|bD-IO2iknaRAvbS$AYHSw!>OBrRCQP%z z-@o2II^r@R#2^@}PA!F|y<)f)hqKYIPgZNolxUn5NU7d&>r}2r#o(%X;QbGu-oO zVR_Fu6~*lr^W)F{K)kp!n|9D2_Iup4!lf23gg3mRu(mRHyPFWnppS?B`RQ$MM01(S zS6^x=e %u<+xXmYI_GQ`A?&AmYQ~&jmawZ9&B05#U5H(3fpwe2^%K` zsGo7+hmd#SpA8IEO@iW2xkf^$+&>jJU9;Dp&&(k`v3a-FR6IR;^pInxw|oo>3u^LL zL1hgl1EeP{F`DJT#~6fl2THCaXQ-AGlLm68E9>j~9GgAIVHN3wDihTNFQ`1v`oZ?_ zDED8_3$pPA^u$;D&&fJcXaY-FH+EF;tQFoDXS;TP{4sO)kFt~=6(Y;4IucX_wjblT z9PwDU_ovxc^a}HM1JHt9XFm7@@>kY+Xab}7TPu>VeSUH%7>~B?zyEsa%tR5Ct7pb| znVJgVb^2j*V0crz7uH#2GyG3?%X4QGkNN?#GO??p7KI^V(a6G%<*ae4JPm(*Pk2rm zWBjmYG|Y8|>U+} omR&YsuJC5};~JovW{C><^1z^&LB=!+rH?p!Cn!Q!dy<`H zci?==xn<*#yaE2k=| )nBtPUo@Q4nYjLCaQ8nJk zFBbZthaKL-F;zq(@V7`)N9-BNw-=kLef{wQGoRZbZKrFuGga-URo;?rm7yW{JW2Rx zk@(6u)ZjC?^c6i7F$J+14}Pz|J@wV{KZoDM+xb&_6toa&>+V-K8t&$GSloCo)?b90 zv1wS|hVLk=FSb$=vG*QbQ1 9CX}mPvMf*?;?T0c`o(lEXUQO$^BD?iv!xmT0jY#vh0-{;Thg z6m+Z@ iWFqNk8p2EvNoyWLc zQx}dQR+7S)E0#o5KhiS+2eA8y32}mBMi%OcdliQD5?Ns UGSo-%G=Q*lmEe+Xs1P?| zAWcS8S=5e0A#Ho|TJ ~mWBR3I1WM%K4g zgGi+4_`W=n@UH;VeNS=zX5h_83g+S;FibO9+wUg~r4VIfv^?(}C$e*;edms?nXdAkxHNB#0MB#V}Y1(pyJf|s 6cr;<$8Akb zPL(lX7?kpaanSy>i}-jpO}0GJT3?~d_Q?46*}JQv!40=6=WcbUfos@1D#Y-XZ9z_O zhN|;6LD6#4_W@5?u>#TSAk9LG4^Fbfp~-WbvhqC^QQ^Y_4%L!<+mkGxr%P^w=&zD( zRS{-$6dTVaj{{u&+8>s_GJdd KKgkYh0=$BXu^2N mlNZ*W&VJMR>*dx@iw zX?fslZcbS?SosJKVUMW2Ujd6#*K7zZtkt&-E)19FEVbPA>oYXELe+$6(7}!d`u1>` zxQf34n`D=ps$YYU8yt6w<0kE>E~5E$Rbi@JOW1kNWnaDix) f~gQ;w3A>}shcwZ#~oZ0d>k(;1i5KqIM}0E$F(Q^@{Oqes+Q zMhfEJyxx%fpF+|73uZ0}yR|}2SFxS28cMXWL_@?hgoK$3aSm-^4+sZ)uYmXc+YM=p zk6~ajppSQSR^Kp8efUP4B)hZpxE t5bre4biQlp}lR T-?o_=rW|=7 zdm57{=KrH$jJ^N=R4~eLw>!(w4`5?tiN<%u1<8x9{i~4Dk~)ttFj;Q=@MmDO2~D|Y%S9Dkv!~<2YgWs@3aU1 z#5RRDVFuzg3h9x)|3vX1mHH$7V4z*G#963oWO8_FzM^;JU4LsuuZJVJ$XJ+$G!T#8 zX!&UUVT}y7_kb$ *9T~l_dU+r+MAP3K-K}2qvIoIt@f=SZxTH%HyV|jNW*LaL zFXs#hbB8TwVdOHI{YGfVHQTB+ouxZw+6;8JM0;a0M0(<|;FFi7IDPvE m%H$_wYqQ6fbxV_zoGw%r-V!5A8Mn7!)7#4!{W&oBn zI3(9$e+q4PA7f{xg4d;OmQ1p81_JKsM%=5->!TxSQK8fwtqI*Zk;P}SCz1FHlvXsc zIE0#k7Yl~pLk?+eVr#wbPBwHRPeouuL{gxPLnhYoxo=5FK>i-)Y{Q$Q=-i&ohRtG6 z=~aL@t?QOQ }!|8|pePq5jIBbyq zY*%Ifxp=}8o|Tyc=i79N;N`fY`7@=HOto|_*l@taXzUG5c&4maD^FAeq6A+TtgtXt zbUq7w^UF5Y`sk5xcErM2X-dzMEkZmWRWtAk9EffF5zvz!QC88L8le&hEfFA%l&J^^ zqo7Z+ n3={ep5LeLe2J}(SzaukETgK8kAFe6U2<_AIhT$OI^oER%w z2y3T}AKyA#`>)2;BV~={se(Z=MdHpq>XB9{96`E0x7
N9o_n^g z$9!DxAk-I_u52~ZZ;mEZ^>DaubFrgm+b<|m9uS1wE-~ZKA0naO95KpiIiZpvmet{Q zg tw+U&iqjS%~xDq^pT>8o%4O#wk^vZG_&+WPAZd*FqE$zJe z`x?h3I>M)5#!%+7vK|uyvH`jk+y+2@tMp60$9&2H_QylyTT0?N#<$)RoWII7rX8B` z5_5pZ#lQzgdvmI;oP$FF-yzK9H!EZzv6M^F1>>WP^R>eiyI2t~9W1(WoDF$4P`Hdp z{ZPM~0Rq+B`YDlmM3M|kUti0Sern3#K3k6D|K5Z3Erzbr`6f-1)*1r&V!-ERi}T9I z7a4wk)r0`Oj@`5*+Lc 5p2tJrSuFj9{jNYWS}~S08bs zKz%uw&5%xhtM!cPkK7$S*F@ed7yE-zBD?PL!fXTEL{ErB9-N09ah@HseF RH^=iXj5@*GoL7t}6oj^!i@I_t>8N;v58h{8S7}C?k6UnPb6}eG)2*y1E?> FaEvy4~wY~d&|BgA!c9OGXdL ~MpPm=#Ug;#=ro8jP}hK=U?C&PNlij)5*2?#{9{JHN4) ziNwQ?iaS}d_&W4W9P5>(uI);Lg1$gJ5l>R?cf`p=&A0j+j;h=8*_zi1vbsucSMXR| z=%l(eXRlc$eq?04AAij4{E@T}$7^5rNRqL^PEvOk<+-&iiGZC>*OL!RW57ihMtCg3 zV$Fo!&Q$ZToX^+5H5Lqm2L6tyAB!sDpQCd)s7>Yc A$PG!By7_m!>0BVkoyrV|&rYYxP%63o zauRdaZ@+hL-+=eaC5o_Tv$fHlDIEg>lIby0#fpi2-`fq kR?=Y}%u%~rD& z_m|brNo@^c87h_}kv=U}t`Xw<5^(I*7|Yq4+!)`~7KH95#@T+mZkmm+h8;x^WtdBn}6)k$iBznqdQ{p61mD(kyoy5pG-eDs_CZTIrCZJ zbwC!utByoNlicPFul8WD$_2R*iu)hUDwTg}2vlB(xmX@g`x+5x#D#rRQ{b0}NHK)y zf3oX;86_O>TSZ;4rt-mTfL6UZl2PVMToBGqxZ93mVJB)o!)|i;=1j4|=Et)MB}jxp z^c>fmhm}*v?0|`FPasHlrOQ^>c4WMOG%Kd?MDA@84{Q<9>dQK;%9dPB@sZIX^i_8K zhE)2^9J%O=(bLiaS^oeZDF&0fx0p5V-h4>3#Ltau%bzQ^sfEkBEX)L&vBvx+XRn|A zmQ!x~>#D=Q)sVM+O9Q!P+Rhps^T@H9V#Ni5;Kxj`P*y(6XQjVY4&@hQK+lLAG)v`% zb?L*7TnB03CUf>}JV2F{7V{C$-k-D^( &g2tv)ToZpcm zhxYT)qDt%LY4m?W_59N? Re2V!_X>LGIfxCfVj@3
-sev=o!KUkdrcS!XEjwnXI%fjQb|1}Qro^?kQ6G^ z*foo3)KQaNcl%tlE%rmdSxRsmiL|gVqti}E+2Da_QV) =n^C!_dR%EO419Jw{ZzQmt zoCC^`bi5^~B9duhl0{7?WtsS$xU9I9SU(6MV(^cSS8>m)GnK2jHho#r{3HA8fc#s5 z-jGf>mHMauH?Sv+G~llStM7UDg&$(uyzv30zAyY=)f)C|RD_5eI4HfTSy{@jU_g|D zPMGkXt2AXYD! 7I2AZQm4qAmQ!T;A*3{x<|7`ezx+T|Url$jQNOI%ra7NU0J$0j zC1Exd)A0B)ll{^_rLrT$p+Q51Jf-E5`*+Q&ls*I9pLNj V>`g<|>-pJ}NVwFh|@mOxR2WsDGM z-Qv%E2DUq-+Z<3L^9R4vz_2S!6kbLD9ohf!Nj{R`$?q$xcY{vIzAgNGgH)`XL8uF( zShxz^;%+eY+T?yD`3`X(DMZ}u-W5F6d-uQKOaHuW%?<748*7dx+ttM-!vO~NP)avT zCE?n05boz8Vc1A;iM>fu_;>aEpL8jz*RPfg5qp<9Je^^FILld@Wf>u2%#fj9<>XN? zq>wPN1M7bl-~avR*og42ntC56n|~xGN(I1}G{{73y7Egh+Gs-pGfLlJN@OB>iFxt= zZ7A4K#e?wph|P$sV4ncr%H}$sk9ZvEf|%<|ASZGS&(D8!k^ju$|F0k7NHmv|%>@4} zJi0Z8ugI54+T~9f*xx)VwOGP{J%m73z5m;XCq>NdeH=_NAj2ABRxb`i-kp_m{Tj$g zdOOA&gCDhzUTt3Wf4TCw*NA@@*kM7@A~@8c!APR{?V8?F(kO*j0uZGihEbHl%Kv9) z`X5uEh87RzMM!4VN!Keh3c9-N$1W1j%}1>w_dHE%t%&F|aL1{hXp}UAt664|Fl0&?Yc4` zT1~oYfd}ZbRv3uPxR}HM#2 D0(12Z#VWA%DJKoX#d+Q+*`2JW_M nvn< z!e>a?Mb0yX*%lsfU?!O!@-Tc+`S%5@%@(Eg8jWWNy@!L&+ync$#4Xr5#S3b)=D| d!MUm$sD*v_&!C58tz~T+1s(3`gWT$w| {alha~7dPdm*B1^cmdr%yT}8EPJaBZ2((AX~B#_YHlk~W2)J!;i%NVggg`> zBwy& f4rg4tgyv~BfOo> vkw^A_X`z z^N|OE@`GlxvSy?*bDWP0w_IX!_WV;!ST`kEmY5*A?hO#D7jC_%d%zs^Qp&3{pqT^g zGD%Fb;!{t K5~wQYCcXciN`&{7^+z>OoVbEUXq^U; zbIGSq1KF2~{fL$nq$`Skm29aZ@FvZ{o7t4UgJVT8=m2*wK&=5brj;hT?0>Iy9)coT zaNjKiabWG~8C`f4RK}fq@`#}XyUr724fM|#Weh6dnFn@t0L$BF$nh^6U+Cgf=v22- zY}t)!6sZvOD m21`dgF*DZf;G~#6;}+N>ZV*MGG^AuZIb= zC|ok#aUNuNQ~Q#zA#aD3EOD1R>X2%bqJ=F9hBj1;TZdwQ8`1PQ#;b8XWTsjEmy7Dc zzXElDj_NU3LC3|99t(EayXlVpe(fEs$1g p|i?($TMH2SaaiBK1GH8 z3vj&$tUym5cjJD#1rLsd*Q)=;x5l}@)8Skz=mH+Ulym`4K~jeXLeO7N{2M93T5!|3 zprC8^F+kFL=we)oyuoTY+5X-hF_x^&HJ9;TeTTGHl2*~526^_`;b4HKxLq0OIwB-O z9b$q#`!-9K#UNH~3Flps&kt*>4Uc19>}6+6h?Fctr>?W9dJNj)bpX4=u7u>)4&|W1 zX-*U13^?=VGUvV<8{18~cPoE4Hm3U-l6PV7_wL>##>s3&*3a7>P&}kWMngupzzd9@ z>UM#IxA`OY$z{Q=9Cjn^8yN5B)RFS$o_f2M5VC4}*l@)7grE&2tySlSa&|`5?gcpu z%%7$@3=hSUl-ar{V30*$n~z^zok=INIuJ7a4132eI_K%Aq@M63!@^3bNi6aj2s^ew z`tMwnYM+4&-(#sHiqAW=sUGV!Le0cewPvnD%fJ7<(B4k?2b^b!nb3!MhL&*`4o db@{ zTCxE!^a^c@!?q-;SRlWrR%3_($5L|SXVNP93cgVCtmrXf_SQJFiMK}`u| YI{Pk3flv}J&Sw~9R4vV5FFMrv14ma fbV3l%=TcR^QJ#pYZB~9zQ zkej7UG}(nL1`%uCa{ZyYpI=uKkSYce9gixz3`J_GO5Lx{Ocq|GdABF>;l6uHoo6~h zQN95xl_k#mJu{AEfkzE$p#AhpKg1aNMnP n zh-K%QKX!juQ;iQ|Wo7lN!IAdcN(0(LnR?>aYCT286p++-N_BC* 5JHvimPW^!L4i*jcwxKg)^h0{yQxS8Eu&i0GJ6PR!OV-i;x} zL$80}gMQPV*=PsbGEoW4AD-VEbg|7}2DiU|Fzd+Zp0wZL(HfZ3VN4=}UqX-=7e`4D z34B6QheZk6n8xKuBsPTJO5^C(7PfE*3P-S*CFhKp!GgPnLKkb?mREE8x0n5@*XvTr zJG%QT%rYO8YCtLa#0r9}I>bJl;d|ck-aAego$k2GnUBt`$v6|3A3zz1Ao~``2ce4& zZoz4)$(-&~wo|{XFLZTCc_X+f6W5VBuZi$>Z({EutIgKR1VcmwC5&!@IZd|fY!9!? zd K zE) -={jc$t0K3}Q7TPt|=xz1|Wy!rJAtFKJLGXR#CdUwoYb0ofE zeIXkBYix47fIw9&N5Lg-+p-UtRb)th|97=UsJ@>O=D30KB|8gK)kQ-5AtT8nzj09C z!=^XJS(k =ndL^ucMtKA9*VV>CfC9nywJHVl#6W_=KL?N zYYK;I`hKs5`Lnbe_6zL9RTLQMWvih48zYFjttFAV?A=$`(G+)?^BoEEko!${cGByQ zlrY{@gg3OWGWC5GhJ<$gH`aBhRfLM9#+tQkz{-Vf^L_G5=E&Itn;pP^Y$rA`s|a#; z;m%0zJ%Pv4=_(;~^Jm;@GTpV*m{SyLc>(y&i;aTS5gPNyr<551ZJFHlk5+}uuy&i# zGccpM8+x|6IWpb&nFHnCB6}fgu|g-~_HfgqS@w3|Qlg@9DXxh3Y}x<{!`sL-uWzLA z*)G3T^P{3qqVO(cC-<1~`-7vYrN0(cDF7#~8@J(kNbBYEC_q3c^-@oq^c9-U^G&`# z6vzCDEJ+*EV8wmhB>X&EtgItB2Hb+I9tH2lI+;mRwNXRCCQ4m5Rj+P$r@KSepi@gw zA)JVd`P=U6Qbf}rmkuy6e-}En0;N-f`g{Cm(k0%3v|ihZfoQYR$`l`YX;D!IXP|j8 z>2D)qiyEQV6wu1I+F}5V^S2xfX`zXk50szDppS=y+rKCVK7rl<|HV+xLLN3bAUs>j z`gTXYg4L+j9|B;Vh%d?VL58}GPK`>&6XS2vgGj<&MSP4ZrDTXxF%G Q< z?AKuc^@v(#Vx{+|v#O$?RcH*WkE(9;uv& ;c+=lerN!}+{-hk)lo&aQ7)qd zPgAL!It@iDjkd~yf;L+V66WjAcP{5o8WF|Lbz^diP2ikyZOi5jA1n*}%nARGM+!aTLeOS8&G i8z{(dM@Ws>$ KLf`FCO0_?!apq0mv)I3DkbZu%L3MJxWsEExkf-cYZ!%DClOI$}Qe6f#0(i zQJR5+X>-Il=CXlXRc7%sP)eV9TNxsyz^)4>Ou^5 z0jZUlX#iNI*=q!w=Y7j{4<(|Bh9$>!w}ydthHQ*y3`QL<+4ppFa@8l%Ha&R_ea~9& z-vz@Ws_fm*e0BKlDAtHMqi%xAuIMvxP4AzNi8kpfee7QVFK?wd^0{lyevcW&_)O!i z0Cs+$KnA&f==mkR`*Ku7B&SBJ&lRbnqR*C9&pp)^#S8a){06^AlvCWCeh#YVrJ!-L zUY>FM(3`OvAh=KI$!%!u8k}4<8q9;wYPFR6by7YAM z{JDAsk0R{{4N^Uh&(kEGuH*FPw6O#VUHbb@oH+zzuysTvkE;37u03)}Et{KoE5Mjz z=50}p@twN{q4&0ye~#psqf@{rt>>Tzpg}F+wZmEqbC9aI0LnEBNei+-sfdC$c9L zp=G4wP8^6_EH=5-3H2UuVk9>G 4-T zX7HEdXB4e9HbUjZ42(9CL!O_IW&tFpoA$AF2vy}q_iyb!p{&9Yf-u}d;s;5iejCiMv&6%A*_+ZqR|*#4JVGv1Q3^?p zYe{6Pp4+v0FKCPu%DxxeiiMmE6rPx><{pB{++uB3oCpXe+9F1>-R8#2DN@AC)5f%S zSX!qvqP$5Eqv)vpag7>TI#X1GuI9Iy8kO4L-F8PkVTCty>{%!*Tc^(u<@w}kmW+di zXvyL9=~k3ox$9*EWxN9jd}=XjrHm)ma40Q<9on!XDr`jDXgf?AmC1=ZWZ(VLYl^oI zmMX8JXKx+q*Sp7w0^OK?4vwk v+OoO0muO z(7|-x{c81m+^Dh=HVCr`^y5_6>n