개인공간

[Linux] rbash - 사용자 명령어 사용 제한

후유증 — Wed, 12 Jul 2023 11:49:51 +0900

리눅스 설치시 기본적으로 제공되는 쉘 bash 에서는 특정 사용자의 명령어를 제한하기 위한 기능이 존재하지 않는다.

/bin/ 에 설치된 바이너리의 경우 퍼미션을 지정을 통해 사용자 접근 제한이 가능하나, 세부적으로 사용자별 접근 제한이 가능하지 않다.

이를 해결하기 위해선 bash에서 restricted shell 기능을 지원하며, 이를 rbash라 한다.

The Restricted Shell (Bash Reference Manual)

6.10 The Restricted Shell If Bash is started with the name rbash, or the --restricted or -r option is supplied at invocation, the shell becomes restricted. A restricted shell is used to set up an environment more controlled than the standard shell. A restr

www.gnu.org

본 문서에서는 rbash를 이용하여 사용자가 사용가능한 명령어를 제한하기 위한 방법을 설명한다.

1. Restricted Shell 생성

rbash를 생성하는 법은 아래와 같은 간단한 명령어로 가능하다.

cp /bin/bash /bin/rbash

기본적으로 bash 자체가 restricted mode를 지원하며, 바이너리 명을 rbash로 두는것 만으로도 손쉽게 적용 가능하다.

rbash에서 제한된 기능은 아래와 같다.

cd 명령(디렉토리 변경)
PATH(설정/해제)
ENV 일명 BASH_ENV(환경 설정/설정 해제)
기능 가져오기
인수 '/'를 포함하는 파일 이름 지정
인수 '-'를 포함하는 파일 이름 지정
'>', '>>', '>|', '<> 을 사용하여 출력 리디렉션 ', '>&', '&>'
'set +r' 또는 'set +o'를 사용하여 제한 해제

2. 유저 생성 및 rbash 적용

2.1. 신규유저

신규 유저를 생성할 때, 기본적으로 적용될 shell을 -s 옵션을 주어 rbash로 설정한다.

useradd -s /bin/rbash ${USER}

2.2. 기존 유저

기존 유저의 shell을 usermod 명령어의 -s 옵션을 이용하여 변경한다.

usermod -s /bin/rbash ${USER}

3. 명령어 제한

리눅스에서는 기본적으로 명령어 입력 시 쉘에서 기본적으로 제공하는 기능을 제외한 나머지 기능들은

$PATH에 등록된 바이너리를 실행하는 방식으로 동작한다.

또한, 설치된 프로그램의 바이너리는 /bin/ /usr/bin 등의 경로에 등록되어 있다.

따라서, rbash를 사용할 때 $PATH 가 바이너리가 설치된 경로가 아닌, 별도의 공간을 가리키게 하여 사용자의 명령어를 제한 할 수 있다.

3.1. profile 설정

bash profile을 생성하여 해당 사용자가 실행가능한 바이너리 목록을 user home에 지정하고 $PATH에 등록한다.

또한, 해당 사용자가 임의로 $PATH를 수정할 수 없도록 설정한다.

cat <<EOF > /home/${USER}/.bash_profile
readonly PATH=$HOME/programs #PATH 변경 못하도록 readonly 처리
export PATH 
EOF

.bashrc 파일의 내용을 제거한다.

cat <<EOF > /home/${USER}/.bashrc
EOF

사용자가 임의로 파일을 수정할 수 없도록 권한을 변경한다

chown root.root /home/${USER}/* -R
chmod 755 /home/${USER}/* -R
chattr -i /home/${USER}/.bashrc
chattr -i /home/${USER}/.bash_profile

위의 과정을 수행하면 $PATH의 수정을 제한하게 되며, rbash가 실행할 수 있는 프로그램의 목록은 /home/${user}/programs 에 등록된 바이너리로 한정된다.

3.2 프로그램 허용

사용 가능한 프로그램을 담을 디렉터리를 생성한다.

mkdir /home/${USER}/programs

해당 디렉터리에 사용 허용할 프로그램을 등록한다.

cp /bin/pwd /home/${user}/programs # 예시, pwd 사용 허가

4. 테스트

rbash가 실행된 상태에서 /bin 에 등록된 바이너리를 실행할 경우 아래와 같은 메시지가 발생한다.

[seong889@localhost ~]$ /bin/pwd
bash: /bin/pwd: restricted: cannot specify `/' in command names

또한, cd 명령어로 지정된 경로를 벗어나려 하더라도, 아래와 같은 메시지가 표출된다.

[seong889@localhost ~]$ cd /
bash: cd: restricted

5. 결론

rbash 사용할경우 쉽게 사용자의 접근 제어가 가능하다.

하지만, 여러 단점이 존재하는데, 아래 링크를 보면 다양한 escape 방법이 소개되어 있다.

rbash escape | rbash restricted shell escape

rbash escape | rbash restricted shell escape How to bypass rbash restricted shell. Today we are share many way to bypass rbash restricted shell

www.hacknos.com

기본적으로 rbash 자체에서 /경로/바이너리 방식으로 프로그램에 접근하는 것을 막는 것이기 때문에, shell과 관련이 있는 프로그램에 의해 rbash를 벗어 날 수 있게 된다.

또한, 파일에 대한 접근 자체를 차단할 수 없다

ls /

위와 같은 명령어를 입력해도 전체적인 파일의 목록이 노출되는데, 이는 sftp 로 접근했을 때도 파일 목록이 노출되게 되며심지어 파일 다운로드도 가능하다.

이를 막기 위해선 접근을 막을 경로에 대해 퍼미션 제한을 세심하게 걸어줄 필요가 존재한다.

chmod 550 / # 동작 테스트를 해보지는 못했다.

5.1. 대안

사용자 명령어 제한을 위해 각 서버의 디렉터리들을 모두 조사하고, 퍼미션을 설정하는것은 엄청난 노동이다. 또한, 실수로 설정하지 못한 경로가 존재할 경우 사용자가 마음대로 접근 가능 할 수 있다.

또 다른 문제로는 일부 서비스(ex. apache)의 경우 자체적인 권한을 갖고 동작 하기 때문에 문제가 발생할 수 있다.

root.root 권한으로 550(r-x r-x ---)으로 설정하게 될 경우, 일부 서비스가 구동에 필요한 디렉터리에 접근하지 못해 서비스가 동작하지 않는 문제가 발생할 수 있기 때문이다.

그래서, 이에 대한 대안으로 container 기능을 사용하여 sshd 및 사용자에 필요한 프로그램만 설치하고, 사용자가 접근해야 할 파일들에 한해 볼륨 마운트 하여 제공하는 방법을 사용했다.

이에대한 방법은 추후 작성할 예정이다.

[javascript] for...in 사용시 주의사항 (with prototype)

후유증 — Wed, 12 Jul 2023 00:16:23 +0900

프로젝트 내에서 공통으로 사용하기 위해서 prototype에 확장함수를 등록하여 사용하던 중 문제가 발생했다.

확장함수를 포함하여 개발된 라이브러리를 html에서 import하고 페이지를 로드하니 정상적으로 동작하던 기능들이 정상동작하지 않는 문제가 발생했다.

일반적으로 Array.prototype.forEach 또는 Array.prototype.map을 사용하여 배열의 요소들을 다뤘는데, 공동으로 작업하다 보니 for (let i in array)와 같은 방법으로 처리한 코드가 존재했기 때문이다.

문제가 발생한 사항은 다음과 같다.

if(!Array.prototype.hasOwnProperty('fname')) {
    Array.prototype.fname = function(){} 
}

for (let i in [1, 2, 3]) {
    console.log(i)
}

위와 같은 코드를 입력하면 다음과 같은 결과를 예상할 것이다.

1
2
3

하지만 실제 결과는 다음과 같았다.

1
2
3
fname

왜 이런 일이 발생했는가 하니, for...in 문법은 object의 모든 property를 대상으로 순회를 하는데, Array.prototype.A = ... 식으로 공통 함수를 등록하게 될 경우에도 property 취급을 하기 때문이다.

for...in - JavaScript | MDN

for...in문은 상속된 열거 가능한 속성들을 포함하여 객체에서 문자열로 키가 지정된 모든 열거 가능한 속성에 대해 반복합니다. (Symbol로 키가 지정된 속성은 무시합니다.)

developer.mozilla.org

위의 개발문서에서 발견한 추가적인 문제 중 하나는 for...in 을 사용하게 될 경우 Array 내 index 순서 보장 되지 않아 개발자가 의도한 결과와 다른 결과가 도출될 수 있다고 한다.

이를 해결하기 위해 조치한 코드는 다음과 같다.

if(!Array.prototype.hasOwnProperty('fname')) {
    Object.defineProperty(Array.prototype, "fname", {
        enumerable: false,
        value: function() {}
    })
}

위와 같이 prototype에 property를 정의하면 더이상 for...in 에서 임의로 정의한 확장함수가 노출되는 경우는 발생하지 않는다.

다만, Array의 순회를 위해선 for...in 대신 Array.prototype.forEach 또는 Array.prototype.map 를 사용할 수 있도록 주의를 주어야 할 것 같다.

[NodeJS] Cannot read property 'Symbol(requestOptions)' of undefined

후유증 — Tue, 27 Sep 2022 17:47:29 +0900

서비스 배포를 준비하기 위해 개발서버 상에서 테스트를 수행하던 중 개발PC에선 보지 못한 오류를 발견했다.

_http_agent.js:444
      options = req[kRequestOptions];
                   ^

TypeError: Cannot read property 'Symbol(requestOptions)' of undefined
    at Agent.removeSocket (_http_agent.js:444:20)
    at TLSSocket.onClose (_http_agent.js:371:11)
    at TLSSocket.emit (events.js:327:22)
    at net.js:673:12
    at TCP.done (_tls_wrap.js:563:7)

원인을 다양한 방법으로 찾아보았으나, 원인을 파악하기 쉽지 않았다.

express의 res에서 데이터를 전달하는 방법을 res.send() 에서 res.write()로 바꿔 보는 등의 조치를 취했으나 전혀 오류가 해결되지 않았다.

방법은 어이없게 해결되었다.

NodeJS 13 ~ 14 버전 상에서 Object.prototype을 변경할 경우, 해당 문제가 발생 할 수 있다는 것이었다.

내 경우, Object에서 null인 항목을 모두 제거하는 동작의 처리를 위해 Object.prototype.removeNull 함수를 정의했는데,
이를 function removeNull(obj)로 변경하여 처리하였더니 더이상 해당 오류가 발생하지 않았다.

[gitlab] Create Merge Request 시 기본 branch명 변경

후유증 — Tue, 17 May 2022 14:56:25 +0900

기본적으로, gitlab의 issue에서 merge request를 생성할 때, 브랜치 명은 다음 규칙을 따른다.

{이슈번호}-{이슈명 축약}

이슈명의 경우, 한글로 작성할 경우 {이슈번호}- 로만 표기되는 경우도 잦고, 이슈만을 위한 branch를 찾기도 번거롭다.

따라서, branch명의 템플릿을 변경하는 방법에 대해 작성하고자 한다.

Merge Request branch name template 변경

embedded/service/gitlab-rails/app/models/issue.rb 파일의 to_branch_name 함수 변경

변경전

  def to_branch_name
    if self.confidential?
      "#{iid}-confidential-issue"
    else
      self.class.to_branch_name(iid, title)
    end
  end

변경후

  def to_branch_name
    if self.confidential?
      "#{iid}-confidential-issue"
    else
      #self.class.to_branch_name(iid, title)
      "issue/#{iid}"
    end
  end

이전버전

변경전

  def to_branch_name
    if self.confidential?
      "#{iid}-confidential-issue"
    else
      branch_name = "#{iid}-#{title.parameterize}" # 변경지점

      if branch_name.length > 100
        truncated_string = branch_name[0, 100]
        # Delete everything dangling after the last hyphen so as not to risk
        # existence of unintended words in the branch name due to mid-word split.
        branch_name = truncated_string[0, truncated_string.rindex("-")]
      end

      branch_name
    end
  end

변경후

  def to_branch_name
    if self.confidential?
      "#{iid}-confidential-issue"
    else
      branch_name = "issue/#{iid}"

      if branch_name.length > 100
        truncated_string = branch_name[0, 100]
        # Delete everything dangling after the last hyphen so as not to risk
        # existence of unintended words in the branch name due to mid-word split.
        branch_name = truncated_string[0, truncated_string.rindex("-")]
      end

      branch_name
    end
  end

변경 결과

변경 및 gitlab 서버를 재기동 후에 Create merge request의 drop down 메뉴를 열어보면 설정된 값으로 변환되어 있음을 확인할 수 있다.

기타 변수들을 잘 활용할 경우 issue/{이슈번호} 템플릿 외의 다른 템플릿을 적용하여 사용할 수 있을것으로 보인다.

gitlab을 업데이트 할 경우, 해당 변경 사항이 원상복귀 될 것으로 보이는데, 해당 부분은 차기 버전에서 설정으로 변경 가능하도록 적용해줬으면 한다.

2023.07.20 - 추가

Configure branch name for creating MR from an issue (!93108) · Merge requests · GitLab.org / GitLab · GitLab

What does this MR do and why? A user can create a branch from an issue:

gitlab.com

언제인지 모를 시점에 각 Repository의 branch name을 설정할 수 있는 기능이 GitLab에 merge 되었다.

Settings > Repository의 branch defaults 항목에 위에 첨부된 이미지와 같은 설정이 추가되었다.

issue/%{id} 와 같은 방법으로 설정하면, template가 적용된다.

issue.rb 에서 to_branch_name을 조작하였다면, 내부에서 Template 적용 로직이 수행되지 않아 branch name 설정 기능이 동작하지 않는다.
현재는, Admin Area 또는 Group 에서 전역적인 설정을 할 수 없고 각 Repository에서 개별 설정을 해야 한다.

[QT] Windows에서 QOCI (Oricle DB) Driver 빌드

후유증 — Fri, 10 Sep 2021 11:00:18 +0900

[Programming/QT] - [QT] CentOS 7 환경에서 QOCI (Oracle DB) Driver 빌드

[QT] CentOS 7 환경에서 QOCI (Oracle DB) Driver 빌드

필수 환경 QT 설치 QT 공식홈페이지 에서 QT를 다운로드 받아 설치한다. 설치 과정 중 필수로 Source 를 선택하여 QT소스코드가 함께 설치되도록한다. 본 게시글에서는 QT 5.9.1 버전을 사용한다. 설치

blog.rixa.kr

이전 포스팅에서는, QOCI 드라이버의 빌드를 CentOS 7 환경에서 진행하는 것으로 작성하였다.

이번 포스팅에서는 Windows에서 QOCI 빌드를 하는 법을 설명하려 한다.

필수 환경

QT 설치

QT 공식홈페이지 에서 QT를 다운로드 받아 설치한다.

설치 과정 중 필수로 Source 를 선택하여 QT소스코드가 함께 설치되도록한다.

본 게시글에서는 QT 5.9.1 버전을 사용한다.

빌드 환경으로는 MinGW 32bit를 사용하고있다.

Oracle SDK

Oracle Instant Client 에서 Oracle Instant Client를 다운받는다.

Basic Package (ZIP)
SDK Package (ZIP)
본 게시글에서는 19.12 버전(x86)을 사용하였다.

' Windows가 64bit를 사용하고 있더라도, Qt 설치시 MinGW를 32bit용으로 설치하였을 경우, 32bit용 라이브러리르 사용해야 한다.

해당 파일의 압축 해제는 "D:\tmp\instant-client" 에 했다.

빌드

sqldriver의 소스코드가 위치한 경로로 이동한다

QT설치경로\5.9.1\Src\qtbase\src\plugins\sqldrivers\plugins\sqldrivers

해당 경로에 대해 CMd창을 실행한 뒤 아래 명령어를 입력한다.

qmake -- OCI_INCDIR="D:\tmp\instant-client\instantclient_19_12_x86\sdk\include" OCI_LIBDIR="D:\tmp\instant-client\instantclient_19_12_x86\sdk\lib\msvc"

위의 경로는 본인의 환경에 따라 적절히 수정해주면 되며, OCI_INCDIR은 instant-client의 include 경로를, OCI_LIBDIR은 instant-client의 oci.lib 파일이 위치한 경로를 입력하면 된다.

위의 명령어를 입력하면 아래와 같은 내용이 표출된다.

Running configuration tests...
Checking for DB2 (IBM)... no
Checking for InterBase... no
Checking for MySQL... no
Checking for OCI (Oracle)... yes
Checking for ODBC... yes
Checking for PostgreSQL... no
Checking for SQLite (version 2)... no
Checking for TDS (Sybase)... no
Done running configuration tests.

Configure summary:

Qt Sql:
  DB2 (IBM) .............................. no
  InterBase .............................. no
  MySql .................................. no
  OCI (Oracle) ........................... yes
  ODBC ................................... yes
  PostgreSQL ............................. no
  SQLite2 ................................ no
  SQLite ................................. yes
    Using system provided SQLite ......... no
  TDS (Sybase) ........................... no

다른 부분은 신경쓰지 않아도 되고, OCI (Oracle)이 "yes" 인 것만 확인하면 되며, "no"가 뜰 경우 경로를 다시 확인하고, config.cache 파일을 삭제한 뒤 다시 명령어를 입력한다.

위 과정까지 완료되었을 경우, mingw32-make 명령어를 실행해 컴파일을 실행한다.

결과물

빌드 실행 결과물로, plugins\sqldrivers\qsqloci.dll 및 plugins\sqldrivers\qsqlocid.dll이 생성되면 컴파일에 성공하였다.

[QT] QOCI를 이용한 CLOB 데이터 insert중 ORA-03113 (EOF) 오류 발생 대처법

후유증 — Wed, 30 Jun 2021 16:40:06 +0900

오류 발생

긴 길이의 QString 데이터를 CLOB column에 insert 하자, ORA-03113 "end of file on communication channel" 오류가 발생하였다.

Master Note: Troubleshooting ORA-03113

Master Note: Troubleshooting ORA-03113 (Doc ID 1506805.1) Last updated on MARCH 12, 2021 Applies to: Oracle Database Exadata Express Cloud Service - Version N/A and later Oracle Database Cloud Service - Version N/A and later Oracle Database - Enterprise Ed

support.oracle.com

원인 파악

ORA-03113과 관련된 문서를 찾아보니, 현재 상황과 맞는 뚜렷한 원인을 파악하기 힘들었다.
오류가 발생한 쿼리를 조사해 본 결과 CLOB column에 data insert를 하는 쿼리가 동작하는 부분이었다.

해당 부분은 아래와 같이 QSqlQuery를 통해 prepared statement를 통하여 string을 CLOB Column에 insert(또는 update) 하는 로직이다.

QString text = "blah~ blah~~~~ ...."; // 긴 길이의 텍스트

QSqlQuery query(m_db);
query.prepare("insert into A(longdata) values(:longdata)");
query.bindValue(":longdata", QVariant(text));

query.exec();

위와 같이 prepared statement를 정의하고, data를 bind한 뒤, 쿼리를 실행해본 결과 처음 몇개의 쿼리는 정상적으로 INSERT 되었으나, 어느순간부터 ORA-03113 에러 발생 후 ORA-03114(Not connected to Oracle) 메시지가 지속적으로 발생하였다.

지속적으로 디버깅 한 결과, String의 길이가 일정이상 늘어나게 되면 해당 부분에서 오류가 발생하는 것이다.

문제 해결

혹시나 놓치고 있는 부분이 무엇인지 찾기위해 다음과 같은 행위를 수행했다.

Column의 Type 변경 (CLOB -> LONG)
- 하나의 테이블에 하나의 LONG 컬럼만 정의 가능
Query 실행 로직 변경
- 뚜렷한 방안을 찾기 어려움
SQL 문에서 insert시 CLOB을 별도로 처리해야하는가?
- (정답) to_clob을 사용

여러 행위를 수행해본 결과, insert 시에 data를 clob형으로 변경하여 수행할 경우 문제 없이 데이터가 insert되는것을 확인하였다.

#이전 query
insert into A(longdata) values(:longdata)
#수정후 query
insert into A(longdata) values(to_clob(:longdata))

결론

정확한 해결 방안인지는 모르겠으나 insert 또는 update를 수행할 때 길이가 긴 string을 바로 bind해서 처리할 경우 EOF문제가 발생하며, 이를 해결하기 위해 to_clob을 사용하여 형변환이 필요하다.

또한 CLOB 데이터를 사용하기 위해 별도로 코드를 변경할 필요가 없었다.

[Oracle] Key 중복 시 insert 대신 update 처리 (merge into)

후유증 — Wed, 30 Jun 2021 16:11:00 +0900

테이블에서 중복값 방지를 위한 contraint가 걸려있을 경우, 중복 키값을 가진 row를 insert 하면 오류가 발생한다.

따라서 일반적인 방법으로는 insert를 하기 전 중복된 키를 가진 값이 이미 table에 존재하는지를 파악하고, 이미 존재할 경우 update를 하도록 구현하여아 한다.

하지만, 중복키 여부를 확인하기 위한 로직을 작성하지 않고도 쿼리 하나로 insert 또는 update를 수행하도록 설정할 수 있는 방법이 존재한다.

Oracle 공식 Document 를 참고하면, INSERT ON DUPLICATE KEY UPDATE 구문을 통해 처리할 수 있음을 확인할 수 있다.

MERGE

Prerequisites You must have the INSERT and UPDATE object privileges on the target table and the SELECT object privilege on the source table. To specify the DELETE clause of the merge_update_clause, you must also have the DELETE object privilege on the targ

docs.oracle.com

Syntax

MERGE INTO table_name
            USING (table | view | subquery) alias
                 ON (join condition)                                    
            WHEN MATCHED THEN
                     UPDATE SET col1 = val1[, ...]
            WHEN NOT MATCHED THEN
                     INSERT (column lists) VALUES (values);

예제

아래 SQL은 ID, NAME, BIRTH 세 column을 가지며, PK로 ID설정된 테이블 P가 있다고 가정할 때

MERGE INTO P
    USING dual
        ON (ID = 'AAA')
    WHEN NOT MATCHED THEN
        INSERT (ID, NAME, BIRTH)
        VALUES 'AAA', '홍길동', '2000-01-01')
    WHEN MATCHED THEN
        UPDATE SET
            NAME='홍길동',
            BIRTH='2000-01-01'

위와 같은 쿼리를 작성할 수 있다.

ID가 'AAA'인 데이터가 없을 경우 (NOT MATCHED) INSERT를 통해 ID가 'AAA' 이며, NAME이 '홍길동', BIRTH가 '2000-01-01' 인 데이터가 삽입된다.

또한 이미 'AAA'인 데이터가 존재할 경우 (MATCHED), UPDATE를 통해 NAME을 '홍길동', BIRTH를 _'2000-01-01'_로 설정하며, 이외의 값은 유지한다.

타 DBMS

[MariaDB] Key 중복 시 insert 대신 update 처리 (INSERT ON DUPLICATE KEY UPDATE)

테이블에서 중복값 방지를 위한 contraint가 걸려있을 경우, 중복 키값을 가진 row를 insert 하면 오류가 발생한다. 따라서 일반적인 방법으로는 insert를 하기 전 중복된 키를 가진 값이 이미 table에 존

blog.rixa.kr

[MariaDB] Key 중복 시 insert 대신 update 처리 (INSERT ON DUPLICATE KEY UPDATE)

후유증 — Wed, 30 Jun 2021 14:05:46 +0900

테이블에서 중복값 방지를 위한 contraint가 걸려있을 경우, 중복 키값을 가진 row를 insert 하면 오류가 발생한다.

하지만, 중복키 여부를 확인하기 위한 로직을 작성하지 않고도 쿼리 하나로 insert 또는 update를 수행하도록 설정할 수 있는 방법이 존재한다.

MariaDB 공식 Document 를 참고하면, INSERT ON DUPLICATE KEY UPDATE 구문을 통해 처리할 수 있음을 확인할 수 있다.

INSERT ON DUPLICATE KEY UPDATE

INSERT if no duplicate key is found, otherwise UPDATE

mariadb.com

Syntax

INSERT [LOW_PRIORITY | DELAYED | HIGH_PRIORITY] [IGNORE]
  [INTO] tbl_name [PARTITION (partition_list)] [(col,...)]
  {VALUES | VALUE} ({expr | DEFAULT},...),(...),...
  [ ON DUPLICATE KEY UPDATE
    col=expr
      [, col=expr] ... ]

예제

아래 SQL은 ID, NAME, BIRTH 세 column을 가지며, PK로 ID설정된 테이블 P가 있다고 가정할 때

INSERT INTO P(ID, NAME, BIRTH) values('AAA', '홍길동', '2000-01-01')
ON DUPLICATE KEY UPDATE
    NAME='홍길동',
    BIRTH='2000-01-01'

위와 같은 쿼리를 작성할 수 있다.

ID가 'AAA'인 데이터가 없을 경우 INSERT를 통해 ID가 'AAA' 이며, NAME이 '홍길동', BIRTH가 '2000-01-01' 인 데이터가 삽입된다.

또한 이미 'AAA'인 데이터가 존재할 경우, UPDATE를 통해 NAME을 '홍길동', BIRTH를 '2000-01-01'로 설정하며, 이외의 값은 유지한다.

[QT] CentOS 7 환경에서 QOCI (Oracle DB) Driver 빌드

후유증 — Mon, 28 Jun 2021 18:34:54 +0900

필수 환경

QT 설치

QT 공식홈페이지 에서 QT를 다운로드 받아 설치한다.

설치 과정 중 필수로 Source 를 선택하여 QT소스코드가 함께 설치되도록한다.

본 게시글에서는 QT 5.9.1 버전을 사용한다.

설치 경로는 /opt/Qt5.9.1 이다.

Oracle SDK

Oracle Instant Client 에서 Oracle Instant Client를 다운받는다.

Basic Package (ZIP)
SDK Package (ZIP)

본 게시글에서는 21.1.0.0.0 버전을 사용하였다.

Basic Package는 /opt/instantclient, SDK Package 는 opt/instantclient/sdk 에 압축 해제 하였다.

빌드

OCI의 소스코드가 위치한 경로로 이동한다.

cd /opt/Qt5.9.1/5.9.1/Src/qtbase/src/plugins/sqldrivers/oci

이동 후, oci.pro 파일의 내용을 수정한다.

TARGET = qsqloci

HEADERS += $$PWD/qsql_oci_p.h
SOURCES += $$PWD/qsql_oci.cpp $$PWD/main.cpp


#QMAKE_USE += oci

darwin:QMAKE_LFLAGS += -Wl,-flat_namespace,-U,_environ

OTHER_FILES += oci.json

PLUGIN_CLASS_NAME = QOCIDriverPlugin

CONFIG += c++11
INCLUDEPATH += /opt/instantclient/sdk/include
DEPENDPATH += /opt/instantclient/
LIBS += -L"/opt/instantclient" -lclntsh


include(../qsqldriverbase.pri)

MakeFile을 생성한다.

qmake

CentOS 7의 기본 GCC 버전이 4.8이므로, 바로 빌드 시 -Wdate-time 및 c++1z 오류가 발생한다.

g++: error: unrecognized command line option '-std=c++1z' g++: error: unrecognized command line option '-Wdate-time'

따라서, MakeFile 의 내용을 수정한다

c++1z -> c++11
-Wdate-time -> `` (제거)

이후, 빌드를 수행한다.

make

빌드 로그가 콘솔에 출력되며, 빌드 성공 시 ../plguins/sqldrivers/(/opt/Qt5.9.1/5.9.1/Src/qtbase/src/plugins/sqldrivers/plugins/sqldrivers) 폴더에 libqsqloci.so 파일이 생성된다.

생성된 libqsqloci.so 파일을 추가한다.

cd /opt/Qt5.9.1/5.9.1/Src/qtbase/src/plugins/sqldrivers/plugins/sqldrivers
cp libqsqloci.so /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers

테스트

OCI의 설치가 완료되면, 테스트용 프로젝트를 생성하여 빌드 후 테스트를 진행한다.

프로젝트 파일

oratest.tar.gz

503 B

test.cpp*

#include <QtSql>

int main() {
    QSqlDatabase mes_db;
        mes_db = QSqlDatabase::addDatabase("QOCI","TEST");
        mes_db .setHostName("localhost");
        mes_db .setPort(1521);
        mes_db .setUserName("test");
        mes_db .setPassword("test");
        mes_db .setDatabaseName("orcl");
        if(!mes_db .open()){
            qDebug()<<"open false";
        }else {
            qDebug()<<"open db";
        }

}

첨부된 압축파일의 압축 해제 후, test.cpp에서, oracle의 접속정보를 현재 설정된 상태와 맞게 변경 한 뒤, 빌드 및 실행한다.

open db 가 출력되면, 정상적으로 작업이 완료되었음을 의미하며, open false 출력 시 접속 정보가 잘못되었음을 의미한다.

Plugin이 잘 로드되었는지 확인하기 위해선, 아래 사진과 같이 Run Environment에 QT_DEBUG_PLUGINS 를 1로 설정한다.

실행결과

QFactoryLoader::QFactoryLoader() checking directory path "/usr/lib64/kde4/plugins/sqldrivers" ...
QFactoryLoader::QFactoryLoader() checking directory path "/usr/lib/kde4/plugins/sqldrivers" ...
QFactoryLoader::QFactoryLoader() checking directory path "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers" ...
QFactoryLoader::QFactoryLoader() looking at "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlite.so"
Found metadata in lib /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlite.so, metadata=
{
    "IID": "org.qt-project.Qt.QSqlDriverFactoryInterface",
    "MetaData": {
        "Keys": [
            "QSQLITE"
        ]
    },
    "className": "QSQLiteDriverPlugin",
    "debug": false,
    "version": 329985
}


Got keys from plugin meta data ("QSQLITE")
QFactoryLoader::QFactoryLoader() looking at "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlmysql.so"
Found metadata in lib /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlmysql.so, metadata=
{
    "IID": "org.qt-project.Qt.QSqlDriverFactoryInterface",
    "MetaData": {
        "Keys": [
            "QMYSQL3",
            "QMYSQL"
        ]
    },
    "className": "QMYSQLDriverPlugin",
    "debug": false,
    "version": 329985
}


Got keys from plugin meta data ("QMYSQL3", "QMYSQL")
QFactoryLoader::QFactoryLoader() looking at "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqloci.so"
Found metadata in lib /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqloci.so, metadata=
{
    "IID": "org.qt-project.Qt.QSqlDriverFactoryInterface",
    "MetaData": {
        "Keys": [
            "QOCI8",
            "QOCI"
        ]
    },
    "className": "QOCIDriverPlugin",
    "debug": false,
    "version": 329985
}


Got keys from plugin meta data ("QOCI8", "QOCI")
QFactoryLoader::QFactoryLoader() looking at "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlpsql.so"
Found metadata in lib /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlpsql.so, metadata=
{
    "IID": "org.qt-project.Qt.QSqlDriverFactoryInterface",
    "MetaData": {
        "Keys": [
            "QPSQL7",
            "QPSQL"
        ]
    },
    "className": "QPSQLDriverPlugin",
    "debug": false,
    "version": 329985
}


Got keys from plugin meta data ("QPSQL7", "QPSQL")
loaded library "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqloci.so"
open db
QLibraryPrivate::unload succeeded on "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqloci.so"

위와 같이

Got keys from plugin meta data ("QOCI8", "QOCI")
QFactoryLoader::QFactoryLoader() looking at "/opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlpsql.so"
Found metadata in lib /opt/Qt5.9.1/5.9.1/gcc_64/plugins/sqldrivers/libqsqlpsql.so, metadata=
{
    "IID": "org.qt-project.Qt.QSqlDriverFactoryInterface",
    "MetaData": {
        "Keys": [
            "QPSQL7",
            "QPSQL"
        ]
    },
    "className": "QPSQLDriverPlugin",
    "debug": false,
    "version": 329985
}

QOCI 관련 메시지가 출력되면, 정상적으로 Driver가 로드된 것이다.

NET::ERR_CERT_DATE_INVALID 해결법

후유증 — Thu, 4 Jun 2020 00:17:34 +0900

자취방을 이사하게 된 후, 갑작스럽게 많은 사이트들이 접속이 불가능한 오류가 발생했다.

위 사진과 쿠팡, 네이버 등을 포함한 많은 사이트들에 접속할 시 위와 같은 오류 메시지를 출력했다.

이 오류 메시지는 NET::ERR_CERT_DATE_INVALID로 SSL을 사용중인 많은 사이트들에 접근이 제한된 것이다.

해결방법을 찾던 중 루트 인증서가 자동으로 업데이트 되지 않아 발생 한 것이다는 글을 보게 되었고, 이를 참고하여 오류를 수정하였다.

수정 방법은 다음과 같다.

1. 레지스트리 편집기를 실행한다.

시작 -> 실행 (Windows + R) -> regedit

2. 실행된 레지스트리 편집기에서 HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\SystemCertificates\AuthRoot 를 찾는다.

상단의 주소줄에 입력후 엔터를 치면 된다.

3. DisableRootAutoUpdate 의 값을 0으로 변경한다.

위의 항목을 보면 값이 1로 설정되어 있을 것이다. 이 항목을 더블클릭 하여 아래와 같은 창이 나오면

값을 0으로 변경 후 확인 을 클릭한다.

4. 재부팅

위의 과정을 수행하면 루트 인증서가 자동 업데이트 되며, 설정 이후부터 오류 메시지 없이 정상 작동이 됨을 확인할 수 있다.

[CentOS] Gnome 설정화면을 X11 forwarding 에서 실행하기

후유증 — Tue, 2 Jun 2020 13:25:06 +0900

ssh를 X11 forwarding 상태로 실행 후 아래의 명령어를 입력하면 Gnome control center가 실행된다.

env XDG_CURRENT_DESKTOP=GNOME gnome-control-center

Display등의 설정은 불가능하지만 다른 설정들은 가능하다.

[CentOS 7] Gnome환경에서 ssh를 이용하여 Display 항상 켜기로 설정

후유증 — Tue, 2 Jun 2020 11:08:19 +0900

gsettings set org.gnome.desktop.session idle-delay 0
gsettings set org.gnome.desktop.screensaver lock-enabled false

[Git] Remote에서 삭제된 Branch, Local에서도 제거하기

후유증 — Wed, 29 Apr 2020 16:14:09 +0900

일반적으로, pull 또는 fetch 명령어를 통해 가져온 Remote branch 정보는 Remote에서 삭제 되더라도 계속해서 리스트에서 제거되지 않는다.

따라서 이를 제거하기 위해 일반적으로는 git fetch --prune 명령어를 통해 삭제된 branch를 리스트에서 제거하는 작업을 수행한다.

하지만 이와 같은 동작은 Remote branch의 정보만 업데이트하며, checkout된 local branch 목록에서는 지워지지 않는다.

이를 해결하기 위해선 아래와 같은 명령어를 실행하면 손쉽게 해결할 수 있다.

git branch -r |
awk '{print $1}' |
egrep -v -f /dev/fd/0 <(git branch -vv | grep origin) |
awk '{print $1}' |
xargs git branch -d

위의 명령어 입력 시 삭제된 branch의 명단이 나타나며 자동으로 checkout 된 branch가 삭제된다.

CentOS + QTCreator 환경에서 Distcc 빌드 설정하기

후유증 — Wed, 8 Apr 2020 11:13:12 +0900

CentOS 환경에서 QT와 CPP를 이용하여 프로젝트를 개발하고 있다. 프로그램의 규모가 커진 만큼 프로젝트를 빌드하기 위해 많은 시간이 소요되며, 빌드 과정중에 CPU 및 Memory 소모량 역시 증가했다.

또한 각 프로그램이 구동되기 위해 필요한 프로그램 들도 Memory 점유율이 높은 상태여서 개발 PC의 Memory가 항상 부족한 상태다.

이러한 상황에서 테스트 및 기능 수정 도중 빌드를 시작하면 시스템이 다운되고, 재부팅을 해야 하는 등의 문제가 많은 상태다.

빌드에 소요되는 시간 및 메모리 점유율을 낮추기 위해 윈도우에서 많이 사용되는 IncrediBuild와 같은 솔루션의 리눅스판을 찾아 보았고, distcc라는 훌륭한 프로그램을 발견했다.

해당 프로그램에 대한 설명은 주로 cmake와 관련되어 설명이 되어있고, QT Creator에서 바로 사용하는 방법에 대한 자료를 찾지 못하였고, 많은 시행착오 끝에 정리된 과정을 글로 남기기로 하였다.

본 게시글은 CentOS 7.X 환경에 QTCreator와 Development Tool이 설치되어있다고 가정하고 작성하였다.

0. Distcc 정의

Client : 빌드 요청을 하는 개발PC

Server : 빌드 요청을 수신하여 빌드를 수행하는 PC

1. Distcc 설치하기.

아래의 명령어를 통해 Distcc를 설치한다.

sudo yum install "distcc*"

위의 명령을 통해 distcc와 관련된 모든 프로그램(distcc, distcc server, distcc monitor)을 설치해 준다.

2. Server 설정하기

먼저, /etc/sysconfig/distccd를 수정하여 허용할 host 및 core수 등을 설정한다.

### See distcc(1) manual page for more information on these options.
###

USER="distcc"

### Set this if don't want distccd to use gcc or g++ by accident.
#DISTCCPATH="/usr/lib/distcc/bin"
OPTIONS="--nice (우선순위) --jobs (코어수) --allow 192.168.0.0/24"

위의 예시에서 --allow 옵션이 요청을 허용할 host의 ip범위이다. 위의 예제는 192.168.0.X 대역의 모든 요청을 허용한다는 의미다.

만일 단일 IP만 허용하고 싶으면 --allow IP로 설정하면 되며, 여러개의 IP를 설정하고 싶으면 --allow IP를 여러번 반복 입력해주면 된다.

--port 포트번호 옵션을 추가해 주면 distcc의 포트 번호도 변경 가능하다.

설정이 완료되면 데몬을 추가하고 실행해 준다.

sudo systemctl enable distccd
sudo systemctl start distccd

위의 명령어 까지 실행하면, Distcc 서버의 설정은 완료되었다.

distcc서버 역할을 할 pc가 많을 경우 여러 대의 서버에 위의 설정을 추가해주면 된다.

3. Client 설정하기

client는 빌드 요청을 할 server의 목록을 /etrc/distcc/hosts 파일에 서버마다 하나의 라인으로 HOST:PORT/JOB 형식으로 추가하면 된다.

아래 예시는 다음과 같은 시나리오에 대한 예시다.

서버 종류
- 192.168.0.1
- 192.168.0.2
- 192.168.0.3
  - 포트 번호 재설정 : 1234
- local PC는 빌드에 사용하지 않음
각 서버에 Job을 10개씩 할당

192.168.0.1/10
192.168.0.2/10
192.168.0.3:1234/10

위와 같이 설정이 완료되면 distcc --show-hosts 명령어를 통해 설정이 잘 되었는지 확인이 가능하다.

4. QT Creator 설정

QT Creator에서 간단한 설정을 통해 distcc를 이용한 빌드 수행이 가능하다.

먼저, 현재 개발중인 프로젝트를 불러온 뒤, 좌측의 Projects 탭으로 이동한 뒤 Build & Run 하단의 Build 를 선택한다.

Build Steps의 Make에 Details를 클릭한다.

그럼 위와 같은 부분이 확장되며 나타나는데, Make argumentws: 항목에

-j (Job수) CXX="distcc g++" CC="distcc gcc" 를 입력한다.

그 후 빌드를 수행하면 distcc를 이용한 분산 빌드가 수행된다.

5. Distcc 작동 확인

과정 1 에서 설치한 distcc monitor를 이용하여 빌드 상태 확인이 가능하다.

distccmon-gnome 명령어를 이용하여 모니터 프로그램을 실행한다.

그 후 빌드를 수행한다.

(파일 및 IP일부는 제거하였습니다.)

빌드를 수행하는 순간, 연결된 각 host의 build 상태가 표기된다.

distcc를 사용해본 결과 전체 rebuild 속도가 상당히 빨라졌다. 또한 build에 리소스를 많이 사용하여 시스템이 멈추는 현상도 감소했다.

[Git] 실수로 날린 Branch의 Commit 복구하기

후유증 — Fri, 6 Dec 2019 14:17:48 +0900

최근 Remote의 Branch를 제거하던 중 아직 개발중인 Branch를 삭제하는 일이 발생했다.

다행히 해당 Branch에 대해 Merge Request를 생성해서 관리하고 있었고, 이에 대한 Commit hash 기록이 남아있어 일부 복구가 가능했다.

하지만, 미처 기록이 남지 않은 커밋이 있었고, 이를 복구하기위해 여러가지 방안을 찾아보았고, 아래의 방법을 사용하면 쉽게 찾을 수 있었다.

git reflog | awk '{ print $1 }' | xargs gitk

위의 명령어는 최근 60일 이내의 log를 다시 볼 수 있었고, 이를 통해 Commit 정보를 받아와 gitk를 이용해 최근 Commit Log를 Graph화 하여 볼 수 있었다.

앞으로는 삭제할 때 조금 더 신중히 해야겠다.

[CentOS] 최신 버전의 Git으로 업데이트 하기

후유증 — Wed, 17 Jul 2019 09:51:34 +0900

CentOS 7.X 버전에서는 git이 1.8 버전으로 설치가 되어있다.

하지만, VSCode나 깃의 최신 버전을 이용함에 있어 여러가지 불편사항이 존재한다.

이를 해결하기 위해 git 최신버전을 설치하는 방법을 작성하고자 한다.

git을 업데이트 하기 위해, 최신버전의 git이 저장되어 있는 저장소를 시스템에 추가한다.

rpm -Uvh http://opensource.wandisco.com/centos/7/git/x86_64/wandisco-git-release-7-2.noarch.rpm

그 후 yum을 이용해 git의 최신버전을 설치한다.

yum update git

위의 명령어를 입력할 경우 git의 종속 모듈을 포함하여 최신 버전의 git이 설치된다.

그 이후 아래의 명령어를 입력하면 최신 버전의 깃이 설치된 것을 확인할 수 있다.

git --version

[Git] Sub directory를 새 저장소에 옮기고 sub module로 변경하기

후유증 — Thu, 4 Jul 2019 17:20:09 +0900

코드를 관리하면서, 여러 프로젝트에서 동일한 코드를 사용하게 되는 경우가 종종 발생한다. 이러한 상황이 발생하게 될 경우 보통은 코드의 복사/붙여넣기를 통해 코드를 관리하게 된다.

이러한 복사/붙여넣기 방식은 코드 관리에 어려움을 겪게 될 수 있는데, 어떤 프로젝트에는 반영된 부분이 다른 프로젝트에는 반영이 되거나 누락되는 경우가 흔히 발생하게 된다.

이러한 부분은 git을 사용할 경우 공통된 부분의 코드에 대해 sub module 기능을 이용하여 분리하게 될 경우 편리하게 개선 할 수 있다.

sub module이란 파일을 직접 갖는게 아니라 다른 코드 저장소(repository)에 있는 코드를 링크만 하는 방식이다. 이러한 특성을 이용하여 공통된 부분을 폴더로 분리하고 별도의 저장소로 분리한 뒤 해당 모듈을 사용하는 프로젝트에서 간단히 submodule로 추가만 할 경우 공통 부분에 대해 별도의 코드 관리를 거치지 않아도 변경이력을 관리할 수 있으며, 다른 프로젝트에도 손쉽게 적용할 수 있다.

Sub Module을 사용하기에 앞서, 예제에 사용될 Project의 상황에 대해 다음과 같은 가정을 한다.

- Project는 A, B 가 존재하며, 서로 다른 저장소에 저장되어있다.
- Local에서 /code/A, /code/B에 clone하여 사용하고 있는 상태이다.
- Project A, B는 http://server.git/A, http://server.git/B 저장소에 저장되어 있다.
- Project A 및 B에서 module/XmlReader 라는 공통의 폴더를 갖고 있으며, 동시에 사용 중이다.
- Project A, B의 module/XmlReader는 코드가 동일한 상태이다.
- module/XmlReader의 코드를 분리하여 http://server.git/XmlReader 저장소에 저장한다.

본문에서는 예제에서 이 XmlReader를 새 저장소로 분리하고, Submodule로 A, B에 추가하는 방법에 대해 작성할 것이다.

1. 공통 코드 쪼개기

코드를 쪼개는 순서는 다음과 같이 진행된다.

subtree로 branch 쪼개기 -> branch를 저장소에 push

공통 코드인 XmlReader를 쪼개기 위해 directory의 코드를 분리하여 local branch에 옮긴다.

cd /code/A
git subtree split -P module/XmlReader -b tmp_XmlReader

위의 명령어의 결과로 A 프로젝트의 module/XmlReader 폴더의 하위에 있는 코드 및 파일들이 branch tmp_XmlReader로 분리된다.

branch로 분리가 되었으면 XmlReader의 저장소를 A프로젝트의 원격 저장소로 추가한다.

git remote add proj_XmlReader http://server.git/XmlReader

위의 명령어의 결과로 A 프로젝트에 XmlReader의 원격 저장소를 proj_XmlReader로 추가된다.

이제, Remote 저장소에 XmlReader의 코드들을 push 한다.

git push proj_XmlReader tmp_XmlReader:master

위의 명령어를 통해 XmlReader 저장소의 master 브랜치로 첫번째 단계에서 분리한 branch tmp_XmlReader를 전송하였다.

이를 통해 Project A의 코드 중 XmlReader에 대한 코드가 별도의 저장소에 분리가 되었다.

2. 공통 코드를 Sub module로 처리하기

코드를 쪼갰지만, 아직까지는 Project A 및 B에 module/XmlReader에 코드가 그대로 있는 상태다.

이를 개선하기 위해 기존의 파일을 제거하고 Sub module로 처리 한다.

먼저, Project A및 B 에서 파일을 지워준다.

cd /code/A
rm -rf module/XmlReader
cd /code/B
rm -rf module/XmlReader

그 다음 각 project에 sub module로 XmlReader를 추가한다.

cd /code/A
git submodule add http://server.git/XmlReader module/XmlReader
cd /code/B
git submodule add http://server.git/XmlReader module/XmlReader

위의 명령어를 통해 A 및 B에 submodule이 생성되었다.

마지막으로, submodule 처리에 대한 커밋을 수행한다.

cd /code/A
git commit -m 'replaced module/XmlReader with a submodule'
cd /code/B
git commit -m 'replaced module/XmlReader with a submodule'

이 과정을 통해 공통 코드를 submodule로 관리할 수 있게 되었다.

위의 과정을 통해 Submodule로 분리하였지만, 여러 이유를 통해 Project A 및 B를 clone할 경우 submodule에 대한 코드를 clone하지 않는다.

이는 sub module은 별도의 repository기 때문에 사용자가 직접 init/update를 해줘야 한다.

하지만 명령어에 --recurse-submodules 옵션을 추가하여 자동으로 처리되도록 할 수 있다.

git clone --recurse-submodules http://server.git/A

위와 같은 방법으로 코드를 쪼개고, 별도의 저장소로 분리를 하는 과정은 귀찮을 수 있지만 한번 적용하고 사용하게 될 경우 코드 관리를 함에 있어 신경써야 할 부분이 줄게 되어 편리해 질 수 있다.

참고자료 : https://coderwall.com/p/a3a5xg/splitting-a-project-sub-directory-to-a-new-git-repo

[svn] svn code export : svn에서 코드를 export 해오기

후유증 — Fri, 28 Jun 2019 15:41:59 +0900

svn을 사용하다보면 github에서 zip download와 유사하게 코드의 수정 이력과 같은 정보 없이 데이터만을 export (download) 가져올 경우가 종종 존재한다.

이러한 동작을 위해 svn에서는 export 라는 기능을 제공하고 있으며, 필요시 특정 revision에 대한 코드만을 가져올 수도 있다.

svn export에 대한 help 정보는 아래와 같다.

export: 버전관리 정보 없는 깨끗한 사본을 받아옵니다.
사용법: 1. export [-r REV] URL[@PEGREV] [PATH]
       2. export [-r REV] PATH1[@PEGREV] [PATH2]

  1. 리비전 REV에 해당하는 URL 의 내용을 PATH에 받아 옵니다.
     만약 REV가 지정되지 않으면 HEAD(최신 리비전)를 받아 옵니다.
     PATH가 생략되면 URL의 마지막 요소를 받아올 디렉토리 이름으로
     사용합니다.

  2. 리비전 REV에 해당하는 PATH1으로 지정된 작업 사본의 내용을
     PATH2에 받아옵니다. REV 가 생략되면 현재 작업중인 내용을 그대로
     받아 옵니다. PATH2가 생략되면 PATH1의 마지막 요소를 디렉토리
     이름으로 사용합니다. REV가 생략될 경우 작업 중에 변경된 내용은 그대로
     유지되며, 버전 관리 대상이 아닌 파일들은 복사되지 않습니다.

  PEGREV가 지정될 경우엔, 어떤 리비젼에서 대상을 먼저 찾을지 결정합니다.


옵션:
  -r [--revision] ARG      : ARG (어떤 명령은 ARG1:ARG2 와 같은 범위를 사용)
                             리비전은 다음 중 하나가 될 수 있습니다:
                                NUMBER       리비전 번호
                                '{' DATE '}' 리비전이 시작하는 시각
                                'HEAD'       저장소의 마지막 리비전
                                'BASE'       작업 사본을 꺼내온 리비전
                                'COMMITTED'  BASE 이전에 마지막 커밋된 리비전
                                'PREV'       COMMITTED 의 직전 리비전
  -q [--quiet]             : 아무것도 출력하지 않거나, 요약 정보만 출력합니다
  -N [--non-recursive]     : 사용금지; 대신 --depth=files, --depth=immediates를 이용합니다
  --depth ARG              : 명령 적용 대상의 깊이를 제한 합니다 ('empty', 'files'
                             'emmediates', 'infinity')
  --force                  : 강제로 실행합니다
  --native-eol ARG         : 행종료문자를 표준 시스템 문자가 아닌
                            파일의 svn:eol-style 속성을
                            'native'로 두어 다른 것을 사용합니다.
                            ARG는 'LF', 'CR', 'CRLF' 중의 하나가 될 수 있습니다
  --ignore-externals       : 외부 모듈(svn:externals로 지정된)은 무시합니다
  --ignore-keywords        : 내용중의 키워드를 치환하지 않습니다

글로벌 옵션:
  --username ARG           : ARG를 접속에 필요한 사용자 ID로 사용합니다
  --password ARG           : specify a password ARG (caution: on many operating
                             systems, other users will be able to see this)
  --no-auth-cache          : 인증 정보를 캐시에 저장하지 않습니다
  --non-interactive        : do no interactive prompting (default is to prompt
                             only if standard input is a terminal device)
  --force-interactive      : do interactive prompting even if standard input
                             is not a terminal device
  --trust-server-cert      : deprecated; same as
                             --trust-server-cert-failures=unknown-ca
  --trust-server-cert-failures ARG : with --non-interactive, accept SSL server
                             certificates with failures; ARG is comma-separated
                             list of 'unknown-ca' (Unknown Authority),
                             'cn-mismatch' (Hostname mismatch), 'expired'
                             (Expired certificate), 'not-yet-valid' (Not yet
                             valid certificate) and 'other' (all other not
                             separately classified certificate errors).
  --config-dir ARG         : ARG로 지정된 디렉토리에서 사용자 구성화일을 읽습니다
  --config-option ARG      : 사용자 옵션의 포맷을 다음과 같이 지정합니다:
                                 FILE:SECTION:OPTION=[VALUE]
                             예:
                                 servers:global:http-library=serf

기본적인 export에 대한 명령 인자에 대한 설명은 export [-r REV] URL[@PEGREV] [PATH] 다.

REV: 가져오고 싶은 revision 정보이며, 값을 지정하지 않으면 HEAD에 해당되는 파일을 자동으로 가져온다.

URL : 저장소의 url을 의미한다.

PATH : export한 파일의 저장 위치, 별다른 값을 지정하지 않으면 기본 값으로 URL에서 지정된 경로 중 마지막 값 (Directory명 또는 file명)으로 처리된다.

예제

svn export를 수행하는 예시는 아래와 같다.

# repository url : http://svn.server/A
# revision : 10

svn export -r 10 http://svn.server/A

위의 command를 실행하면 command를 실행한 위치에 A 디렉터리를 생성하며, 생성된 디렉터리 안에 http://svn.server/A 의 하위 항목들을 다운로드 한다. 이 때, rev. 10 코드를 가져온다.

[QT] static assertion failed: Type is not registered, please use the Q_DECLARE_METATYPE

후유증 — Tue, 25 Jun 2019 15:19:17 +0900

QT를 이용하여, 개발을 하다 보면 자주 만나는 메시지다.

QVariant와 같은 QT에 미리 지정된 템플릿 클래스를 이용하다 보면 위와 같은 에러 메시지를 종 종 볼 수 있는데,

사용자 정의 클래스/타입이 미리 선언되어있지 않아 발생하는 오류다.

enum ENUM_TYPE {
	ENUM_1,
    ENUM_2
}


QVariant v;
v.value<ENUM_TYPE>(); // 에러

이는 헤더 파일에 Q_DECLARE_METATYPE(TypeName) 과 같이 작성하면 해당 문제는 해결된다.

enum ENUM_TYPE {
	ENUM_1,
    ENUM_2
}

Q_DECLARE_METATYPE(FSStatus);

QVariant v;
v.value<ENUM_TYPE>();

[CentOS] SWAP 빈도 조절하여 성능 개선

후유증 — Mon, 24 Jun 2019 10:49:19 +0900

리눅스 시스템에서는 메모리가 부족해 질 경우 발생하는 오류 (메모리 할당 오류 등)를 방지하기 위해 SWAP 영역을 사용한다.

SWAP 영역이란 메인 메모리의 공간이 부족해 질 때 메모리의 일부를 디스크에 저장하고, 사용하는 순간에만 잠시 메인 메모리(RAM)에 불러와 사용하기 위한 공간이다.

디스크에 생성된 많은 파티션 중 하나가 SWAP영역으로 지정되어 있다.

OS, 커널의 정책마다 SWAP 영역으로 내보낼 메모리 를 선정하는 방법이 다르며, 어느 시점에 내려보낼지에 대한 설정도 제각각 이다.

또한 같은 OS, 커널을 사용한다 하더라도 시스템 설정값의 변경을 통해 서로 다른 결과가 나타날 수 있다.

top을 통해 확인한 RAM/SWAP 영역의 사용량

위의 사진과 같이 아직 메인 메모리의 공간이 남아 있음에도, 미리 SWAP영역으로 내보내는 경우가 발생하기도 한다.

CentOS에서는 스왑에 대한 정책을 sysctl 또는 /etc/sysctl.conf 을 통해 변경할 수 있다.

스왑 적극도 값 변경 및 적용 (swappiness)

메모리 스왑 횟수를 줄여, 스왑시 발생하는 속도 저하를 해결하기 위해선 swappiness 값을 변경해야 한다.

이는 swap을 얼마나 적극적으로 활용하는지 대한 설정으로 이 설정은 vm.swappiness 값의 변경을 통해 지정된다.

값의 범위는 0~100으로 되어 있으며, 0이면 스왑을 사용하지 않고, 100이면 적극적으로 스왑을 사용하게 된다.

값에 대한 설명은 아래 표와 같다.

값	설명
0	스왑하지 않음
1~99	값이 커질수록 적극적으로 스왑 작아질 수록 소극적으로 스왑
100	적극적으로 스왑

스왑 적극도의 기본 설정 값

기본 설정은 60으로 되어있으며, 적극도는 설정된 값에 비례한다.

sysctl 명령어를 이용하여 설정하면, 현재 부팅된 시스템에 임시적으로 적용된다.

sysctl vm.swappiness=10 #원하는 설정값 입력, 예제에선 10

위의 값을 쉘에 입력하면 된다.

swappiness 설정 예제

영구적으로 적용하기 위해선, /etc/sysctl.conf 에 입력한다.

/etc/sysctl.conf

[CentOS 7] Multicast Packet을 Loopback으로 송/수신

후유증 — Fri, 21 Jun 2019 15:49:14 +0900

본 포스트에는 centos의 lo interface (localhost interface)에 route를 추가하여 Multicast packet을 local pc로만 송/수신 하고, NIC카드를 통해 외부로 나가지 않도록 처리하는 방법에 대해 서술하고자 한다.

기본적으로, Multicast의 IP 대역은 아래와 같이 지정되어 있다.

Multicast IP range table (https://en.wikipedia.org/wiki/Multicast_address)

이 중, 224.0.0.0 - 224.0.0.255가 Local range로 되어있으나, 이는 TTL이 1인 multicast packet을 생성 및 전송하는 역할을 수행한다.

따라서, 생성된 패킷은 네트워크를 태워 보내지게 되고, 로컬 망 내의 다른 장비들도 해당 패킷이 수신된다.

따라서 완벽한 Loopback을 위해 Multicast 관련 패킷이 local interface (default : lo)를 이용하여 local pc 내부에서만 돌도록 처리해야한다.

다행히, 방법은 어렵지 않다.

아래의 명령어를 이용하면, multicast 패킷이 local interface를 통해 송신 및 수신하게 되며, 외부망에 패킷을 태우지 않을 수 있다.

sudo ifconfig lo multicast
sudo route add -net 224.0.0.0 netmask 240.0.0.0 dev lo

첫 번째 줄의 명령어는 interface "lo"에 multicast 패킷을 송수신 하도록 상태를 활성화 시켜준다.

두 번째 줄의 명령어는 224.0.0.0, netmast 240.0.0.0에 해당되는 IP대역에 대한 패킷을 interface "lo"를 이용하여 통신하도록 Route 경로를 추가하는 역할을 수행한다.

따라서 Multicast와 관련된 패킷들은 "lo" interface만을 통해 송신 및 수신하게 된다.

[mysql/mariadb] Database export 하기 (db dump)

후유증 — Fri, 21 Jun 2019 11:16:49 +0900

DB Dump는 간단한 명령어를 통해 가능하다.

mysqldump -u ID -p DBNAME > FILE_NAME

ID, DBNAME, FILE_NAME에 적절한 값을 입력하면 된다.

만일, Table의 데이터 없이 schema만 백업하고 싶으면 다음과 같은 명령어를 사용하면된다.

mysqldump -u ID -p --no-data DBNAME >FILE_NAME

옵션에 추가된 --no-data 가 dump를 뜨면서 table 내의 데이터를 무시하도록 하는 역할한다.

[QT] C++ std::string과 QString 간의 문자열 형 변환 방법

후유증 — Tue, 18 Jun 2019 13:34:34 +0900

개요

QT C++로 프로그램을 작성하면, 타 라이브러리와의 연동을 위해 std::string 을 QString으로 변환하거나, 그 반대를 수행해야 하는 경우가 잦다.

이를 해결하기 위한 방법은 다음과 같다.

std::string -> QString

QString의 함수 이용

QString은 std::string을 QString으로 변환해주는 함수 QString::fromStdString 함수를 제공한다

사용 예시

std::string str ="Hello, World!";
QString qstr = QString::fromStdString(str);

위의 방법을 사용하면 손쉽게 형 변환이 가능하다.

string pointer 이용

std::string을 QString으로 변경하기 위한, char 배열로 변경한 결과를 QString의 생성자에 넣어주면 된다.

이는 아래의 예제 코드처럼 작성하면 QString으로 형변환된다.

std::string str = "Hello, World!";
QString qstr = QString(str.c_str());

QString -> std::string

QT 프로그램에서 타 라이브러리의 함수를 호출하기 위해선, QString 변수를 std::string으로 변환해야 하는 경우도 발생한다.

이 역시도 QString 에서 QString을 std::string으로 변환해주는 함수 QString::toStdString을 제공한다.

QString qstr = "Hello, World!";
std::string str = qstr.toStdString();

결론

QT에서 제공하는 QString 클래스는 기존의 C++ 객체와의 호환을 위한 다양한 기능을 제공하며, 이를 통해 효율적인 코딩이 가능하다.

위에 언급한 것 이외에도 QString의 QString QString::fromLocal8Bit(QByteArray*)나 QByteArray QString::toLocal8Bit() 같은 함수를 통해 QByteArray 또는 char*에서 QString로 혹은 그 반대로 변환할 수 있는 기능을 제공한다.

[C++] different underlying type in enum 'enum class TypeName'

후유증 — Fri, 14 Jun 2019 10:00:53 +0900

Error 발생 원인

enum class를 선언하고, 공통 헤더에서 prototype만 정의하려는 시도를 진행하였으나, 제목과 같은 에러가 발생하였다.
이러한 현상은 enum class의 구현부의 underlying type과 prototype의 underlying type이 서로 달라 발생하는 오류이다.

예제 코드

global.h

enum class Type;

enumclass.h


#include "global.h"
enum class Type : unsigned int {
    A,
    B,
    C
}

위와 같이 global.h에는 별다른 type을 지정안했으나, enumclass.h에는 별도의 타입이 지정되어 있을 때 발생한다.

해결 방법

이러한 부분은 아래와 같이 타입을 지정해주면 해결 된다.

예제 코드

global.h

enum class Type : unsigned int;

enumclass.h

#include "global.h"
enum class Type : unsigned int {
    A,
    B,
    C
}

[C++] Inheritance: 'A' is an inaccessible base of 'B'

후유증 — Wed, 12 Jun 2019 18:31:37 +0900

C++에서 접근제어 지정자를 잘못 지정해서 발생하는 현상이다.

아래와 같이 업캐스팅으로 부모 클래스의 자료형으로 자식 클래스의 포인터를 가리키려 할 때, 이와 같은 현상이 발생한다.

class A {
}
class B : A {
}

A* obj = new B();

이와 같은 문제는, 접근제어 지정자를 변경함으로서 해결 가능하다.

class A {
}
class B : public A {
}

A* obj = new B();

[QT] QObject::connect: Cannot queue arguments of type 'Type Name'

후유증 — Wed, 12 Jun 2019 13:20:59 +0900

QT 개발을 하던 도중, 특정 클래스를 인자로 사용하는 signal/slot을 생성하고, Connect를 할 경우

QObject::connect: Cannot queue arguments of type 'Type Name'

메시지가 출력될 때가 있다.

이러한 부분은, QT에 해당 class의 meta type이 추가되지 않아 발생하는 현상으로, 아래와 같은 코드를 추가하여 해결할 수 있다.

qRegisterMetaType<CMultiTrackMini>("CMultiTrackMini");

[SVN] 원격 Repository에 파일(directory) 추가 / 제거하기

후유증 — Tue, 4 Jun 2019 10:28:48 +0900

SVN을 사용하다 보면, 원격 Repository에 파일을 업로드/삭제를 해야할 일이 있다.

1. 원격 Repository에 파일(directory) 업로드

svn import LOCAL_PATH REMOTE_PATH

주의할점으로, directory를 업로드할 때, LOCAL_PATH로 Directory를, REMOTE_PATH로 업로드할 위치(parent directory)를 입력하면 parent directory에 파일만 업로드 된다.

local에 아래의 구조를 가진 a directory를 http://svn.url/A에 업로드 할 때

[폴더 구조]
a
a/b.txt
a/c.txt

svn import ./a http://svn.url/A

위와 같은 커맨드 명령어를 입력하게 될 것이며, 이에 대한 결과로 아래와 처럼 될 것이라 생각할 것이다.

[SVN Repository]
A/1 (기존파일)
A/a (추가)
A/a/b.txt
A/a/c.txt

하지만 결과는 아래처럼 나타난다.

[SVN Repository]
A/1 (기존파일)
A/b.txt
A/c.txt

이를 해결하기 위해선, 아래와 같이 추가 생성될 directory까지 추가하여 커맨드를 입력한다.

svn import ./a http://svn.url/A/a

그러면 원하던 결과를 얻을 수 있다.

2. 원격 Repository에 파일(directory) 삭제

svn rm REMOTE_PATH

파일 삭제는 단순히 Repository에서 지울 대상이 존재하는 URL만 입력하면 손쉽게 제거 가능하다.

방금 추가한 a directory를 지우기 위해선,

svn rm http://svn.url/A/a

위와 같이 작성만 하면 손쉽게 삭제 가능하다.

[CentOS] Gnome 환경에서, Titlebar 크기 조절하기

후유증 — Mon, 27 May 2019 11:17:46 +0900

gnome3 환경에서, Titlebar는 GTK-3설정에 영향을 받는다.

경로에 ~/.config/gtk-3.0/gtk.css에 아래와 같은 내용을 입력하면 된다.

/* shrink headerbars (don't forget semicolons after each property) */
headerbar {
    min-height: 0px;
    padding-left: 2px; /* same as childrens vertical margins for nicer proportions */
    padding-right: 2px;
    background-color: #2d2d2d;
}

headerbar entry,
headerbar spinbutton,
headerbar button,
headerbar separator {
    margin-top: 0px; /* same as headerbar side padding for nicer proportions */
    margin-bottom: 0px;
}

/* shrink ssd titlebars */
.default-decoration {
    min-height: 0; /* let the entry and button drive the titlebar size */
    padding: 0px;
    background-color: #2d2d2d;
}

.default-decoration .titlebutton {
    min-height: 0px; /* tweak these two props to reduce button size */
    min-width: 0px;
}

window.ssd headerbar.titlebar {
    padding-top: 3px;
    padding-bottom: 3px;
    min-height: 0;
}

window.ssd headerbar.titlebar button.titlebutton {
    padding-top: 3px;
    padding-bottom:3px;
    min-height: 0;
}

[vscode] VSCode 에서 React Live debug 설정하기

후유증 — Thu, 23 May 2019 17:51:46 +0900

VSCode에서 React 코드를 작성할 때, 코드가 변경됨을 실시간으로 크롬으로 확인할 수 있는 방법이다.

1. Debugger for chrome extension 설치

좌측의 extension 버튼 클릭 후, chrome을 검색하여 debugger for chrome 을 설치한다.

vscode extension

2. launch.json 파일을 생성한다

.vscode 디렉토리에, 아래와 같은 내용을 가진 launch.json 파일을 생성한다.

{
    "version": "0.2.0",
    "configurations": [
        
        {
            "name": "Chrome",
            "type": "chrome",
            "request": "launch",
            "url": "http://localhost:3000",
            "webRoot": "${workspaceRoot}/src"
        }
    ]
}

3. Terminal에서 react application을 실행한다.

npm start를 통해 react 실행

4. F5를 눌러 디버깅을 시작한다.

위의 설정이 완료될 경우, 자동으로 chrome 창이 켜지게 되며, src 디렉터리 내부의 코드를 수정하면 자동으로 refresh 된다.

MarkDown Test

후유증 — Sat, 18 May 2019 11:09:20 +0900

markdown Test

test2

code block

void main() {
    return 0;
}

import hi
function a() {
  console.log('hello world!');
}