2022-11-18

wsl2에 archlinux 설치

wsl2에 2022-11-18 현재 공식적으로 배포중인 linux distro에 archlinux는 없다.

하지만 linux 배포판중 archlinux를 가장 좋아하기때문에 archlinux를 설치해보았다.

docker에서 배포중인 archlinux 이미지를 사용하여 기본 설정하고 export 한 다음에 wsl에 등록하였다.

docker는 이미 설치되어 있다고 가정한다.


1. docker archlinux image 가져오기

> docker pull archlinux


2. archlinux container 실행

> docker run -it --name archlinux-wsl archlinux


3. archlinux 기본 설정

3.1. update 및 sudo 설정

# pacman -Syu
# pacman -Sy sudo vi
# visudo

3.2. 아래 내용을 찾아 주석을 해제한다.

%wheel ALL=(ALL:ALL) ALL

3.3. user 계정 생성. 아래 명령에서 userid는 사용할 user 계정을 쓴다.
# useradd -G wheel,users -m userid
# passwd userid

3.4. 아래와 같이 passwd, group shadow, gshadow 파일 존재 여부와 권한 확인

# ls -l /etc/passwd /etc/shadow /etc/group /etc/gshadow
-rw-r--r-- 1 root root 672 Nov 18 12:23 /etc/group
-rw------- 1 root root 598 Nov 18 12:23 /etc/gshadow
-rw-r--r-- 1 root root 873 Nov 18 12:19 /etc/passwd
-rw------- 1 root root 523 Nov 18 12:19 /etc/shadow

3.5. shadow, gshadow 파일이 없다면 아래 명령으로 생성

# pwconv
# grpconv

3.6. 권한이 다르다면 아래 명령으로 권한 설정

# chmod 644 /etc/passwd
# chmod 644 /etc/group
# chmod 600 /etc/shadow
# chmod 600 /etc/gshadow

3.7 root 계정 로그인 막기. root의 login shell을 /bin/bash에서 /usr/bin/nologin으로 변경한다.

# vi /etc/passwd

root:x:0:0::/root:/usr/bin/nologin

3.8 wsl.conf 설정

# vi /etc/wsl.conf

아래 내용을 삽입한다. userid는 3.3에서 사용한 userid와 동일하게 사용한다.

[user]
default = userid

3.8. docker image에서 나오기

# exit


4. docker에서 archlinux image export 하기

> docker export --output archlinux-wsl.tar archlinux-wsl


5. wsl에 archlinux import하기. archlinux-wsl.tar의 내용을 archlinux라는 이름으로 c:\archlinux 경로에  추가할것이다. 원하는 이름과 경로를 사용한다.

> wsl --import archlinux c:\archlinux archlinux-wsl.tar


6. wsl로 archlinux 실행. 

> wsl -d archlinux


6.1 만약 This account is currently not available. 같은 에러가 발생한다면 wsl.conf에 userid설정이 적용 안된것이니 아래 명령을 사용한다.

> wsl --shutdown
> wsl -d archlinux


7. wsl에 기본 linux를 archlinux로 설정

> wsl --set-default archlinux




archlinux laptop 덮개 덮을 때 휴면 모드 사용 / 사용안함 설정

이번에 archlinux에서 laptop 덮개를 덮은후 별도 모니터, 키보드, 마우스를 연결 하여 사용할 필요가 있었다.

macbook에서는 clamshell mode라고 부르는것 같다.

windows에서는 덮개 덮은 후 동작 안하게 설정 하면되서 10년 넘게 사용했었다.


archlinux에서 사용했던 명령어를 남긴다.

systemctl로 전원설정 변경하는거라 아마 다른 linux에서도 동일하게 사용가능 할것 같다.


laptop 덮개 덮을 때 휴면 모드 사용 안함 

$ sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target


laptop 덮개 덮을 때 휴면 모드 사용 함

$ sudo systemctl unmask sleep.target suspend.target hibernate.target hybrid-sleep.target


2022-11-09

archlinux에 NextCloud 설치

NextCloud 설치

집에 Odroid N2+내에 NextCloud를 설치하여 개인 Cloud를 구축한 작업을 기록한다.

참조 문서에서는 MariaDB/MySQL이 추천 방법이지만, 본 문서에서는 PostgreSQL를 사용한다.

참조 문서에서는 nextcloud 계정으로 nextcloude 서비스를 실행했지만, 본 문서에서는 http 계정과 그룹을 사용한다. nginx를 실행시는 계정이 http인데 nginx에서 권할이 필요하기때문에 http계정을 사용해야한다.

참조 문서에서는 /var/lib/nextcloud 경로를 기본 경로로 사용하였지만, 본 문서에서는 /mnt/a/nextcloud 경로를 기본경로로 사용한다. 외장 하드 경로를 사용한다.

1. 사양

2. Install

$ sudo pacman -Syu
$sudo pacman -S nextcloud nginx postgresql php-pgsql php-fpm php-imagick php-intl
$ sudo pacman -S curl

3. Configuration

3-1. PHP

/etc/php/php.ini 파일에 아래 내용을 추가하거나 찾아서 주석을 해제한다.

기본 디렉토리는 /mnt/a/nextcloud를 사용한다.

$ sudo vi /etc/php/php.ini
extension=bcmath
extension=bz2
extension=exif
extension=gd
extension=iconv
extension=intl
zend_extension=opcache
extension=pdo_pgsql
extension=pgsql
; in case you installed php-imagick (as recommended)
extension=imagick

; set timezone Seoul
date.timezone = Asia/Seoul

; Raise PHP's memory limit to at least 512MiB
memory_limit = 512M

; security configure
open_basedir=/mnt/a/nextcloud/data:/mnt/a/nextcloud/apps:/tmp:/usr/share/webapps/nextcloud:/etc/webapps/nextcloud:/dev/urandom:/usr/lib/php/modules:/var/log/nextcloud:/proc/meminfo

[opcache]
opcache.enable = 1
opcache.memory_consumption = 128
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 10000
opcache.revalidate_freq = 1
opcache.save_comments = 1

3-2. Nextcloud

/etc/webapps/nextcloud/config/config.php 파일에 아래 내용을 추가/수정 한다.

기본 디렉토리는 /mnt/a/nextcloud를 사용한다.

cloud.mysite.com 을 domain으로 사용 하는 경우

$ sudo vi /etc/webapps/nextcloud/config/config.php
<?php
$CONFIG = array (
'datadirectory' => '/mnt/a/nextcloud/data',
'logfile' => '/mnt/a/nextcloud/log/nextcloud.log',
'log_type' => 'file', 'filesystem_check_changes' => 1, 'apps_paths' => [ [ 'path'=> '/usr/share/webapps/nextcloud/apps', 'url' => '/apps', 'writable' => false, ], [ 'path'=> '/mnt/a/nextcloud/apps', 'url' => '/wapps', 'writable' => true, ], ], 'trusted_domains' => array ( 0 => 'localhost', 1 => 'cloud.mysite.com', ), 'overwrite.cli.url' => 'https://cloud.mysite.com/', 'htaccess.RewriteBase' => '/', );

아래와 같이 nextcloud하위 디렉토리들을 생성한다.

기본 설정 사용시 sessions 디렉토리만 생성하면 된다.

왠지 모르겠지만 /mnt/a/nextcloud를 /var/lib/nextcloud로 링크걸지 않으면 정상 동작하지 않는다.

$ mkdir -p /mnt/a/nextcloud/sessions
$ mkdir -p /mnt/a/nextcloud/apps
$ mkdir -p /mnt/a/nextcloud/data
$ mkdir -p /mnt/a/nextcloud/log
$ sudo rm -rf /var/lib/nextcloud
$ sudo ln -sf /mnt/a/nextcloud /var/lib/nextcloud
$ sudo chown -R http /mnt/a/nextcloud

3-3. PostgreSQL

PostgreSQL 설정한다.

$ sudo chown -R postgres:postgres /var/lib/postgres
$ sudo -iu postgres
$ initdb --encoding=UTF8 --locale=ko_KR.UTF-8 -D /var/lib/postgres/data --data-checksums
$ echo "listen_addresses = '127.0.0.1'" >> /var/lib/postgres/data/postgresql.conf
$ pg_ctl -D /var/lib/postgres/data -l /var/lib/postgres/data/logfile start
$ exit
$ sudo -u postgres -- psql

# pg_ctl에서 error 발생시 - '/run/postgresql/.s.PGSQL.5432.lock' 파일 없다는 에러
# 아래 명령 수행
$ sudo mkdir /run/postgresql
$ sudo chown -R postgres:postgres /run/postgresql
$ sudo -u postgres -- pg_ctl -D /var/lib/postgres/data -l /var/lib/postgres/data/logfile start
$ sudo -u postgres -- psql

nextcloud 이름으로 database와 db_user를 생성한다.

db-password 는 원하는 값으로 설정한다.

CREATE USER nextcloud WITH PASSWORD 'db-password';
CREATE DATABASE nextcloud TEMPLATE template0 ENCODING 'UNICODE';
ALTER DATABASE nextcloud OWNER TO nextcloud;
GRANT ALL PRIVILEGES ON DATABASE nextcloud TO nextcloud;
\q

/etc/webapps/nextcloud/config 권한을 변경한다.

기본 설정을 사용하는 경우라면 변경할 필요가 없겠지만, 본 문서에서는 http 계정으로 nextcloud 서비스를 실행하기 때문에 변경한다.

$ sudo chown -R http:http /etc/webapps/nextcloud/config
$ sudo chmod -R g+w /etc/webapps/nextcloud/config

Nextcloud database schema를 설정한다.

db-password 는 위에서 설정한 값을 사용한다.

admin-user와 admin-password 는 원하는 값으로 설정한다.

admin-email 는 관리자 email주소로 설정한다.

기본 디렉토리는 /mnt/a/nextcloud를 사용한다.

$ /usr/share/webapps/nextcloud/occ maintenance:install \
    --database=pgsql \
    --database-name=nextcloud \
    --database-host=/run/postgresql \
    --database-user=nextcloud \
    --database-pass=db-password \
    --admin-user=admin-user \
    --admin-pass=admin-password \
    --admin-email=admin-email \
    --data-dir=/mnt/a/nextcloud/data

3-4. php-fpm

nextcloud.conf 파일을 다운로드 받는다.

$ curl -sL 'https://gist.githubusercontent.com/wolegis/0d9c83acd0c8bf83bcfb3983931bc364/raw/44ebeef205cb35d4514d0895c333e1582ccbb8e5/nextcloud.conf' > nextcloud.conf
$ sudo mv nextcloud.conf /etc/php/php-fpm.d/nextcloud.conf
$ sudo chown root:root /etc/php/php-fpm.d/nextcloud.conf

$ ls -l /etc/php/php-fpm.d/nextcloud.conf 
-rw-r--r-- 1 root root ... /etc/php/php-fpm.d/nextcloud.conf


/etc/php/php-fpm.d/nextcloud.conf 파일을 일부 수정한다.

user 및 group을 원하는 계정으로 수정한다.

기본 설정을 사용하는 경우라면 변경할 필요가 없겠지만, 본 문서에서는 개인 계정으로 nextcloud 서비스를 실행하기 때문에 변경한다.

timezone을 서울로 설정한다.

$ sudo vi /etc/php/php-fpm.d/nextcloud.conf
user = http
group = http
listen.owner = http
listen.group = http

php_value[date.timezone] = Asia/Seoul


php-fpm service를 구성한다.

$ sudo mkdir -p /etc/systemd/system/php-fpm.service.d
$ sudo vi /etc/systemd/system/php-fpm.service.d/override.conf
[Service]
ExecStart=
ExecStart=/usr/bin/php-fpm --nodaemonize --fpm-config /etc/php/php-fpm.conf 
ReadWritePaths=/mnt/a/nextcloud
ReadWritePaths=/etc/webapps/nextcloud/config
$ sudo systemctl enable php-fpm.service
$ sudo systemctl start php-fpm.service

# error 발생시 - failed to open access log (/var/log/php-fpm/access/nextcloud.log): No such file or directory
# 아래 명령 수행
$ sudo mkdir -p /var/log/php-fpm/access
$ sudo systemctl start php-fpm.service

3-5. nginx

cloud.mysite.com라는 domain을 사용한다면, 아래 링크에서 Nextcloud in a subdir of the NGINX webroot섹션의 파일 내용을 복사하여 /etc/nginx/sites-available/cloud.mysite.com.conf 파일을 생성하고 그 파일의 심볼릭 링크를 /etc/nginx/sites-enabled/cloud.mysite.com.conf 로 생성한다. cloud.mysite.com 가 아닌 다른 domain을 사용시 해당 domain에 맞게 파일명을 변경한다.

https://docs.nextcloud.com/server/latest/admin_manual/installation/nginx.html

$ sudo mkdir -p /etc/nginx/sites-available
$ sudo mkdir -p /etc/nginx/sites-enabled
$ sudo vi /etc/nginx/sites-available/cloud.mysite.com.conf
$ sudo ln -sf /etc/nginx/sites-available/cloud.mysite.com.conf /etc/nginx/sites-enabled/cloud.mysite.com.conf

root 경로를 /usr/share/webapps/nextcloud 로 수정한다.

HSTS header를 사용하게 수정한다.

php-handler 사용 구문을 주석 처리하고 unix:/run/php-fpm/nextcloud.sock; 을 사용하게 수정한다.

$ sudo vi /etc/nginx/sites-available/cloud.mysite.com.conf
root /usr/share/webapps/nextcloud;

add_header Strict-Transport-Security "max-age=15552000; includeSubDomains; preload" always;

#fastcgi_pass php-handler;
fastcgi_pass unix:/run/php-fpm/nextcloud.sock;

만약 nginx.conf에 site-enabled가 include 되어 있지 않다면 include 한다.

$ sudo vi /etc/nginx/nginx.conf
...
http {
...
    include /etc/nginx/sites-enabled/*;
    include /etc/nginx/sites-enabled/*.*;
...
}
...

nginx restart

$ sudo systemctl restart nginx

3-6 권한확인

아래와 같이 오류 없이 실행되면 된다.

$ sudo -u http php /usr/share/webapps/nextcloud/occ -h

Description:
  List commands

Usage:
  list [options] [--] [<namespace>]

Arguments:
  namespace            The namespace name

Options:
      --raw            To output raw command list
      --format=FORMAT  The output format (txt, xml, json, or md) [default: "txt"]

Help:
  The list command lists all commands:

    php /usr/share/webapps/nextcloud/occ list

  You can also display the commands for a specific namespace:

    php /usr/share/webapps/nextcloud/occ list test

  You can also output the information in other formats by using the --format option:

    php /usr/share/webapps/nextcloud/occ list --format=xml

  It's also possible to get raw list of commands (useful for embedding command runner):

    php /usr/share/webapps/nextcloud/occ list --raw

2. Client

web browser 에서 https://https://cloud.mysite.com/nextcloud/ 와 같은 경로로 접속 후 사용하면 된다.

안드로이드용 앱은 아래 주소에서 다운로드 받으면 된다.

android app : https://play.google.com/store/apps/details?id=com.nextcloud.client

3. Logs

$ sudo cat /var/lib/postgres/data/logfile
$ sudo cat /mnt/a/nextcloud/data/nextcloud.log
$ sudo cat /var/log/nextcloud/nextcloud.log
$ sudo cat /var/log/nginx/access.log
$ sudo cat /var/log/nginx/error.log

4. 기타

4-1. /etc/php/php-fpm.d/nextcloud.conf 파일 내용

  •   ; Start a new pool named 'nextcloud'.
      ; the variable $pool can be used in any directive and will be replaced by the
      ; pool name ('nextcloud' here)
      [nextcloud]
    
      ; Per pool prefix
      ; It only applies on the following directives:
      ; - 'access.log'
      ; - 'slowlog'
      ; - 'listen' (unixsocket)
      ; - 'chroot'
      ; - 'chdir'
      ; - 'php_values'
      ; - 'php_admin_values'
      ; When not set, the global prefix (or /usr) applies instead.
      ; Note: This directive can also be relative to the global prefix.
      ; Default Value: none
      ;prefix = /path/to/pools/$pool
    
      ; Unix user/group of processes
      ; Note: The user is mandatory. If the group is not set, the default user's group
      ;       will be used.
      user = nextcloud
      group = nextcloud
    
      ; The address on which to accept FastCGI requests.
      ; Valid syntaxes are:
      ;   'ip.add.re.ss:port'    - to listen on a TCP socket to a specific IPv4 address on
      ;                            a specific port;
      ;   '[ip:6:addr:ess]:port' - to listen on a TCP socket to a specific IPv6 address on
      ;                            a specific port;
      ;   'port'                 - to listen on a TCP socket to all addresses
      ;                            (IPv6 and IPv4-mapped) on a specific port;
      ;   '/path/to/unix/socket' - to listen on a unix socket.
      ; Note: This value is mandatory.
      listen = /run/php-fpm/nextcloud.sock
    
      ; Set listen(2) backlog.
      ; Default Value: 511 (-1 on FreeBSD and OpenBSD)
      ;listen.backlog = 511
    
      ; Set permissions for unix socket, if one is used. In Linux, read/write
      ; permissions must be set in order to allow connections from a web server. Many
      ; BSD-derived systems allow connections regardless of permissions. The owner
      ; and group can be specified either by name or by their numeric IDs.
      ; Default Values: user and group are set as the running user
      ;                 mode is set to 0660
      listen.owner = nextcloud
      listen.group = http
      listen.mode = 0660
      ; When POSIX Access Control Lists are supported you can set them using
      ; these options, value is a comma separated list of user/group names.
      ; When set, listen.owner and listen.group are ignored
      ;listen.acl_users =
      ;listen.acl_groups =
    
      ; List of addresses (IPv4/IPv6) of FastCGI clients which are allowed to connect.
      ; Equivalent to the FCGI_WEB_SERVER_ADDRS environment variable in the original
      ; PHP FCGI (5.2.2+). Makes sense only with a tcp listening socket. Each address
      ; must be separated by a comma. If this value is left blank, connections will be
      ; accepted from any ip address.
      ; Default Value: any
      ;listen.allowed_clients = 127.0.0.1
    
      ; Specify the nice(2) priority to apply to the pool processes (only if set)
      ; The value can vary from -19 (highest priority) to 20 (lower priority)
      ; Note: - It will only work if the FPM master process is launched as root
      ;       - The pool processes will inherit the master process priority
      ;         unless it specified otherwise
      ; Default Value: no set
      ; process.priority = -19
    
      ; Set the process dumpable flag (PR_SET_DUMPABLE prctl) even if the process user
      ; or group is different than the master process user. It allows to create process
      ; core dump and ptrace the process for the pool user.
      ; Default Value: no
      ; process.dumpable = yes
    
      ; Choose how the process manager will control the number of child processes.
      ; Possible Values:
      ;   static  - a fixed number (pm.max_children) of child processes;
      ;   dynamic - the number of child processes are set dynamically based on the
      ;             following directives. With this process management, there will be
      ;             always at least 1 children.
      ;             pm.max_children      - the maximum number of children that can
      ;                                    be alive at the same time.
      ;             pm.start_servers     - the number of children created on startup.
      ;             pm.min_spare_servers - the minimum number of children in 'idle'
      ;                                    state (waiting to process). If the number
      ;                                    of 'idle' processes is less than this
      ;                                    number then some children will be created.
      ;             pm.max_spare_servers - the maximum number of children in 'idle'
      ;                                    state (waiting to process). If the number
      ;                                    of 'idle' processes is greater than this
      ;                                    number then some children will be killed.
      ;             pm.max_spawn_rate    - the maximum number of rate to spawn child
      ;                                    processes at once.
      ;  ondemand - no children are created at startup. Children will be forked when
      ;             new requests will connect. The following parameter are used:
      ;             pm.max_children           - the maximum number of children that
      ;                                         can be alive at the same time.
      ;             pm.process_idle_timeout   - The number of seconds after which
      ;                                         an idle process will be killed.
      ; Note: This value is mandatory.
      pm = dynamic
    
      ; The number of child processes to be created when pm is set to 'static' and the
      ; maximum number of child processes when pm is set to 'dynamic' or 'ondemand'.
      ; This value sets the limit on the number of simultaneous requests that will be
      ; served. Equivalent to the ApacheMaxClients directive with mpm_prefork.
      ; Equivalent to the PHP_FCGI_CHILDREN environment variable in the original PHP
      ; CGI. The below defaults are based on a server without much resources. Don't
      ; forget to tweak pm.* to fit your needs.
      ; Note: Used when pm is set to 'static', 'dynamic' or 'ondemand'
      ; Note: This value is mandatory.
      pm.max_children = 5
    
      ; The number of child processes created on startup.
      ; Note: Used only when pm is set to 'dynamic'
      ; Default Value: (min_spare_servers + max_spare_servers) / 2
      pm.start_servers = 2
    
      ; The desired minimum number of idle server processes.
      ; Note: Used only when pm is set to 'dynamic'
      ; Note: Mandatory when pm is set to 'dynamic'
      pm.min_spare_servers = 1
    
      ; The desired maximum number of idle server processes.
      ; Note: Used only when pm is set to 'dynamic'
      ; Note: Mandatory when pm is set to 'dynamic'
      pm.max_spare_servers = 3
    
      ; The number of rate to spawn child processes at once.
      ; Note: Used only when pm is set to 'dynamic'
      ; Note: Mandatory when pm is set to 'dynamic'
      ; Default Value: 32
      ;pm.max_spawn_rate = 32
    
      ; The number of seconds after which an idle process will be killed.
      ; Note: Used only when pm is set to 'ondemand'
      ; Default Value: 10s
      ;pm.process_idle_timeout = 10s;
    
      ; The number of requests each child process should execute before respawning.
      ; This can be useful to work around memory leaks in 3rd party libraries. For
      ; endless request processing specify '0'. Equivalent to PHP_FCGI_MAX_REQUESTS.
      ; Default Value: 0
      ;pm.max_requests = 500
    
      ; The URI to view the FPM status page. If this value is not set, no URI will be
      ; recognized as a status page. It shows the following information:
      ;   pool                 - the name of the pool;
      ;   process manager      - static, dynamic or ondemand;
      ;   start time           - the date and time FPM has started;
      ;   start since          - number of seconds since FPM has started;
      ;   accepted conn        - the number of request accepted by the pool;
      ;   listen queue         - the number of request in the queue of pending
      ;                          connections (see backlog in listen(2));
      ;   max listen queue     - the maximum number of requests in the queue
      ;                          of pending connections since FPM has started;
      ;   listen queue len     - the size of the socket queue of pending connections;
      ;   idle processes       - the number of idle processes;
      ;   active processes     - the number of active processes;
      ;   total processes      - the number of idle + active processes;
      ;   max active processes - the maximum number of active processes since FPM
      ;                          has started;
      ;   max children reached - number of times, the process limit has been reached,
      ;                          when pm tries to start more children (works only for
      ;                          pm 'dynamic' and 'ondemand');
      ; Value are updated in real time.
      ; Example output:
      ;   pool:                 www
      ;   process manager:      static
      ;   start time:           01/Jul/2011:17:53:49 +0200
      ;   start since:          62636
      ;   accepted conn:        190460
      ;   listen queue:         0
      ;   max listen queue:     1
      ;   listen queue len:     42
      ;   idle processes:       4
      ;   active processes:     11
      ;   total processes:      15
      ;   max active processes: 12
      ;   max children reached: 0
      ;
      ; By default the status page output is formatted as text/plain. Passing either
      ; 'html', 'xml' or 'json' in the query string will return the corresponding
      ; output syntax. Example:
      ;   http://www.foo.bar/status
      ;   http://www.foo.bar/status?json
      ;   http://www.foo.bar/status?html
      ;   http://www.foo.bar/status?xml
      ;
      ; By default the status page only outputs short status. Passing 'full' in the
      ; query string will also return status for each pool process.
      ; Example:
      ;   http://www.foo.bar/status?full
      ;   http://www.foo.bar/status?json&full
      ;   http://www.foo.bar/status?html&full
      ;   http://www.foo.bar/status?xml&full
      ; The Full status returns for each process:
      ;   pid                  - the PID of the process;
      ;   state                - the state of the process (Idle, Running, ...);
      ;   start time           - the date and time the process has started;
      ;   start since          - the number of seconds since the process has started;
      ;   requests             - the number of requests the process has served;
      ;   request duration     - the duration in µs of the requests;
      ;   request method       - the request method (GET, POST, ...);
      ;   request URI          - the request URI with the query string;
      ;   content length       - the content length of the request (only with POST);
      ;   user                 - the user (PHP_AUTH_USER) (or '-' if not set);
      ;   script               - the main script called (or '-' if not set);
      ;   last request cpu     - the %cpu the last request consumed
      ;                          it's always 0 if the process is not in Idle state
      ;                          because CPU calculation is done when the request
      ;                          processing has terminated;
      ;   last request memory  - the max amount of memory the last request consumed
      ;                          it's always 0 if the process is not in Idle state
      ;                          because memory calculation is done when the request
      ;                          processing has terminated;
      ; If the process is in Idle state, then informations are related to the
      ; last request the process has served. Otherwise informations are related to
      ; the current request being served.
      ; Example output:
      ;   ************************
      ;   pid:                  31330
      ;   state:                Running
      ;   start time:           01/Jul/2011:17:53:49 +0200
      ;   start since:          63087
      ;   requests:             12808
      ;   request duration:     1250261
      ;   request method:       GET
      ;   request URI:          /test_mem.php?N=10000
      ;   content length:       0
      ;   user:                 -
      ;   script:               /home/fat/web/docs/php/test_mem.php
      ;   last request cpu:     0.00
      ;   last request memory:  0
      ;
      ; Note: There is a real-time FPM status monitoring sample web page available
      ;       It's available in: /usr/share/php/fpm/status.html
      ;
      ; Note: The value must start with a leading slash (/). The value can be
      ;       anything, but it may not be a good idea to use the .php extension or it
      ;       may conflict with a real PHP file.
      ; Default Value: not set
      ;pm.status_path = /status
    
      ; The address on which to accept FastCGI status request. This creates a new
      ; invisible pool that can handle requests independently. This is useful
      ; if the main pool is busy with long running requests because it is still possible
      ; to get the status before finishing the long running requests.
      ;
      ; Valid syntaxes are:
      ;   'ip.add.re.ss:port'    - to listen on a TCP socket to a specific IPv4 address on
      ;                            a specific port;
      ;   '[ip:6:addr:ess]:port' - to listen on a TCP socket to a specific IPv6 address on
      ;                            a specific port;
      ;   'port'                 - to listen on a TCP socket to all addresses
      ;                            (IPv6 and IPv4-mapped) on a specific port;
      ;   '/path/to/unix/socket' - to listen on a unix socket.
      ; Default Value: value of the listen option
      ;pm.status_listen = 127.0.0.1:9001
    
      ; The ping URI to call the monitoring page of FPM. If this value is not set, no
      ; URI will be recognized as a ping page. This could be used to test from outside
      ; that FPM is alive and responding, or to
      ; - create a graph of FPM availability (rrd or such);
      ; - remove a server from a group if it is not responding (load balancing);
      ; - trigger alerts for the operating team (24/7).
      ; Note: The value must start with a leading slash (/). The value can be
      ;       anything, but it may not be a good idea to use the .php extension or it
      ;       may conflict with a real PHP file.
      ; Default Value: not set
      ;ping.path = /ping
    
      ; This directive may be used to customize the response of a ping request. The
      ; response is formatted as text/plain with a 200 response code.
      ; Default Value: pong
      ;ping.response = pong
    
      ; The access log file
      ; Default: not set
      ;access.log = log/$pool.access.log
      access.log = /var/log/php-fpm/access/$pool.log
    
      ; The access log format.
      ; The following syntax is allowed
      ;  %%: the '%' character
      ;  %C: %CPU used by the request
      ;      it can accept the following format:
      ;      - %{user}C for user CPU only
      ;      - %{system}C for system CPU only
      ;      - %{total}C  for user + system CPU (default)
      ;  %d: time taken to serve the request
      ;      it can accept the following format:
      ;      - %{seconds}d (default)
      ;      - %{milliseconds}d
      ;      - %{milli}d
      ;      - %{microseconds}d
      ;      - %{micro}d
      ;  %e: an environment variable (same as $_ENV or $_SERVER)
      ;      it must be associated with embraces to specify the name of the env
      ;      variable. Some examples:
      ;      - server specifics like: %{REQUEST_METHOD}e or %{SERVER_PROTOCOL}e
      ;      - HTTP headers like: %{HTTP_HOST}e or %{HTTP_USER_AGENT}e
      ;  %f: script filename
      ;  %l: content-length of the request (for POST request only)
      ;  %m: request method
      ;  %M: peak of memory allocated by PHP
      ;      it can accept the following format:
      ;      - %{bytes}M (default)
      ;      - %{kilobytes}M
      ;      - %{kilo}M
      ;      - %{megabytes}M
      ;      - %{mega}M
      ;  %n: pool name
      ;  %o: output header
      ;      it must be associated with embraces to specify the name of the header:
      ;      - %{Content-Type}o
      ;      - %{X-Powered-By}o
      ;      - %{Transfert-Encoding}o
      ;      - ....
      ;  %p: PID of the child that serviced the request
      ;  %P: PID of the parent of the child that serviced the request
      ;  %q: the query string
      ;  %Q: the '?' character if query string exists
      ;  %r: the request URI (without the query string, see %q and %Q)
      ;  %R: remote IP address
      ;  %s: status (response code)
      ;  %t: server time the request was received
      ;      it can accept a strftime(3) format:
      ;      %d/%b/%Y:%H:%M:%S %z (default)
      ;      The strftime(3) format must be encapsulated in a %{<strftime_format>}t tag
      ;      e.g. for a ISO8601 formatted timestring, use: %{%Y-%m-%dT%H:%M:%S%z}t
      ;  %T: time the log has been written (the request has finished)
      ;      it can accept a strftime(3) format:
      ;      %d/%b/%Y:%H:%M:%S %z (default)
      ;      The strftime(3) format must be encapsulated in a %{<strftime_format>}t tag
      ;      e.g. for a ISO8601 formatted timestring, use: %{%Y-%m-%dT%H:%M:%S%z}t
      ;  %u: remote user
      ;
      ; Default: "%R - %u %t \"%m %r\" %s"
      ;access.format = "%R - %u %t \"%m %r%Q%q\" %s %f %{milli}d %{kilo}M %C%%"
      access.format = "%{%Y-%m-%dT%H:%M:%S%z}t %R: \"%m %r%Q%q\" %s %f %{milli}d %{kilo}M %C%%"
    
      ; The log file for slow requests
      ; Default Value: not set
      ; Note: slowlog is mandatory if request_slowlog_timeout is set
      ;slowlog = log/$pool.log.slow
    
      ; The timeout for serving a single request after which a PHP backtrace will be
      ; dumped to the 'slowlog' file. A value of '0s' means 'off'.
      ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays)
      ; Default Value: 0
      ;request_slowlog_timeout = 0
    
      ; Depth of slow log stack trace.
      ; Default Value: 20
      ;request_slowlog_trace_depth = 20
    
      ; The timeout for serving a single request after which the worker process will
      ; be killed. This option should be used when the 'max_execution_time' ini option
      ; does not stop script execution for some reason. A value of '0' means 'off'.
      ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays)
      ; Default Value: 0
      ;request_terminate_timeout = 0
    
      ; The timeout set by 'request_terminate_timeout' ini option is not engaged after
      ; application calls 'fastcgi_finish_request' or when application has finished and
      ; shutdown functions are being called (registered via register_shutdown_function).
      ; This option will enable timeout limit to be applied unconditionally
      ; even in such cases.
      ; Default Value: no
      ;request_terminate_timeout_track_finished = no
    
      ; Set open file descriptor rlimit.
      ; Default Value: system defined value
      ;rlimit_files = 1024
    
      ; Set max core size rlimit.
      ; Possible Values: 'unlimited' or an integer greater or equal to 0
      ; Default Value: system defined value
      ;rlimit_core = 0
    
      ; Chroot to this directory at the start. This value must be defined as an
      ; absolute path. When this value is not set, chroot is not used.
      ; Note: you can prefix with '$prefix' to chroot to the pool prefix or one
      ; of its subdirectories. If the pool prefix is not set, the global prefix
      ; will be used instead.
      ; Note: chrooting is a great security feature and should be used whenever
      ;       possible. However, all PHP paths will be relative to the chroot
      ;       (error_log, sessions.save_path, ...).
      ; Default Value: not set
      ;chroot =
    
      ; Chdir to this directory at the start.
      ; Note: relative path can be used.
      ; Default Value: current directory or / when chroot
      ;chdir = /srv/http
      chdir = /usr/share/webapps/$pool
    
      ; Redirect worker stdout and stderr into main error log. If not set, stdout and
      ; stderr will be redirected to /dev/null according to FastCGI specs.
      ; Note: on highloaded environment, this can cause some delay in the page
      ; process time (several ms).
      ; Default Value: no
      ;catch_workers_output = yes
    
      ; Decorate worker output with prefix and suffix containing information about
      ; the child that writes to the log and if stdout or stderr is used as well as
      ; log level and time. This options is used only if catch_workers_output is yes.
      ; Settings to "no" will output data as written to the stdout or stderr.
      ; Default value: yes
      ;decorate_workers_output = no
    
      ; Clear environment in FPM workers
      ; Prevents arbitrary environment variables from reaching FPM worker processes
      ; by clearing the environment in workers before env vars specified in this
      ; pool configuration are added.
      ; Setting to "no" will make all environment variables available to PHP code
      ; via getenv(), $_ENV and $_SERVER.
      ; Default Value: yes
      ;clear_env = no
    
      ; Limits the extensions of the main script FPM will allow to parse. This can
      ; prevent configuration mistakes on the web server side. You should only limit
      ; FPM to .php extensions to prevent malicious users to use other extensions to
      ; execute php code.
      ; Note: set an empty value to allow all extensions.
      ; Default Value: .php
      ;security.limit_extensions = .php .php3 .php4 .php5 .php7
    
      ; Pass environment variables like LD_LIBRARY_PATH. All $VARIABLEs are taken from
      ; the current environment.
      ; Default Value: clean env
      env[HOSTNAME] = $HOSTNAME
      env[PATH] = /usr/local/bin:/usr/bin
      env[TMP] = /tmp
      env[TMPDIR] = /tmp
      env[TEMP] = /tmp
    
      ; Additional php.ini defines, specific to this pool of workers. These settings
      ; overwrite the values previously defined in the php.ini. The directives are the
      ; same as the PHP SAPI:
      ;   php_value/php_flag             - you can set classic ini defines which can
      ;                                    be overwritten from PHP call 'ini_set'.
      ;   php_admin_value/php_admin_flag - these directives won't be overwritten by
      ;                                     PHP call 'ini_set'
      ; For php_*flag, valid values are on, off, 1, 0, true, false, yes or no.
    
      ; Defining 'extension' will load the corresponding shared extension from
      ; extension_dir. Defining 'disable_functions' or 'disable_classes' will not
      ; overwrite previously defined php.ini values, but will append the new value
      ; instead.
    
      ; Note: path INI options can be relative and will be expanded with the prefix
      ; (pool, global or /usr)
    
      ; Default Value: nothing is defined by default except the values in php.ini and
      ;                specified at startup with the -d argument
      ;php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
      ;php_flag[display_errors] = off
      ;php_admin_value[error_log] = /var/log/fpm-php.www.log
      ;php_admin_flag[log_errors] = on
      ;php_admin_value[memory_limit] = 32M
    
      php_value[date.timezone] = Europe/Berlin
    
      php_value[open_basedir] = /var/lib/$pool:/tmp:/usr/share/webapps/$pool:/etc/webapps/$pool:/dev/urandom:/usr/lib/php/modules:/var/log/$pool:/proc/meminfo
    
      ; put session data in dedicated directory
      php_value[session.save_path] = /var/lib/$pool/sessions
      php_value[session.gc_maxlifetime] = 21600
      php_value[session.gc_divisor] = 500
      php_value[session.gc_probability] = 1
    
      php_flag[expose_php] = false
      php_value[post_max_size] = 1000M
      php_value[upload_max_filesize] = 1000M
    
      ; as recommended in admin manual (avoids related warning in admin GUI later)
      php_flag[output_buffering] = off
      php_value[max_input_time] = 120
      php_value[max_execution_time] = 60
    
      php_value[memory_limit] = 768M
    
      ; opcache settings must be defined in php-fpm.ini. otherwise (i.e. when defined here)
      ; this causes segmentation faults in php-fpm worker processes
    
      ; uncomment if php-apcu is installed and used
      ; php_value[extension] = apcu
      ; (see https://github.com/krakjoe/apcu/blob/simplify/INSTALL)
      php_value[apc.ttl] = 7200
      php_flag[apc.enable_cli] = 1
    
      php_value[extension] = bcmath
      php_value[extension] = bz2
      php_value[extension] = exif
      php_value[extension] = gd
      php_value[extension] = gmp
      ; uncomment if php-imagick is installed and used
      php_value[extension] = imagick
      ; uncomment if php-imap is installed and used
      ; php_value[extension] = imap
      ; recommended to enable
      php_value[extension] = intl
      php_value[extension] = iconv
      ; uncomment if php-memcached is installed and used
      ; php_value[extension] = memcached
      ; uncomment exactly one of the pdo extensions
      php_value[extension] = pdo_mysql
      ; php_value[extension] = pdo_pgsql
      ; php_value[extension] = pdo_sqlite
      ; uncomment if php-igbinary is installed and used
      ; php_value[extension] = igbinary
      ; uncomment if php-redis is installed and used (requires php-igbinary)
      ; php_value[extension] = redis
      ; uncomment if php-xsl is installed and used
      ; php_value[extension] = xsl

4-2. cloud.mysite.com.conf

  •   upstream php-handler {
          server 127.0.0.1:9000;
          #server unix:/var/run/php/php7.4-fpm.sock;
      }
    
      # Set the `immutable` cache control options only for assets with a cache busting `v` argument
      map $arg_v $asset_immutable {
          "" "";
          default "immutable";
      }
    
      server {
          listen 80;
          listen [::]:80;
          server_name cloud.example.com;
    
          # Prevent nginx HTTP Server Detection
          server_tokens off;
    
          # Enforce HTTPS just for `/nextcloud`
          location /nextcloud {
              return 301 https://$server_name$request_uri;
          }
      }
    
      server {
          listen 443      ssl http2;
          listen [::]:443 ssl http2;
          server_name cloud.example.com;
    
          # Path to the root of the domain
          root /var/www;
    
          # Use Mozilla's guidelines for SSL/TLS settings
          # https://mozilla.github.io/server-side-tls/ssl-config-generator/
          ssl_certificate     /etc/ssl/nginx/cloud.example.com.crt;
          ssl_certificate_key /etc/ssl/nginx/cloud.example.com.key;
    
          # Prevent nginx HTTP Server Detection
          server_tokens off;
    
          # HSTS settings
          # WARNING: Only add the preload option once you read about
          # the consequences in https://hstspreload.org/. This option
          # will add the domain to a hardcoded list that is shipped
          # in all major browsers and getting removed from this list
          # could take several months.
          #add_header Strict-Transport-Security "max-age=15768000; includeSubDomains; preload" always;
    
          location = /robots.txt {
              allow all;
              log_not_found off;
              access_log off;
          }
    
          location ^~ /.well-known {
              # The rules in this block are an adaptation of the rules
              # in the Nextcloud `.htaccess` that concern `/.well-known`.
    
              location = /.well-known/carddav { return 301 /nextcloud/remote.php/dav/; }
              location = /.well-known/caldav  { return 301 /nextcloud/remote.php/dav/; }
    
              location /.well-known/acme-challenge    { try_files $uri $uri/ =404; }
              location /.well-known/pki-validation    { try_files $uri $uri/ =404; }
    
              # Let Nextcloud's API for `/.well-known` URIs handle all other
              # requests by passing them to the front-end controller.
              return 301 /nextcloud/index.php$request_uri;
          }
    
          location ^~ /nextcloud {
              # set max upload size and increase upload timeout:
              client_max_body_size 512M;
              client_body_timeout 300s;
              fastcgi_buffers 64 4K;
    
              # Enable gzip but do not remove ETag headers
              gzip on;
              gzip_vary on;
              gzip_comp_level 4;
              gzip_min_length 256;
              gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
              gzip_types application/atom+xml application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/wasm application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;
    
              # Pagespeed is not supported by Nextcloud, so if your server is built
              # with the `ngx_pagespeed` module, uncomment this line to disable it.
              #pagespeed off;
    
              # The settings allows you to optimize the HTTP2 bandwitdth.
              # See https://blog.cloudflare.com/delivering-http-2-upload-speed-improvements/
              # for tunning hints
              client_body_buffer_size 512k;
    
              # HTTP response headers borrowed from Nextcloud `.htaccess`
              add_header Referrer-Policy                      "no-referrer"   always;
              add_header X-Content-Type-Options               "nosniff"       always;
              add_header X-Download-Options                   "noopen"        always;
              add_header X-Frame-Options                      "SAMEORIGIN"    always;
              add_header X-Permitted-Cross-Domain-Policies    "none"          always;
              add_header X-Robots-Tag                         "none"          always;
              add_header X-XSS-Protection                     "1; mode=block" always;
    
              # Remove X-Powered-By, which is an information leak
              fastcgi_hide_header X-Powered-By;
    
              # Specify how to handle directories -- specifying `/nextcloud/index.php$request_uri`
              # here as the fallback means that Nginx always exhibits the desired behaviour
              # when a client requests a path that corresponds to a directory that exists
              # on the server. In particular, if that directory contains an index.php file,
              # that file is correctly served; if it doesn't, then the request is passed to
              # the front-end controller. This consistent behaviour means that we don't need
              # to specify custom rules for certain paths (e.g. images and other assets,
              # `/updater`, `/ocm-provider`, `/ocs-provider`), and thus
              # `try_files $uri $uri/ /nextcloud/index.php$request_uri`
              # always provides the desired behaviour.
              index index.php index.html /nextcloud/index.php$request_uri;
    
              # Rule borrowed from `.htaccess` to handle Microsoft DAV clients
              location = /nextcloud {
                  if ( $http_user_agent ~ ^DavClnt ) {
                      return 302 /nextcloud/remote.php/webdav/$is_args$args;
                  }
              }
    
              # Rules borrowed from `.htaccess` to hide certain paths from clients
              location ~ ^/nextcloud/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|/)    { return 404; }
              location ~ ^/nextcloud/(?:\.|autotest|occ|issue|indie|db_|console)                  { return 404; }
    
              # Ensure this block, which passes PHP files to the PHP process, is above the blocks
              # which handle static assets (as seen below). If this block is not declared first,
              # then Nginx will encounter an infinite rewriting loop when it prepends
              # `/nextcloud/index.php` to the URI, resulting in a HTTP 500 error response.
              location ~ \.php(?:$|/) {
                  # Required for legacy support
                  rewrite ^/nextcloud/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|oc[ms]-provider\/.+|.+\/richdocumentscode\/proxy) /nextcloud/index.php$request_uri;
    
                  fastcgi_split_path_info ^(.+?\.php)(/.*)$;
                  set $path_info $fastcgi_path_info;
    
                  try_files $fastcgi_script_name =404;
    
                  include fastcgi_params;
                  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                  fastcgi_param PATH_INFO $path_info;
                  fastcgi_param HTTPS on;
    
                  fastcgi_param modHeadersAvailable true;         # Avoid sending the security headers twice
                  fastcgi_param front_controller_active true;     # Enable pretty urls
                  fastcgi_pass php-handler;
    
                  fastcgi_intercept_errors on;
                  fastcgi_request_buffering off;
    
                  fastcgi_max_temp_file_size 0;
              }
    
              location ~ \.(?:css|js|svg|gif|png|jpg|ico|wasm|tflite|map)$ {
                  try_files $uri /nextcloud/index.php$request_uri;
                  add_header Cache-Control "public, max-age=15778463, $asset_immutable";
                  access_log off;     # Optional: Don't log access to assets
    
                  location ~ \.wasm$ {
                      default_type application/wasm;
                  }
              }
    
              location ~ \.woff2?$ {
                  try_files $uri /nextcloud/index.php$request_uri;
                  expires 7d;         # Cache-Control policy borrowed from `.htaccess`
                  access_log off;     # Optional: Don't log access to assets
              }
    
              # Rule borrowed from `.htaccess`
              location /nextcloud/remote {
                  return 301 /nextcloud/remote.php$request_uri;
              }
    
              location /nextcloud {
                  try_files $uri $uri/ /nextcloud/index.php$request_uri;
              }
          }
      }





2020-03-12

[nodejs] express 사용한 web server 개발 준비


개인적으로 nodejs 공부 하던중에 개인용으로 사용할 간단한 web server를 만들어보면서  블로그 업데이트를 해야겠다고 생각했다.
windows 10에 wsl ubuntu내에서 작업하였다.
nodejs를 공부하던 중이라서 1. 설치 정보의 nodejs, npm, express-generator는 이미 설치 되어 있었다.

1. 사전 설치 정보
$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 18.04.4 LTS
Release:        18.04
Codename:       bionic

$ nodejs --version
v12.16.1

$ npm --version
6.14.2

$ express --version
4.16.1

2. express 작업 디렉토리 설정
home_server라는 작업 디렉토리를 사용할것이다. 다른 디렉토리를 원하면 아래 명령에서 이름을 바꿔주면 된다.

$ express home_server --view=pug

   create : home_server/
   create : home_server/public/
   create : home_server/public/javascripts/
   create : home_server/public/images/
   create : home_server/public/stylesheets/
   create : home_server/public/stylesheets/style.css
   create : home_server/routes/
   create : home_server/routes/index.js
   create : home_server/routes/users.js
   create : home_server/views/
   create : home_server/views/error.pug
   create : home_server/views/index.pug
   create : home_server/views/layout.pug
   create : home_server/app.js
   create : home_server/package.json
   create : home_server/bin/
   create : home_server/bin/www

   change directory:
     $ cd home_server

   install dependencies:
     $ npm install

   run the app:
     $ DEBUG=home-server:* npm start

3. npm module 설치
express-generator를 사용하여 정상적으로 설정되면 마지막부분에 따라해야할 명령어들이 출력되어 있다. 그대로 실행해주면 된다.

$ cd home_server/
$ npm install
npm WARN deprecated core-js@2.6.11: core-js@<3 is no longer maintained and not recommended for usage due to the number of issues. Please, upgrade your dependencies to the actual version of core-js@3.

> core-js@2.6.11 postinstall /mnt/d/workspace/nodejs/home_server/node_modules/core-js
> node -e "try{require('./postinstall')}catch(e){}"

Thank you for using core-js ( https://github.com/zloirock/core-js ) for polyfilling JavaScript standard library!

The project needs your help! Please consider supporting of core-js on Open Collective or Patreon:
> https://opencollective.com/core-js
> https://www.patreon.com/zloirock

Also, the author of core-js ( https://github.com/zloirock ) is looking for a good job -)

npm notice created a lockfile as package-lock.json. You should commit this file.
added 118 packages from 174 contributors and audited 247 packages in 13.22s

2 packages are looking for funding
  run `npm fund` for details

found 1 low severity vulnerability
  run `npm audit fix` to fix them, or `npm audit` for details

4. 취약점 수정
3절 설치 과정 마지막에 취약점 정보가 1개 존재한다고한다.
친절하게 npm audit fix를 사용하라고 적혀있다.

$ npm audit fix
npm WARN deprecated core-js@2.6.11: core-js@<3 is no longer maintained and not recommended for usage due to the number of issues. Please, upgrade your dependencies to the actual version of core-js@3.
+ pug@2.0.4
removed 3 packages and updated 8 packages in 2.373s
fixed 1 of 1 vulnerability in 247 scanned packages

1개의 취약점 중 1개 수정되었다고 출력되었다. 혹시 모르니 다시 한번 입력해보았다.

$ npm audit fix
up to date in 0.532s

2 packages are looking for funding
  run `npm fund` for details

fixed 0 of 0 vulnerabilities in 244 scanned packages

5. test
npm start 명령으로 web server 실행후 웹브라우저로 접속하여보았다.

$ npm start

> home-server@0.0.0 start /nodejs/home_server
> node ./bin/www

5.1) 웹브라우저 접속 결과


5.2) 콘솔 출력 로그
GET / 304 387.352 ms - -
GET /stylesheets/style.css 200 4.508 ms - 111


express를 사용한 웹서버가 정상 동작하는것을 볼수 있다.



2019-02-19

[firefox] 링크 새탭으로 열기


firefox사용시 링크 누르면 현재 탭이 새창으로 변경되는 불편함이 있어서 링크를 새탭으로 여는 설정을 작성한다.

firefox 주소창에 about:config를 입력한다.


browser.search.openintab 의 값을 찾아서 true로 변경한다.

firefox를 재시작한다.

2017-09-15

[FFMPEG] linux mint에서 ffmpeg 빌드 하기


ffmpeg을 직접 빌드해야하는 이슈가 발생하여 linuxmint-18.2-mate-64bit 에서 빌드한 내용을 남긴다.

아래 링크를 참조하여 작업하였다.
https://trac.ffmpeg.org/wiki/CompilationGuide/Ubuntu

1. 종속성 라이브러리 설치
$ sudo apt-get update
$ sudo apt-get -y install autoconf automake build-essential libass-dev libfreetype6-dev libsdl2-dev libtheora-dev libtool libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev pkg-config texinfo wget zlib1g-dev

2. 설치시 사용할 디렉토리 생성
$ mkdir ~/ffmpeg_sources ~/ffmpeg_build ~/bin

3. yasm 설치
$ sudo apt-get install yasm

4. nasm 설치
$ cd ~/ffmpeg_sources
$ wget http://www.nasm.us/pub/nasm/releasebuilds/2.13.01/nasm-2.13.01.tar.bz2
$ tar xjvf nasm-2.13.01.tar.bz2
$ cd nasm-2.13.01
$ ./autogen.sh
$ PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin"
$ PATH="$HOME/bin:$PATH" make
$ make install

5. libx264 설치
$ sudo apt-get install libx264-dev

6. libx265 설치
$ sudo apt-get install libx265-dev

7. libfdk-aac 설치
$ sudo apt-get install libfdk-aac-dev

8. libfdk-aac 설치
$ sudo apt-get install libmp3lame-dev

9. libfdk-aac 설치
$ sudo apt-get install libopus-dev

10. libfdk-aac 설치
$ sudo apt-get install libvpx-dev

11. ffmpeg 빌드 및 설치
$ cd ~/ffmpeg_sources
$ wget http://ffmpeg.org/releases/ffmpeg-snapshot.tar.bz2
$ tar xjvf ffmpeg-snapshot.tar.bz2
$ cd ffmpeg
$ PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" $ ./configure --prefix="$HOME/ffmpeg_build" --pkg-config-flags="--static" --extra-cflags="-I$HOME/ffmpeg_build/include" --extra-ldflags="-L$HOME/ffmpeg_build/lib" --bindir="$HOME/bin" --enable-gpl --enable-libass --enable-libfdk-aac --enable-libfreetype --enable-libmp3lame --enable-libopus --enable-libtheora --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libx265 --enable-nonfree
$ PATH="$HOME/bin:$PATH" make
$ make install

12. ffmpeg 동작 확인
$ ./ffmpeg -version
ffmpeg version N-87286-g6ce4a63 Copyright (c) 2000-2017 the FFmpeg developers
built with gcc 5.4.0 (Ubuntu 5.4.0-6ubuntu1~16.04.4) 20160609
configuration: --prefix=/home/sharpis/ffmpeg_build --pkg-config-flags=--static --extra-cflags=-I/home/sharpis/ffmpeg_build/include --extra-ldflags=-L/home/sharpis/ffmpeg_build/lib --bindir=/home/sharpis/bin --enable-gpl --enable-libass --enable-libfdk-aac --enable-libfreetype --enable-libmp3lame --enable-libopus --enable-libtheora --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libx265 --enable-nonfree
libavutil      55. 74.100 / 55. 74.100
libavcodec     57.105.100 / 57.105.100
libavformat    57. 82.100 / 57. 82.100
libavdevice    57.  8.100 / 57.  8.100
libavfilter     6.105.100 /  6.105.100
libswscale      4.  7.103 /  4.  7.103
libswresample   2.  8.100 /  2.  8.100
libpostproc    54.  6.100 / 54.  6.100

13. troubleshoot
A. 11에 configure 에서 "ERROR: x265 not found using pkg-config" 오류 발생 시 libx265을 아래와 같이 소스 설치 후 다시 시도 한다.
$ sudo apt-get install cmake mercurial
$ cd ~/ffmpeg_sources
$ hg clone https://bitbucket.org/multicoreware/x265
$ cd ~/ffmpeg_sources/x265/build/linux
$ PATH="$HOME/bin:$PATH" cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED:bool=off ../../source
$ make
$ make install


2017-03-04

[MINGW/MSYS] beep음 off 하는 방법


windows에서 msys를 사용하던 중 beep음이 많이 신경이 쓰여서 beep음을 없애야했다.
노가다로 msys 설정 파일들을 확인하면서 찾아낸 방법을 기록해둔다.

msys 창에서 inputrc파일을 연다.
1. inputrc파일 을 연다.
$ vim ~/.inputrc

2. "set bell-style" 이 포함된 라인을 찾아서 다음과 같이 수정한다.
# none, visible or audible
#set bell-style audible
set bell-style none

3. msys 창을 종료 후 다시 실행하면 더이상 beep음이 발생하지 않는다.

4. vimrc 파일을 연다.
$ vim ~/.vimrc

5. 아래 라인을 추가한다.
set noerrorbells
set vb t_vb=

6. vim 을 다시 실행하면 vim beep음도 더 이상 발생하지 않는다.

2015-11-20

[JAVA] JNI용 C header file 생성 (javah)

오랜만에 JNI를 사용하여 라이브러리를 작성할 일이 생겼다.
JNI를 사용할 때 c 함수 형태를 java code에서 호출할 수 있게 생성해야한다.
이를 쉽게 해주는 tool이 javah인데, 너무 오랜만에 사용했더니 사용법잘생각이 안났다.
나중에 다시 찾을때를 위해 간단히 기록해둔다.

javah help 페이지는 아래와 같다.
> javah --help
Usage:
  javah [options] <classes>
where [options] include:
  -o <file>                Output file (only one of -d or -o may be used)
  -d <dir>                 Output directory
  -v  -verbose             Enable verbose output
  -h  --help  -?           Print this message
  -version                 Print version information
  -jni                     Generate JNI-style header file (default)
  -force                   Always write output files
  -classpath <path>        Path from which to load classes
  -cp <path>               Path from which to load classes
  -bootclasspath <path>    Path from which to load bootstrap classes
<classes> are specified with their fully qualified names
(for example, java.lang.Object).

example)
> javah -classpath E:\workspace\android\testpackage\src\main\java>javah -classpath C:\Android\sdk\platforms\android-23\andro
id.jar; testpackage.TestClass

2015-08-30

[debian] apache2 web server 간단한 설정

집에서 사용하는 개인용 Debian에서 apache2로 web server를 설정하는 방법을 기록한다.

1. 준비
Debian 설치시 옵션으로 web server를 사용하겠다고 선택했더니 이미 apache2가 설치되어 있었다. 방화벽도 열려 있었다.
기본 설정 파일 내용은 변경을 거의 안할것다. 일부 보안 관련 설정만 작업 할 것이다.

web root : /var/www/html (기본 설정)

2. security.conf 수정
# vi /etc/apache2/conf-available/security.conf

<Directory />
   AllowOverride None
   Order Deny,Allow
   Deny from all
</Directory>

<Directory /var/www/html>
   AllowOverride None
   Order Deny,Allow
   Allow from all
</Directory>

ServerTokens Prod
ServerSignature Off
TraceEnable On

3. user 추가
# htpasswd -c /etc/apache2/passwd userid

4. 디렉토리 설정
# vi /etc/apache2/conf-available/video.conf
<Directory /var/www/html/video>
   Order Deny,Allow
   AuthType Basic
   AuthName "testauthname"
   AuthUserFile /etc/apache2/passwd
   Require valid-user
</Directory>

5. 설정 파일 link
# ln -s /etc/apache2/conf-available/video.conf /etc/apache2/conf-enabled/video.conf

6. 재시작
# service apache2 restart

웹 브라우저에 video 디렉 토리 접근시 3번 과정에서 추가한 userid와 password를 요구한다.



2015-08-22

[debian] torrent 설정

debian linux에서 torrent daemon(transmission-daemon) 을 설정한다.

1. 준비
torrent 자동 추가 디렉토리 : "/mnt/exhdd/seagate_hdd/torrent/input"
torrent 임시 디렉토리 : "/mnt/exhdd/seagate_hdd/torrent/tmp"
torrent 다운로드 디렉토리 : "/mnt/exhdd/seagate_hdd/torrent/down"


2. 설치
# apt-get install transmission-daemon


3. 서비스 종료 (안하면, 설정이 수정안됨)
# service transmission-daemon stop

4. 설정
# vi /etc/transmission-daemon/settings.json
아래 url에서 설정관련 추가 정보를 얻을수 있다.
https://trac.transmissionbt.com/wiki/EditConfigFiles

{
    "alt-speed-down": 50,
    "alt-speed-enabled": false,
    "alt-speed-time-begin": 540,
    "alt-speed-time-day": 127,
    "alt-speed-time-enabled": false,
    "alt-speed-time-end": 1020,
    "alt-speed-up": 50,
    "bind-address-ipv4": "0.0.0.0",
    "bind-address-ipv6": "::",
    "blocklist-enabled": false,
    "blocklist-url": "http://www.example.com/blocklist",
    "cache-size-mb": 4,
    "dht-enabled": true,
    "download-dir": "/mnt/exhdd/seagate_hdd/torrent/down",
    "download-limit": 100,
    "download-limit-enabled": 0,
    "download-queue-enabled": true,
    "download-queue-size": 5,
    "encryption": 1,
    "idle-seeding-limit": 30,
    "idle-seeding-limit-enabled": false,
    "incomplete-dir": "/mnt/exhdd/seagate_hdd/torrent/tmp",
    "incomplete-dir-enabled": true,
    "lpd-enabled": false,
    "max-peers-global": 200,
    "message-level": 1,
    "peer-congestion-algorithm": "",
    "peer-id-ttl-hours": 6,
    "peer-limit-global": 200,
    "peer-limit-per-torrent": 50,
    "peer-port": 51413,
    "peer-port-random-high": 65535,
    "peer-port-random-low": 49152,
    "peer-port-random-on-start": false,
    "peer-socket-tos": "default",
    "pex-enabled": true,
    "port-forwarding-enabled": false,
    "preallocation": 1,
    "prefetch-enabled": 1,
    "queue-stalled-enabled": true,
    "queue-stalled-minutes": 30,
    "ratio-limit": 2,
    "ratio-limit-enabled": false,
    "rename-partial-files": true,
    "rpc-authentication-required": true,
    "rpc-bind-address": "0.0.0.0",
    "rpc-enabled": true,
    "rpc-password": "torrent_password",
    "rpc-port": 9091,
    "rpc-url": "/transmission/",
    "rpc-username": "torrent_id",
    "rpc-whitelist": "192.168.0.2",
    "rpc-whitelist-enabled": true,
    "scrape-paused-torrents-enabled": true,
    "script-torrent-done-enabled": false,
    "script-torrent-done-filename": "",
    "seed-queue-enabled": false,
    "seed-queue-size": 10,
    "speed-limit-down": 100,
    "speed-limit-down-enabled": false,
    "speed-limit-up": 100,
    "speed-limit-up-enabled": false,
    "start-added-torrents": true,
    "trash-original-torrent-files": false,
    "umask": 18,
    "upload-limit": 100,
    "upload-limit-enabled": 0,
    "upload-slots-per-torrent": 14,
    "utp-enabled": true,
    "watch-dir": "/mnt/exhdd/seagate_hdd/torrent/input",
    "watch-dir-enabled": true,
    "trash-original-torrent_files": true
}


5. 재시작
# service transmission-daemon restart


6. web browser로 동작 확인
web browser에서 http://192.168.0.3:9091/transmission/
id : torrent_id
password : torrent_password




2015-08-20

[debian] samba 설치

debian linux에서 samba를 설치 및 설정 하여 windows와 디렉토리를 공유한다.

1. 준비
공유 할 디렉토리는 /mnt/exhdd 이다.
공유 시 사용할 계정은 userid이다.


2. samba 설치
# apt-get install samba


3. samba 설정, 아래 구문 추가
# vi /etc/samba/smb.conf

[exhdd]
   path = /mnt/exhdd
   valid users = userid
   writeable = yes
   browseable = yes


4. samba 계정 등록
# smbpasswd -a userid
New SMB password:
Retype new SMB password:
Added user sharpis.


5. samba 설정 적용
# service samba reload


6. 탐색기에서 "\\IP주소" 형태로 접속한다.
ex) \\192.168.0.2


[debian] 외장 하드 자동 mount 하는 방법

debian에서 usb 외장하드를 자동 mount 하는 방법
매번 mount 명령을 사용하여 수동 mount 할수 있지만, 부팅시 자동 mount 할수 있게 설정할수 있는 방법 작성한다.

1. 준비
Seagate 외장 HDD, ntfs 포멧 되어 있음.
mount할 디렉토리 경로는 /mnt/exhdd/seagate_hdd 이다.

2. Seagate 외장 HDD의 장치 명 확인
# ls -l /dev/disk/by-label/

lrwxrwxrwx 1 root root 10 Aug 19 22:36 Seagate\x20Backup\x20Plus\x20Drive -> ../../sdb1


3. Seagate 외장 HDD의 uuid확인
# ls -l /dev/disk/by-uuid/

lrwxrwxrwx 1 root root 10 Aug 19 22:36 0bc18742-2f05-4bce-9d40-f2fe5e89bc1a -> ../../sda5
lrwxrwxrwx 1 root root 10 Aug 19 22:36 A4E83FF7E83FC5F8 -> ../../sdb1
lrwxrwxrwx 1 root root 10 Aug 19 22:36 c537dfe8-75dd-41d5-89d9-2e3d8f7a5515 -> ../../sda1


4. fstab 파일 설정, /etc/fstab에 아래 색으로 칠한 구문 추가
# vi /etc/fstab

# /etc/fstab: static file system information.
#
# Use 'blkid' to print the universally unique identifier for a
# device; this may be used with UUID= as a more robust way to name devices
# that works even if disks are added and removed. See fstab(5).
#
# <file system> <mount point>   <type>  <options>       <dump>  <pass>
# / was on /dev/sda1 during installation
UUID=c537dfe8-75dd-41d5-89d9-2e3d8f7a5515 /               ext4    errors=remount-ro 0       1
# swap was on /dev/sda5 during installation
UUID=0bc18742-2f05-4bce-9d40-f2fe5e89bc1a none            swap    sw              0       0
/dev/sr0        /media/cdrom0   udf,iso9660 user,noauto     0       0

# external hdd
UUID=A4E83FF7E83FC5F8 /mnt/exhdd/seagate_hdd               ntfs    errors=remount-ro 1       1

5. mount 경로 생성
# mkdir -p /mnt/exhdd/seagate_hdd

6. 재시작
# init 6


7. 확인
# mount
sysfs on /sys type sysfs (rw,nosuid,nodev,noexec,relatime)
proc on /proc type proc (rw,nosuid,nodev,noexec,relatime)
udev on /dev type devtmpfs (rw,relatime,size=10240k,nr_inodes=216982,mode=755)
devpts on /dev/pts type devpts (rw,nosuid,noexec,relatime,gid=5,mode=620,ptmxmode=000)
tmpfs on /run type tmpfs (rw,nosuid,relatime,size=401404k,mode=755)
/dev/sda1 on / type ext4 (rw,relatime,errors=remount-ro,data=ordered)
securityfs on /sys/kernel/security type securityfs (rw,nosuid,nodev,noexec,relatime)
tmpfs on /dev/shm type tmpfs (rw,nosuid,nodev)
tmpfs on /run/lock type tmpfs (rw,nosuid,nodev,noexec,relatime,size=5120k)
tmpfs on /sys/fs/cgroup type tmpfs (ro,nosuid,nodev,noexec,mode=755)
cgroup on /sys/fs/cgroup/systemd type cgroup (rw,nosuid,nodev,noexec,relatime,xattr,release_agent=/lib/systemd/systemd-cgroups-agent,name=systemd)
pstore on /sys/fs/pstore type pstore (rw,nosuid,nodev,noexec,relatime)
cgroup on /sys/fs/cgroup/cpuset type cgroup (rw,nosuid,nodev,noexec,relatime,cpuset)
cgroup on /sys/fs/cgroup/cpu,cpuacct type cgroup (rw,nosuid,nodev,noexec,relatime,cpu,cpuacct)
cgroup on /sys/fs/cgroup/devices type cgroup (rw,nosuid,nodev,noexec,relatime,devices)
cgroup on /sys/fs/cgroup/freezer type cgroup (rw,nosuid,nodev,noexec,relatime,freezer)
cgroup on /sys/fs/cgroup/net_cls,net_prio type cgroup (rw,nosuid,nodev,noexec,relatime,net_cls,net_prio)
cgroup on /sys/fs/cgroup/blkio type cgroup (rw,nosuid,nodev,noexec,relatime,blkio)
cgroup on /sys/fs/cgroup/perf_event type cgroup (rw,nosuid,nodev,noexec,relatime,perf_event)
systemd-1 on /proc/sys/fs/binfmt_misc type autofs (rw,relatime,fd=22,pgrp=1,timeout=300,minproto=5,maxproto=5,direct)
mqueue on /dev/mqueue type mqueue (rw,relatime)
fusectl on /sys/fs/fuse/connections type fusectl (rw,relatime)
hugetlbfs on /dev/hugepages type hugetlbfs (rw,relatime)
debugfs on /sys/kernel/debug type debugfs (rw,relatime)
rpc_pipefs on /run/rpc_pipefs type rpc_pipefs (rw,relatime)
tmpfs on /run/user/118 type tmpfs (rw,nosuid,nodev,relatime,size=200704k,mode=700,uid=118,gid=125)
tmpfs on /run/user/1000 type tmpfs (rw,nosuid,nodev,relatime,size=200704k,mode=700,uid=1000,gid=1000)
binfmt_misc on /proc/sys/fs/binfmt_misc type binfmt_misc (rw,relatime)
/dev/sdb1 on /mnt/exhdd/seagate_hdd type fuseblk (rw,relatime,user_id=0,group_id=0,allow_other,blksize=4096)








2015-08-19

[debian] notebook 덮개 설정

notebook에 debian 설치 후 덮개를 닫을때 절전 모드로 동작하는 문제가 있었다.

notebook 덮개 닫을때 아무 동작 안하게 설정하는 방법은 남긴다.

1. 아래 명령으로 logind.conf 파일을 연다.
# vi /etc/systemd/logind.conf

2. 덮개 닫을때 아무 동작 안하는 설정 추가한다.
   아래 구문을 설정파일에 추가한다.
HandleLidSwitch=ignore

이제 덮개를 닫아도 절전모드로 동작 하지 않는다.

2014-10-19

MD5 hash 값 확인 방법

테스트 베드에 올려서 테스트한 결과가 개발 시 테스트 결과와 달라서 확인하여보니 테스트 데이터 파일이 변조 되어있었다.

그래서 테스터에게 MD5 hash 검증 방법을 공유하는 김에 블로그에도 글을 남긴다.
openssl 사용법은 기존에 알고 있었으나 Fciv툴은 이번에 처음 알게 되었다.

- hash 검증 순서
1. 원본 파일 hash 값을 구함
2. 원본 파일과 1의 hash 값 배포.
3. 배포된 파일 hash 값을 구함.
4. 1,3의 hash 값이 같으면 동일 한 것, 다르면 변조된 것으로 판단.

- hash 값 구하는 법
1. Openssl 사용

  • Openssl은 linux 계열 OS 설치 시 기본 옵션으로 설치되거나 설치 패키지가 제공 됨.
  • Windows 계열은 msys나 cygwin설치 시 패키지로 설치 시 사용 가능. 
  • 직접 소스를 구하며 빌드 하여도 됨.
  • 사용법 openssl md5 <파일명 | 경로>

      > openssl md5 test.dat
      MD5(test.dat)= d2b91d550d1a876f347ab0cc7b6d66c9

2. Fciv 사용 microsoft에서 제공하는 파일 위변조 검증 툴.

  • Windows 계열에서 사용 가능.
  • 아래 경로에서 다운로드 받아서 사용하면 된다. 
  • http://support2.microsoft.com/kb/841290  - Installation에 다운로드 링크 있음
  • fciv.zip  - 위에 파일을 다운 받아서 zip으로 압축 해둔 것
  • 압축 해제해서 생성되는 Fciv.exe 파일경로를 path 환경 변수 설정하거나 windows\system32 폴더에 복사하는 것을 권장. 
  • 아래 사용법을 보면 알겠지만, 파일명이나 절대경로를 입력해야하기 때문에 환경변수 설정 안 해두면 사용하기 불편함.
  • 사용법 fciv <파일명 | 절대경로> -md5
      > fciv olympic-GD-60p_mov_60fps_10bit.ts -md5
      //
      // File Checksum Integrity Verifier version 2.05.
      //
      d2b91d550d1a876f347ab0cc7b6d66c9 test.dat

openssl이나 fciv나 사용 시 md5 대신 sha1를 사용하면 sha1 hash 값을 구할 수도 있다.


2013-11-18

[CUnit] CUnit 사용법


CUnit 사용법에 대해 알아본다. CUnit은 모듈의 기능 테스트에 적합한 것 같다.

CUnit설치 방법은 이전 게시물을 참고한다.
CUnit 설치 방법

아래 페이지를 참고하여 작성하였다. 아래 페이지 내용의 일부분으로 API 중 자주 사용할 것 같은 부분이나 CUnit 설명들 필요한 부분만 작성하였다.
http://cunit.sourceforge.net/doc/index.html

1. 테스트 구조
CUnit의 테스트 구조는 아래와 같다.
Registry가 있고, Registry내부에 Suite들이 존재한다. 그리고 Suite내부에 Test들이 존재한다.

                      Test Registry
                            |
             ------------------------------
             |                            |
          Suite '1'      . . . .       Suite 'N'
             |                            |
       ---------------             ---------------
       |             |             |             |
    Test '11' ... Test '1M'     Test 'N1' ... Test 'NM'

2. 일반적인 사용법
  1) 테스트 함수 작성 (필요에 따라서 Initialize, Cleanup함수도 작성)
  2) Registry에 등록 (CU_initialize_registry() 사용)
  3) Registry에 Suite 등록 (CU_add_suite() 사용)
  4) Suite에 Test 등록 (CU_add_test() 사용)
  5) Running모드 함수 사용 (CU_console_run_tests() 등)
  6) Registry 초기화 (CU_cleanup_registry() 사용)

3. Registry API
  1) CU_ErrorCode CU_initialize_registry(void)
  다른 CUnit 함수들을 사용전에 반드시 사용되어야한다.
  Return Value
  CUE_SUCCESS initialization was successful.
  CUE_NOMEMORY memory allocation failed.

  사용 예)
    if (CUE_SUCCESS != CU_initialize_registry())
        return CU_get_error();

  2) void CU_cleanup_registry(void)
  테스트가 완료되면 메모리를 반환하기 위하여 사용한다.
  사용 예)
    CU_cleanup_registry();

4. Suite API
  CU_pSuite CU_add_suite(const char* strName, CU_InitializeFunc pInit, CU_CleanupFunc pClean)
  Suite를 생성한다. 생성된 Suite는 자동으로 Registry에 등록된다. pInit과 pClean은  0를 return하면 Success로 처리되고, 0이 아니면 fail로 처리되는 파라미터가 없는 함수를 사용한다. Optional하며 불필요시 NULL을 준다.
  Return Value
  CUE_SUCCESS suite creation was successful.
  CUE_NOREGISTRY the registry has not been initialized.
  CUE_NO_SUITENAME strName was NULL.
  CUE_DUP_SUITE the suite's name was not unique.
  CUE_NOMEMORY memory allocation failed.

  사용 예)
    pSuite = CU_add_suite("Suite_1", init_suite1, clean_suite1);
    if (NULL == pSuite) {
        CU_cleanup_registry();
        return CU_get_error();
    }

5. Test 등록 API
  CU_pTest CU_add_test(CU_pSuite pSuite, const char* strName, CU_TestFunc pTestFunc)
  Suite에 Test를 등록시 사용한다.
  Return Value 
  CUE_SUCCESS suite creation was successful.
  CUE_NOSUITE the specified suite was NULL or invalid.
  CUE_NO_TESTNAME strName was NULL.
  CUE_NO_TEST pTestFunc was NULL or invalid.
  CUE_DUP_TEST the test's name was not unique.
  CUE_NOMEMORY memory allocation failed.

  사용 예)
    if ((NULL == CU_add_test(pSuite, "test of fprintf()", testFPRINTF)) )
    {
        CU_cleanup_registry();
        return CU_get_error();
    }

6. Test API
다음은 CUnit에서 제공하는 Test용 API다.
#include <CUnit/CUnit.h>
CU_ASSERT(int expression)
CU_ASSERT_FATAL(int expression)
CU_TEST(int expression)
CU_TEST_FATAL(int expression)
Assert that expression is TRUE (non-zero)
CU_ASSERT_TRUE(value)
CU_ASSERT_TRUE_FATAL(value)
Assert that value is TRUE (non-zero)
CU_ASSERT_FALSE(value)
CU_ASSERT_FALSE_FATAL(value)
Assert that value is FALSE (zero)
CU_ASSERT_EQUAL(actual, expected)
CU_ASSERT_EQUAL_FATAL(actual, expected)
Assert that actual = = expected
CU_ASSERT_NOT_EQUAL(actual, expected))
CU_ASSERT_NOT_EQUAL_FATAL(actual, expected)
Assert that actual != expected
CU_ASSERT_PTR_EQUAL(actual, expected)
CU_ASSERT_PTR_EQUAL_FATAL(actual, expected)
Assert that pointers actual = = expected
CU_ASSERT_PTR_NOT_EQUAL(actual, expected)
CU_ASSERT_PTR_NOT_EQUAL_FATAL(actual, expected)
Assert that pointers actual != expected
CU_ASSERT_PTR_NULL(value)
CU_ASSERT_PTR_NULL_FATAL(value)
Assert that pointer value == NULL
CU_ASSERT_PTR_NOT_NULL(value)
CU_ASSERT_PTR_NOT_NULL_FATAL(value)
Assert that pointer value != NULL
CU_ASSERT_STRING_EQUAL(actual, expected)
CU_ASSERT_STRING_EQUAL_FATAL(actual, expected)
Assert that strings actual and expected are equivalent
CU_ASSERT_STRING_NOT_EQUAL(actual, expected)
CU_ASSERT_STRING_NOT_EQUAL_FATAL(actual, expected)
Assert that strings actual and expected differ
CU_ASSERT_NSTRING_EQUAL(actual, expected, count)
CU_ASSERT_NSTRING_EQUAL_FATAL(actual, expected, count)
Assert that 1st count chars of actual and expected are the same
CU_ASSERT_NSTRING_NOT_EQUAL(actual, expected, count)
CU_ASSERT_NSTRING_NOT_EQUAL_FATAL(actual, expected, count)
Assert that 1st count chars of actual and expected differ
CU_ASSERT_DOUBLE_EQUAL(actual, expected, granularity)
CU_ASSERT_DOUBLE_EQUAL_FATAL(actual, expected, granularity)
Assert that |actual - expected| <= |granularity|
Math library must be linked in for this assertion.
CU_ASSERT_DOUBLE_NOT_EQUAL(actual, expected, granularity)
CU_ASSERT_DOUBLE_NOT_EQUAL_FATAL(actual, expected, granularity)
Assert that |actual - expected| > |granularity|
Math library must be linked in for this assertion.
CU_PASS(message) Register a passing assertion with the specified message. No logical test is performed.
CU_FAIL(message)
CU_FAIL_FATAL(message)
Register a failed assertion with the specified message. No logical test is performed.

7. Runnting Test API
  Running Test Mode는 다음과 같이 네가지 Mode가 있다.
InterfacePlatformDescription
Automatedallnon-interactive with output to xml files
Basicallnon-interactive with optional output to stdout
Consoleallinteractive console mode under user control
CursesLinux/Unixinteractive curses mode under user control

  1) Automated
  void CU_automated_run_tests(void)
  테스트 결과가 XML 파일로 출력된다.

  2) Basic
  CU_ErrorCode CU_basic_run_tests(void)
  테스트 결과가 stdout 으로 출력된다.

  3) Console
  void CU_console_run_tests(void)
  테스트를 command ui 형태로 할 수 있다. (삼국지2 처럼 한글자 입력하는 형태)

  4) Curses
  void CU_curses_run_tests(void)
  테스트를 curses ui 형태로 할 수 있다. (테스트를 안해봐서 어떤 형태인지 잘 모르겠다)





2013-11-15

[CUnit] CUnit 설치 방법

2013-11-14 최초 작성
2014-11-27 configure 파일 미존재시 automake로  configure 파일 생성 방법 추가
                   라이브러리 제거 방법 추가

1. CUnit 이란?
c로 작성된 소스에 대해서 unit 테스트를 지원해주는 라이브러리이다.

아래 경로는 CUnit 홈페이지다.
http://cunit.sourceforge.net/

2. CUnit 소스 설치

2-1. 준비
OS : Ubuntu 12.04.3 LTS 64bit
CUnit 소스 : 아래 경로에서 CUnit 소스 코드를 다운로드 받을 수 있다.
2013-11-14 기준으로 최신 버전인 CUnit-2.1-2-src.tar.bz2를 다운로드 했다.
http://sourceforge.net/projects/cunit/

** 2014-11-27 기준으로 최신 버전인 CUnit-2.1-3.tar.bz2 까지 설치 됨을 확인 했다.

2-2. 압축 해제
# tar -nxvf CUnit-2.1-2-src.tar.bz2

2-3. configure 파일 존재 여부 확인
# cd CUnit-2.1-2
# ls -l configure

>> 다음 에러 발생시 configure 파일이 미존재. 2-4를 진행한다. <<
ls: configure에 접근할 수 없습니다: 그런 파일이나 디렉터리가 없습니다

>> 다음과 같이 출력되면 configure 파일이 존재. 2-5를 진행한다. <<
-rwxrwxr-x 1 core core 429635 11월 27 00:03 configure

2-4. configure 파일이 없는 경우. automake 로 configure 파일을 생성
# cd CUnit-2.1-2
# aclocal
# autoconf
# autoreconf --install    (2-8 에러 발생시 사용)
# automake                   (2-7 에러 발생 시 automake --add-missing를 사용)
# chmod u+x configure   (실행 권한이 없는 경우 사용한다)

2-5. 빌드 및 설치
# cd CUnit-2.1-2
# ./configure
# make
# sudo make install

2-6. 만약 2-4 진행 중 다음과 같은 에러가 발생한 경우. libtool를 설치 한다.
에러> possibly undefined macro: AC_PROG_LIBTOOL
         If this token and others are legitimate, please use m4_pattern_allow.
         See the Autoconf documentation.

해결> 아래 명령 실행 후 2-4 다시 수행
# sudo apt-get install libtool

2-7. 만약 2-4 진행 중 다음과 같은 에러가 발생한 경우.
에러> required file `./install-sh' not found
          `automake --add-missing' can install `./install-sh`

해결> 2-4에서 "automake" 대신 "automake --add-missing"를 사용한다.
        # automake --add-missing

2-8. 만약, automake 시 `config.h.in' not found 에러가 발생하는 경우.
에러> required file `config.h.in' not found

해결> automake 전에 autoreconf를 사용한다.
        # autoreconf --install
        # automake           (2-7 에러 발생 시 automake --add-missing를 사용)

3. 설치 확인
3.1 라이브러리 확인
# ls -l /usr/local/lib/libcunit*
-rw-r--r-- 1 root root 117126 11월 15 11:18 /usr/local/lib/libcunit.a
-rwxr-xr-x 1 root root   1003 11월 15 11:18 /usr/local/lib/libcunit.la
lrwxrwxrwx 1 root root     17 11월 15 11:18 /usr/local/lib/libcunit.so -> libcunit.so.1.0.1
lrwxrwxrwx 1 root root     17 11월 15 11:18 /usr/local/lib/libcunit.so.1 -> libcunit.so.1.0.1
-rwxr-xr-x 1 root root  78529 11월 15 11:18 /usr/local/lib/libcunit.so.1.0.1

3-2. CUnit 홈페이지에 있는 예제 소스를 이용하여 테스트를 한다.
아래 경로에서 소스를 복사 붙이기 하여 example.c 파일을 만든다.
http://cunit.sourceforge.net/example.html

3-3. example.c를 빌드를 한다.
# gcc -o test example.c -lcunit

3-4. 빌드한 파일을 실행한다.
# ./test

결과 ***************************************
     CUnit - A unit testing framework for C - Version 2.1-2
     http://cunit.sourceforge.net/


Suite: Suite_1
  Test: test of fprintf() ...passed
  Test: test of fread() ...passed

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      1      1    n/a      0        0
               tests      2      2      2      0        0
             asserts      5      5      5      0      n/a

Elapsed time =    0.000 seconds
********************************************

3-5. 만약 아래와 같은 오류 발생시 ldconfig 명령을 사용하여 동적 라이브러리를 등록한다.
에러> ./test: error while loading shared libraries: libcunit.so.1: cannot open shared object file: No such file or directory

해결> 아래 명령어 실행 후 3-3, 3-4 다시 수행
          # sudo ldconfig

4. 라이브러리 제거
1~3 과정으로 설치된 라이브러리를 제거한다.
# cd CUnit-2.1-2
# sudo make uninstall