SRguide

Clunix Wiki
(버전 사이의 차이)
(오타 수정)
(ASR 형식 파일 읽고 SR 값 얻어오는 방식 추가)
144번째 줄: 144번째 줄:
 
#define sr_createn1_HMS(root, LNP, type)  sr_setn1(root, LNP, sr_create_HMS(type))
 
#define sr_createn1_HMS(root, LNP, type)  sr_setn1(root, LNP, sr_create_HMS(type))
 
</pre>
 
</pre>
−
* 간단한 사용법은 [[EBCguide]] 를 참고하면 된다.
+
 
 +
=== ASR 파일 처리 ===
 +
예를 들어 아래와 같은 ASR 형식의 텍스트 파일이 있다고 가정한다.
 +
 
 +
<pre>
 +
libRvazon <dir> {
 +
vmt <dir> {
 +
vmt_1 <dir> {
 +
vmt_id <int>1;
 +
vmt_name <str>c3.xlarge;
 +
vmt_cores <int>4;
 +
vmt_mem <int>7;
 +
vmt_hdd <int>80;
 +
vmt_net_perf <str>Moderate;
 +
vmt_fee_rank <int>1;
 +
};
 +
vmt_2 <dir> {
 +
vmt_id <int>2;
 +
vmt_name <str>c3.2xlarge;
 +
vmt_cores <int>8;
 +
vmt_mem <int>15;
 +
vmt_hdd <int>160;
 +
vmt_net_perf <str>High;
 +
vmt_fee_rank <int>2;
 +
};
 +
};
 +
 
 +
rgn <dir> {
 +
rgn_1 <dir> {
 +
rgn_id <int>1;
 +
rgn_name <str>us-east-1;
 +
rgn_desc <str>"US East (N. Virginia)";
 +
};
 +
 
 +
};
 +
}
 +
</pre>
 +
 
 +
위와 같은 형식일때 sr_t 으로 반환 하는 함수는 아래와 같이 구현가능하다.
 +
 
 +
<pre>
 +
static sr_t *
 +
load_asr(const char *fpath)
 +
{
 +
sr_t *sr = NULL;
 +
int fd;
 +
char *buf;
 +
ecm_uint64 filesize;
 +
ecm_size_t buflen;
 +
 
 +
fd = ecm_open(fpath, ECM_O_RDONLY);
 +
if (fd < 0)
 +
return NULL;
 +
 
 +
if (!ecm_filesize(fd, &filesize)) {
 +
ecm_close(fd);
 +
return NULL;
 +
}
 +
 
 +
buflen = (ecm_size_t)filesize;
 +
buf = (char*)ecm_malloc(buflen + 1);
 +
if (ecm_read(fd, buf, &buflen)) {
 +
buf[buflen] = '\0';
 +
sr = sr_asr_scan(buf);
 +
}
 +
ecm_free(buf);
 +
ecm_close(fd);
 +
 
 +
return sr;
 +
}
 +
</pre>
 +
 
 +
sr_t의 포인터를 처리하는 함수는 다음과 같다.
 +
<pre>
 +
sr_get_child(sr_t *, dir 이름)
 +
 
 +
ex)
 +
sr_t *sr_vmt = sr_get_child(sr, "vmt");
 +
</pre>
 +
-> 해당 sr에서 해당 dir의 child를 반환한다.
 +
 
 +
 
 +
<pre>
 +
sr_get_num_child(sr_t *)
 +
 
 +
 
 +
ex)
 +
ecm_uint32 child_num = sr_get_num_child(sr_vmt);
 +
</pre>
 +
-> 해당 sr에서 child 개수를 반환한다.
 +
 
 +
<pre>
 +
sr_get_idx(sr_t *, index 값)
 +
 
 +
 
 +
ex)
 +
ecm_uint32 i = 0;
 +
sr_t *tmp_sr = sr_get_idx(sr_vmt, i);
 +
</pre>
 +
-> 해당 sr에서 해당 index의 sr을 반환한다. <dir> 밑에 있는 SR 변수들의 인덱스를 뜻함
 +
 
 +
<pre>
 +
sr_get_int(sr_t *)
 +
</pre>
 +
-> 해당 sr에서 int 값을 반환한다. <int>로 선언된 SR만 가능
 +
 
 +
<pre>
 +
sr_get_str(sr_t *)
 +
</pre>
 +
-> 해당 sr에서 str 값을 반환한다. <str>로 선언된 SR만 가능
 +
 
 +
그 외 여러 타입을 지원한다.
 +
 
 +
* 기타 사용법은 [[EBCguide]] 를 참고하면 된다.

2014년 4월 11일 (금) 18:10 판

목차

SR guide 

이 문서는 SR에 대해 설명한다.

General

  • SR : Standard Representation의 약어이다.
  • 기본(Primitive) Type 지원: NULL, INT, LL, DBL, STR, OCT, DIR, PTR, BOOL
  • Aggregation Type: Enum(Bitwise 가능)
  • Extendable Type: 기본 타입을 확장하여 다양한 형 상속 가능하다
  • Complex Type: 트리 형식으로 표현 가능, Link를 통해 그래프도 가능하다

Feature

  • SR 생성, 삭제, 열람, 복사
  • ASR(Argumented SR): SR의 Human-readble 표현형
  • SR Encryption/Decryption

Visualized Structure

  • SR은 사람이 쉽게 읽을 수 있도록 아래와 같은 구조를 보여준다. 
<dir> {
        ebc_port <int>10010;
        services <dir> {
                ebcd <dir> {
                        enabled <bool>true;
                        clname <str>ECMCluster;
                        ndname <str>node;
                        detection_interval <int>0;
                        bdcast_addr <str>"255.255.255.255";
                };
         };
};

SR Type

SR 타입은 위에서 언급된 것과 같이 다양하게 지원된다. 아래는 선언된 SR Type 내용이다. 

#define ST_NULL         0x000000
#define ST_INT          0x010000
#define ST_LL           0x020000
#define ST_DBL          0x030000
#define ST_STR          0x040000
#define ST_OCT          0x050000
#define ST_DIR          0x060000
#define ST_PTR          0x070000
#define ST_BOOL         0x080000

#define ST_APPLYOPT     0x010001
#define ST_LNP          0x060001
#define ST_LNI_TYPE     0x010002
#define ST_SRT          0x010003
#define ST_LNPSTR       0x040001

Create SR

SR을 만들때에는 아래와 같은 함수를 사용한다. libsr.h에서 확인할 수 있다. sr_create 함수를 자주 사용한다. 

sr_t *sr_create(srt_t srt);
sr_t *sr_create_ref(srt_t srt);
sr_t *sr_create_HMS(srt_t srt);
sr_t *sr_create_virtual(srt_t srt);
sr_t *sr_create_vHMS(srt_t srt);

#define sr_create_val(type, val)        sr_set_val(sr_create(type), val)
#define sr_create_int(type, ival)       sr_set_int(sr_create(type), ival)
#define sr_create_ll(type, lval)        sr_set_ll(sr_create(type), lval)
#define sr_create_dbl(type, dval)       sr_set_dbl(sr_create(type), dval)
#define sr_create_str(type, str)        sr_set_str(sr_create(type), str)
#define sr_create_oct(type, size, data) sr_set_oct(sr_create(type), size, data)
#define sr_create_ptr(type, ptr)        sr_set_ptr(sr_create(type), ptr)
#define sr_create_bool(type, bval)      sr_set_bool(sr_create(type), bval)
#define sr_create_dir()                 sr_create(ST_DIR)

/* create child */
#define sr_createc(root, name, type)    sr_setc(root, name, sr_create(type))
#define sr_createc_val(root, name, type, val)   \
        sr_setc(root, name, sr_create_val(type, val))
#define sr_createc_int(root, name, type, ival)  \
        sr_setc(root, name, sr_create_int(type, ival))
#define sr_createc_ll(root, name, type, lval)   \
        sr_setc(root, name, sr_create_ll(type, lval))
#define sr_createc_dbl(root, name, type, dval)  \
        sr_setc(root, name, sr_create_dbl(type, dval))
#define sr_createc_str(root, name, type, str)   \
        sr_setc(root, name, sr_create_str(type, str))
#define sr_createc_oct(root, name, type, size, data)   \
        sr_setc(root, name, sr_create_oct(type, size, data))
#define sr_createc_bool(root, name, type, bval)   \
        sr_setc(root, name, sr_create_bool(type, bval))
#define sr_createc_dir(root, name) \
        sr_setc(root, name, sr_create_dir())
#define sr_createc_bool(root, name, type, bval)  \
        sr_setc(root, name, sr_create_bool(type, bval))
#define sr_createc_ptr(root, name, type, ptr)   \
        sr_setc(root, name, sr_create_ptr(type, ptr))
#define sr_createc_ref(root, name, type, sr_LNP)        \
        sr_set_ref(sr_setc(root, name, sr_create_ref(type)), sr_LNP)
#define sr_createc_HMS(root, name, type)  sr_setc(root, name, sr_create_HMS(type))


/* create indexed child */
#define sr_createi(dir, idx, type) \
                sr_set_child_idx(dir, idx, sr_create(type))
#define sr_createi_val(dir, idx, type, val) \
                sr_set_idx(dir, idx, sr_create_val(type, val))
#define sr_createi_int(dir, idx, type, ival) \
                sr_set_idx(dir, idx, sr_create_int(type, ival))
#define sr_createi_ll(dir, idx, type, lval) \
                sr_set_idx(dir, idx, sr_create_ll(type, lval))
#define sr_createi_dbl(dir, idx, type, dval) \
                sr_set_idx(dir, idx, sr_create_dbl(type, dval))
#define sr_createi_str(dir, idx, type, str) \
                sr_set_idx(dir, idx, sr_create_str(type, str))
#define sr_createi_oct(dir, idx, type, size, data) \
                sr_set_idx(dir, idx, sr_create_oct(type, size, data))
#define sr_createi_dir(dir, idx) \
                sr_set_idx(dir, idx, sr_create_dir())


/* create descendant */
#define sr_createn1(root, LNP, type)    sr_setn1(root, LNP, sr_create(type))
#define sr_createn1_val(root, LNP, type, val)   \
  sr_setn1(root, LNP, sr_create_val(type, val))
#define sr_createn1_int(root, LNP, type, ival)  \
  sr_setn1(root, LNP, sr_create_int(type, ival))
#define sr_createn1_ll(root, LNP, type, lval)   \
  sr_setn1(root, LNP, sr_create_ll(type, lval))
#define sr_createn1_dbl(root, LNP, type, dval)  \
  sr_setn1(root, LNP, sr_create_dbl(type, dval))
#define sr_createn1_str(root, LNP, type, str)   \
  sr_setn1(root, LNP, sr_create_str(type, str))
#define sr_createn1_oct(root, LNP, type, size, data)   \
  sr_setn1(root, LNP, sr_create_oct(type, size, data))
#define sr_createn1_dir(root, LNP)  sr_setn1(root, LNP, sr_create_dir())
#define sr_createn1_bool(root, LNP, type, bval)  \
        sr_setn1(root, LNP, sr_create_bool(type, bval))
#define sr_createn1_ptr(root, LNP, type, ptr)  \
        sr_setn1(root, LNP, sr_create_ptr(type, ptr))
#define sr_createn1_ref(root, LNP, type, target)  \
        sr_set_ref(sr_setn1(root, LNP, sr_create_ref(type)), target)
#define sr_createn1_HMS(root, LNP, type)  sr_setn1(root, LNP, sr_create_HMS(type))

ASR 파일 처리

예를 들어 아래와 같은 ASR 형식의 텍스트 파일이 있다고 가정한다. 

libRvazon <dir> {
	vmt <dir> {
		vmt_1 <dir> {
			vmt_id <int>1;
			vmt_name <str>c3.xlarge;
			vmt_cores <int>4;
			vmt_mem <int>7;
			vmt_hdd <int>80;
			vmt_net_perf <str>Moderate;
			vmt_fee_rank <int>1;	
		};
		vmt_2 <dir> {
			vmt_id <int>2;
			vmt_name <str>c3.2xlarge;
			vmt_cores <int>8;
			vmt_mem <int>15;
			vmt_hdd <int>160;
			vmt_net_perf <str>High;
			vmt_fee_rank <int>2;
		};
	};

	rgn <dir> {
		rgn_1 <dir> {
			rgn_id <int>1;
			rgn_name <str>us-east-1;
			rgn_desc <str>"US East (N. Virginia)";
		};

	};
}

위와 같은 형식일때 sr_t 으로 반환 하는 함수는 아래와 같이 구현가능하다. 

static sr_t *
load_asr(const char *fpath)
{
	sr_t		*sr = NULL;
	int		fd;
	char		*buf;
	ecm_uint64	filesize;
	ecm_size_t	buflen;

	fd = ecm_open(fpath, ECM_O_RDONLY);
	if (fd < 0)
		return NULL;

	if (!ecm_filesize(fd, &filesize)) {
		ecm_close(fd);
		return NULL;
	}

	buflen = (ecm_size_t)filesize;
	buf = (char*)ecm_malloc(buflen + 1);
	if (ecm_read(fd, buf, &buflen)) {
		buf[buflen] = '\0';
		sr = sr_asr_scan(buf);
	}
	ecm_free(buf);
	ecm_close(fd);

	return sr;
}

sr_t의 포인터를 처리하는 함수는 다음과 같다. 

sr_get_child(sr_t *, dir 이름)

ex) 
sr_t *sr_vmt = sr_get_child(sr, "vmt");

-> 해당 sr에서 해당 dir의 child를 반환한다. 


sr_get_num_child(sr_t *)


ex) 
ecm_uint32 child_num = sr_get_num_child(sr_vmt);

-> 해당 sr에서 child 개수를 반환한다. 

sr_get_idx(sr_t *, index 값)


ex) 
ecm_uint32 i = 0;
sr_t *tmp_sr = sr_get_idx(sr_vmt, i);

-> 해당 sr에서 해당 index의 sr을 반환한다. <dir> 밑에 있는 SR 변수들의 인덱스를 뜻함 

sr_get_int(sr_t *)

-> 해당 sr에서 int 값을 반환한다. <int>로 선언된 SR만 가능 

sr_get_str(sr_t *)

-> 해당 sr에서 str 값을 반환한다. <str>로 선언된 SR만 가능

그 외 여러 타입을 지원한다.

  • 기타 사용법은 EBCguide 를 참고하면 된다.
원본 주소 ‘http://123.215.230.149/wiki/index.php?title=SRguide&oldid=1263’
부서별 위키