Skip to content

move_mount

Implemented in Antinomie 0.7.0 · Syscall list

long move_mount(int from_dfd, const char *from_path, int to_dfd, const char *to_path, unsigned int ms_flags);
Number (x86-64) 429
ABI common
Kernel entry point sys_move_mount

This is the raw kernel prototype from the pinned Linux 6.12.94 schema, not the libc wrapper.

Moves or attaches a mount, identified by a descriptor or path, to a place in the mount tree.

Name Type Meaning
from_dfd (arg0) int Directory descriptor for the source path.
from_path (arg1) const char * Source path.
to_dfd (arg2) int Directory descriptor for the destination path.
to_path (arg3) const char * Destination path.
ms_flags (arg4) unsigned int msync flags: MS_ASYNC, MS_SYNC, MS_INVALIDATE.

On success: 0.

In an Antinomie trace the Return column and the ret filter field show the raw kernel return value. On failure that is the negative errno, for example -2 for ENOENT, not the -1 plus errno that the libc wrapper gives. syscall.errno holds the positive errno and syscall.success is false.

Raw return Name Meaning
-22 EINVAL An argument is invalid.
-1 EPERM The operation is not permitted for this process.

move_mount(2) on man7.org

Coverage mark: Implemented. Every pointer argument has a capture rule in the pinned kernel patch and none of them records a “no decoder”, “address only” or “not observed” gap on any code path. Individual values can still be incomplete on a particular call; see the capture statuses.

Every call is recorded as an Entry record (the six argument words and the pointees copied at entry) and an Exit record (the return value and the pointees copied at exit).

Argument When How Recorded field key Condition
from_dfd (arg0) Entry raw scalar word args.0, args.from_dfd
from_path (arg1) Entry the pointer itself, as a raw word args.1, args.raw[1]
↳ pointee Entry NUL-terminated string, up to 4,096 bytes (PATH_MAX) arg1.path always
to_dfd (arg2) Entry raw scalar word args.2, args.to_dfd
to_path (arg3) Entry the pointer itself, as a raw word args.3, args.raw[3]
↳ pointee Entry NUL-terminated string, up to 4,096 bytes (PATH_MAX) arg3.path always
ms_flags (arg4) Entry raw scalar word; Syscall Trace also decodes it into flag names (move_mount group), listing unknown bits separately args.4, args.ms_flags
  • Result: ret, syscall.errno, syscall.success, syscall.duration_ns.
  • Argument words: args.from_dfd (arg0), args.from_path (arg1), args.to_dfd (arg2), args.to_path (arg3), args.ms_flags (arg4); args.0 to args.5 by position.
  • Captured strings: the args.<name> field of a path argument, and args.path, give the captured text instead of the pointer.

See Syscall Trace filter for the full syntax.

For what the capture statuses mean, see Capture statuses. For what is never recorded, see Known gaps.