はじめに

昨年(2018年)末、Macのcpコマンドのオプションが私の職場でも話題となった。
最近のmacOSでは一瞬でファイルがコピーできるという話

それは、APFS (Apple File System)において、cpコマンドで-cオプションを指定すると、
clonefileシステムコールを使ってくれるので、数GB級のファイルも一瞬でコピーを行うことができるというものだ。

そして、私はclonefileコールを使ってファイルコピーをするGolangのツールを書きたくなった。

特に経緯とか良い人はソースを直接どうぞ → https://github.com/n-someya/goclonefile

Golangにおけるシステムコール発行パッケージ

Golangにおける、システムコール発行のパッケージは歴史的経緯から2つ存在する。
syscallパッケージは、Golangの標準パッケージでシステムコールを発行するための機能を提供している。
しかし、OSごとに異なる固有仕様のサポートなど一連の問題¹ により、現在はsyscallパッケージではなく、
golang.org/x/sysパッケージに、機能追加がされている。

clonefileシステムコールはmacOSの固有機能のため、golang.org/x/sys/unixパッケージをみた方が良い。(macOSはUnixベース)

Unixの場合、システムコールにはそれぞれ番号が割り当たっている。
どのシステムコールにどの番号が振られているかを定数定義しているファイルが、
zsysnum_darwin_amd64.go
である。

const (
//中略
	SYS_CLONEFILEAT                    = 462
//中略
)

その中にclonefileのシステムコール番号も記載されている。
これは期待できそうだ。

上記の定数を利用して、実際にシステムコールを発行しているのが、
zsyscall_darwin_amd64.1_11.go
このファイルだ。

しかし、どこを見てもSYS_CLONEFILEATを使っている箇所がない。。。
実装されていないようだ。。。

Golangによるclonefileシステムコールの発行処理実装

しょうがないので、自分で実装するしかない。

Appleによるとclonefileシステムコール（正確にはclonefileatシステムコール）は、5つの引数を受け付ける。

引数	パラメータ
1	第2引数が相対パスの場合のカレントディレクトリのディスクリプタ
2	コピー元ファイルのパス
3	第4引数が相対パスの場合のカレントディレクトリのディスクリプタ
4	コピー先ファイルのパス
5	フラグ（現状は、NOFOLLOW: シンボリックリンクのリンク元までは追わないのみ？)

一方、unixパッケージのシステムコール発行関数は、引数3つのSyscall()、引数6つのSyscall6()
、引数9つのSyscall9()の3つあるので、第6引数を0として、Syscall6を呼び出すのが良さそうだ。

最終的には以下のようなコードとなった。

var (
	// Flags
	CLONE_NOFOLLOW    CLONEFILE_FLAG = 0x0001 /* Don't follow symbolic links */
	CLONE_NOOWNERCOPY CLONEFILE_FLAG = 0x0002 /* Don't copy ownership information from source */
	AT_FDCWD                         = -2
)

// Clonefile clonefile is fast copy method for darwin(MacOS)
func Clonefile(src, dst string) (err error) {
	if runtime.GOOS != OS_DARWIN {
		return fmt.Errorf("Clonefile is implemented for macOS")
	}
	var _p0, _p1 *byte
	_p0, err = unix.BytePtrFromString(src)
	if err != nil {
		return
	}
	_p1, err = unix.BytePtrFromString(dst)
	if err != nil {
		return
	}
	_, _, e1 := unix.Syscall6(unix.SYS_CLONEFILEAT, uintptr(AT_FDCWD), uintptr(unsafe.Pointer(_p0)), uintptr(AT_FDCWD), uintptr(unsafe.Pointer(_p1)), uintptr(CLONE_NOFOLLOW), 0)
	if e1 != 0 {
		err = errnoErr(e1)
	}
	return
}

色々な補足

【補足１】

go1.12からはmacOSに関しては、システムコール発行の実装が変更となっているようだ。
システムコール関数は、syscall_syscall6などの小文字＋アンダーバーの関数となっており、、システムコール番号もlibcから取得する方法となっている。
https://github.com/golang/sys/blob/9fbf701fc3/unix/zsyscall_darwin_arm64.go
（なんでだろう）

【補足２】

直接システムコールを呼ぶのではなく、
https://github.com/go-darwin/apfs/blob/master/clone.go
こちらの方のように、C言語の関数を直接呼ぶ方が作法としては良いのかもしれない。

Go Binary Hacks - syscallとgolang.org/x/sys/ #golang, やgoogleのドキュメントに詳しい話が掲載されている ↩