wayland-scanner 를 통해 Wayland 프로토콜 코드생성

Wayland 패키지는 Wayland 프로토콜 XML 파일에서 C 헤더 및 Glue code를 생성할때 사용되는 실행 바이너리인 wayland-scanner 가 함께 제공된다.

이 도구는 "wayland"패키지의 빌드 프로세스에서 코어 프로토콜인 wayland.xml 에 대한 헤더 및 Glue code를 빌드 시 생성한다. 헤더는 wayland-client-protocol.h 및 wayland-server-protocol.h 가 되지만 일반적으로 직접 사용하는 대신 wayland-client.h 및 wayland-server.h를 포함한다.

이 도구의 사용법은 상당히 간단하다. 클라이언트 헤더를 생성하려면 다음과 같이할 수 있다.

Glue code를 생성하려면 다음을 수행한다.

$ wayland-scanner private-code < ${PROTOCOLNAME}.xml > ${PROTOCOLNAME}-protocol.c

서버 헤더를 생성하려면

$ wayland-scanner server-header < ${PROTOCOLNAME}.xml > ${PROTOCOLNAME}-server-protocol.h

클라이언트 헤더를 생성하려면 다음과 같이 할 수 있다.

$ wayland-scanner client-header < ${PROTOCOLNAME}.xml > ${PROTOCOLNAME}-client-protocol.h

빌드시스템마다 사용자정의 명령구성 방법이 다를 수 있다. 일반적으로 빌드 타임에 wayland-scanner를 실행한 다음 Glue code를 링크하여 응용프로그램을 컴파일 한다.