VirtualFileSystem.cpp 36 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034
  1. /*
  2. * Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/GenericLexer.h>
  7. #include <AK/Singleton.h>
  8. #include <AK/StringBuilder.h>
  9. #include <Kernel/Debug.h>
  10. #include <Kernel/Devices/BlockDevice.h>
  11. #include <Kernel/FileSystem/Custody.h>
  12. #include <Kernel/FileSystem/FileBackedFileSystem.h>
  13. #include <Kernel/FileSystem/FileDescription.h>
  14. #include <Kernel/FileSystem/FileSystem.h>
  15. #include <Kernel/FileSystem/VirtualFileSystem.h>
  16. #include <Kernel/KLexicalPath.h>
  17. #include <Kernel/KSyms.h>
  18. #include <Kernel/Process.h>
  19. #include <Kernel/Sections.h>
  20. #include <LibC/errno_numbers.h>
  21. namespace Kernel {
  22. static Singleton<VirtualFileSystem> s_the;
  23. static constexpr int symlink_recursion_limit { 5 }; // FIXME: increase?
  24. static constexpr int root_mount_flags = MS_NODEV | MS_NOSUID | MS_RDONLY;
  25. UNMAP_AFTER_INIT void VirtualFileSystem::initialize()
  26. {
  27. s_the.ensure_instance();
  28. }
  29. VirtualFileSystem& VirtualFileSystem::the()
  30. {
  31. return *s_the;
  32. }
  33. UNMAP_AFTER_INIT VirtualFileSystem::VirtualFileSystem()
  34. {
  35. }
  36. UNMAP_AFTER_INIT VirtualFileSystem::~VirtualFileSystem()
  37. {
  38. }
  39. InodeIdentifier VirtualFileSystem::root_inode_id() const
  40. {
  41. VERIFY(m_root_inode);
  42. return m_root_inode->identifier();
  43. }
  44. KResult VirtualFileSystem::mount(FileSystem& fs, Custody& mount_point, int flags)
  45. {
  46. return m_mounts.with_exclusive([&](auto& mounts) -> KResult {
  47. auto& inode = mount_point.inode();
  48. dbgln("VirtualFileSystem: Mounting {} at {} (inode: {}) with flags {}",
  49. fs.class_name(),
  50. mount_point.try_create_absolute_path(),
  51. inode.identifier(),
  52. flags);
  53. // FIXME: check that this is not already a mount point
  54. Mount mount { fs, &mount_point, flags };
  55. mounts.append(move(mount));
  56. return KSuccess;
  57. });
  58. }
  59. KResult VirtualFileSystem::bind_mount(Custody& source, Custody& mount_point, int flags)
  60. {
  61. return m_mounts.with_exclusive([&](auto& mounts) -> KResult {
  62. dbgln("VirtualFileSystem: Bind-mounting {} at {}", source.try_create_absolute_path(), mount_point.try_create_absolute_path());
  63. // FIXME: check that this is not already a mount point
  64. Mount mount { source.inode(), mount_point, flags };
  65. mounts.append(move(mount));
  66. return KSuccess;
  67. });
  68. }
  69. KResult VirtualFileSystem::remount(Custody& mount_point, int new_flags)
  70. {
  71. dbgln("VirtualFileSystem: Remounting {}", mount_point.try_create_absolute_path());
  72. auto* mount = find_mount_for_guest(mount_point.inode().identifier());
  73. if (!mount)
  74. return ENODEV;
  75. mount->set_flags(new_flags);
  76. return KSuccess;
  77. }
  78. KResult VirtualFileSystem::unmount(Inode& guest_inode)
  79. {
  80. dbgln("VirtualFileSystem: unmount called with inode {}", guest_inode.identifier());
  81. return m_mounts.with_exclusive([&](auto& mounts) -> KResult {
  82. for (size_t i = 0; i < mounts.size(); ++i) {
  83. auto& mount = mounts[i];
  84. if (&mount.guest() != &guest_inode)
  85. continue;
  86. if (auto result = mount.guest_fs().prepare_to_unmount(); result.is_error()) {
  87. dbgln("VirtualFileSystem: Failed to unmount!");
  88. return result;
  89. }
  90. dbgln("VirtualFileSystem: Unmounting file system {}...", mount.guest_fs().fsid());
  91. mounts.unstable_take(i);
  92. return KSuccess;
  93. }
  94. dbgln("VirtualFileSystem: Nothing mounted on inode {}", guest_inode.identifier());
  95. return ENODEV;
  96. });
  97. }
  98. bool VirtualFileSystem::mount_root(FileSystem& fs)
  99. {
  100. if (m_root_inode) {
  101. dmesgln("VirtualFileSystem: mount_root can't mount another root");
  102. return false;
  103. }
  104. Mount mount { fs, nullptr, root_mount_flags };
  105. auto& root_inode = fs.root_inode();
  106. if (!root_inode.is_directory()) {
  107. dmesgln("VirtualFileSystem: root inode ({}) for / is not a directory :(", root_inode.identifier());
  108. return false;
  109. }
  110. m_root_inode = root_inode;
  111. dmesgln("VirtualFileSystem: mounted root from {} ({})", fs.class_name(), static_cast<FileBackedFileSystem&>(fs).file_description().absolute_path());
  112. m_mounts.with_exclusive([&](auto& mounts) {
  113. mounts.append(move(mount));
  114. });
  115. auto custody_or_error = Custody::try_create(nullptr, "", *m_root_inode, root_mount_flags);
  116. if (custody_or_error.is_error())
  117. return false;
  118. m_root_custody = custody_or_error.release_value();
  119. return true;
  120. }
  121. auto VirtualFileSystem::find_mount_for_host(InodeIdentifier id) -> Mount*
  122. {
  123. return m_mounts.with_exclusive([&](auto& mounts) -> Mount* {
  124. for (auto& mount : mounts) {
  125. if (mount.host() && mount.host()->identifier() == id)
  126. return &mount;
  127. }
  128. return nullptr;
  129. });
  130. }
  131. auto VirtualFileSystem::find_mount_for_guest(InodeIdentifier id) -> Mount*
  132. {
  133. return m_mounts.with_exclusive([&](auto& mounts) -> Mount* {
  134. for (auto& mount : mounts) {
  135. if (mount.guest().identifier() == id)
  136. return &mount;
  137. }
  138. return nullptr;
  139. });
  140. }
  141. bool VirtualFileSystem::is_vfs_root(InodeIdentifier inode) const
  142. {
  143. return inode == root_inode_id();
  144. }
  145. KResult VirtualFileSystem::traverse_directory_inode(Inode& dir_inode, Function<bool(FileSystem::DirectoryEntryView const&)> callback)
  146. {
  147. return dir_inode.traverse_as_directory([&](auto& entry) {
  148. InodeIdentifier resolved_inode;
  149. if (auto mount = find_mount_for_host(entry.inode))
  150. resolved_inode = mount->guest().identifier();
  151. else
  152. resolved_inode = entry.inode;
  153. // FIXME: This is now broken considering chroot and bind mounts.
  154. bool is_root_inode = dir_inode.identifier() == dir_inode.fs().root_inode().identifier();
  155. if (is_root_inode && !is_vfs_root(dir_inode.identifier()) && entry.name == "..") {
  156. auto mount = find_mount_for_guest(dir_inode.identifier());
  157. VERIFY(mount);
  158. VERIFY(mount->host());
  159. resolved_inode = mount->host()->identifier();
  160. }
  161. callback({ entry.name, resolved_inode, entry.file_type });
  162. return true;
  163. });
  164. }
  165. KResult VirtualFileSystem::utime(StringView path, Custody& base, time_t atime, time_t mtime)
  166. {
  167. auto custody_or_error = VirtualFileSystem::the().resolve_path(move(path), base);
  168. if (custody_or_error.is_error())
  169. return custody_or_error.error();
  170. auto& custody = *custody_or_error.value();
  171. auto& inode = custody.inode();
  172. auto current_process = Process::current();
  173. if (!current_process->is_superuser() && inode.metadata().uid != current_process->euid())
  174. return EACCES;
  175. if (custody.is_readonly())
  176. return EROFS;
  177. if (auto result = inode.set_atime(atime); result.is_error())
  178. return result;
  179. if (auto result = inode.set_mtime(mtime); result.is_error())
  180. return result;
  181. return KSuccess;
  182. }
  183. KResultOr<InodeMetadata> VirtualFileSystem::lookup_metadata(StringView path, Custody& base, int options)
  184. {
  185. auto custody_or_error = resolve_path(path, base, nullptr, options);
  186. if (custody_or_error.is_error())
  187. return custody_or_error.error();
  188. return custody_or_error.value()->inode().metadata();
  189. }
  190. KResultOr<NonnullRefPtr<FileDescription>> VirtualFileSystem::open(StringView path, int options, mode_t mode, Custody& base, Optional<UidAndGid> owner)
  191. {
  192. if ((options & O_CREAT) && (options & O_DIRECTORY))
  193. return EINVAL;
  194. RefPtr<Custody> parent_custody;
  195. auto custody_or_error = resolve_path(path, base, &parent_custody, options);
  196. if (custody_or_error.is_error()) {
  197. // NOTE: ENOENT with a non-null parent custody signals us that the immediate parent
  198. // of the file exists, but the file itself does not.
  199. if ((options & O_CREAT) && custody_or_error.error() == ENOENT && parent_custody)
  200. return create(path, options, mode, *parent_custody, move(owner));
  201. return custody_or_error.error();
  202. }
  203. if ((options & O_CREAT) && (options & O_EXCL))
  204. return EEXIST;
  205. auto& custody = *custody_or_error.value();
  206. auto& inode = custody.inode();
  207. auto metadata = inode.metadata();
  208. if ((options & O_DIRECTORY) && !metadata.is_directory())
  209. return ENOTDIR;
  210. bool should_truncate_file = false;
  211. auto current_process = Process::current();
  212. if ((options & O_RDONLY) && !metadata.may_read(*current_process))
  213. return EACCES;
  214. if (options & O_WRONLY) {
  215. if (!metadata.may_write(*current_process))
  216. return EACCES;
  217. if (metadata.is_directory())
  218. return EISDIR;
  219. should_truncate_file = options & O_TRUNC;
  220. }
  221. if (options & O_EXEC) {
  222. if (!metadata.may_execute(*current_process) || (custody.mount_flags() & MS_NOEXEC))
  223. return EACCES;
  224. }
  225. if (auto preopen_fd = inode.preopen_fd())
  226. return *preopen_fd;
  227. if (metadata.is_fifo()) {
  228. auto fifo = inode.fifo();
  229. if (options & O_WRONLY) {
  230. auto open_result = fifo->open_direction_blocking(FIFO::Direction::Writer);
  231. if (open_result.is_error())
  232. return open_result.error();
  233. auto& description = open_result.value();
  234. description->set_rw_mode(options);
  235. description->set_file_flags(options);
  236. description->set_original_inode({}, inode);
  237. return description;
  238. } else if (options & O_RDONLY) {
  239. auto open_result = fifo->open_direction_blocking(FIFO::Direction::Reader);
  240. if (open_result.is_error())
  241. return open_result.error();
  242. auto& description = open_result.value();
  243. description->set_rw_mode(options);
  244. description->set_file_flags(options);
  245. description->set_original_inode({}, inode);
  246. return description;
  247. }
  248. return EINVAL;
  249. }
  250. if (metadata.is_device()) {
  251. if (custody.mount_flags() & MS_NODEV)
  252. return EACCES;
  253. auto device = Device::get_device(metadata.major_device, metadata.minor_device);
  254. if (device == nullptr) {
  255. return ENODEV;
  256. }
  257. auto descriptor_or_error = device->open(options);
  258. if (descriptor_or_error.is_error())
  259. return descriptor_or_error.error();
  260. descriptor_or_error.value()->set_original_inode({}, inode);
  261. return descriptor_or_error;
  262. }
  263. // Check for read-only FS. Do this after handling preopen FD and devices,
  264. // but before modifying the inode in any way.
  265. if ((options & O_WRONLY) && custody.is_readonly())
  266. return EROFS;
  267. if (should_truncate_file) {
  268. if (auto result = inode.truncate(0); result.is_error())
  269. return result;
  270. if (auto result = inode.set_mtime(kgettimeofday().to_truncated_seconds()); result.is_error())
  271. return result;
  272. }
  273. auto description = FileDescription::create(custody);
  274. if (!description.is_error()) {
  275. description.value()->set_rw_mode(options);
  276. description.value()->set_file_flags(options);
  277. }
  278. return description;
  279. }
  280. KResult VirtualFileSystem::mknod(StringView path, mode_t mode, dev_t dev, Custody& base)
  281. {
  282. if (!is_regular_file(mode) && !is_block_device(mode) && !is_character_device(mode) && !is_fifo(mode) && !is_socket(mode))
  283. return EINVAL;
  284. RefPtr<Custody> parent_custody;
  285. auto existing_file_or_error = resolve_path(path, base, &parent_custody);
  286. if (!existing_file_or_error.is_error())
  287. return EEXIST;
  288. if (!parent_custody)
  289. return ENOENT;
  290. if (existing_file_or_error.error() != ENOENT)
  291. return existing_file_or_error.error();
  292. auto& parent_inode = parent_custody->inode();
  293. auto current_process = Process::current();
  294. if (!parent_inode.metadata().may_write(*current_process))
  295. return EACCES;
  296. if (parent_custody->is_readonly())
  297. return EROFS;
  298. auto basename = KLexicalPath::basename(path);
  299. dbgln("VirtualFileSystem::mknod: '{}' mode={} dev={} in {}", basename, mode, dev, parent_inode.identifier());
  300. return parent_inode.create_child(basename, mode, dev, current_process->euid(), current_process->egid()).result();
  301. }
  302. KResultOr<NonnullRefPtr<FileDescription>> VirtualFileSystem::create(StringView path, int options, mode_t mode, Custody& parent_custody, Optional<UidAndGid> owner)
  303. {
  304. auto basename = KLexicalPath::basename(path);
  305. auto parent_path = parent_custody.try_create_absolute_path();
  306. if (!parent_path)
  307. return ENOMEM;
  308. auto full_path = KLexicalPath::try_join(parent_path->view(), basename);
  309. if (!full_path)
  310. return ENOMEM;
  311. if (auto result = validate_path_against_process_veil(full_path->view(), options); result.is_error())
  312. return result;
  313. if (!is_socket(mode) && !is_fifo(mode) && !is_block_device(mode) && !is_character_device(mode)) {
  314. // Turn it into a regular file. (This feels rather hackish.)
  315. mode |= 0100000;
  316. }
  317. auto& parent_inode = parent_custody.inode();
  318. auto current_process = Process::current();
  319. if (!parent_inode.metadata().may_write(*current_process))
  320. return EACCES;
  321. if (parent_custody.is_readonly())
  322. return EROFS;
  323. dbgln_if(VFS_DEBUG, "VirtualFileSystem::create: '{}' in {}", basename, parent_inode.identifier());
  324. uid_t uid = owner.has_value() ? owner.value().uid : current_process->euid();
  325. gid_t gid = owner.has_value() ? owner.value().gid : current_process->egid();
  326. auto inode_or_error = parent_inode.create_child(basename, mode, 0, uid, gid);
  327. if (inode_or_error.is_error())
  328. return inode_or_error.error();
  329. auto new_custody_or_error = Custody::try_create(&parent_custody, basename, inode_or_error.value(), parent_custody.mount_flags());
  330. if (new_custody_or_error.is_error())
  331. return new_custody_or_error.error();
  332. auto description = FileDescription::create(*new_custody_or_error.release_value());
  333. if (!description.is_error()) {
  334. description.value()->set_rw_mode(options);
  335. description.value()->set_file_flags(options);
  336. }
  337. return description;
  338. }
  339. KResult VirtualFileSystem::mkdir(StringView path, mode_t mode, Custody& base)
  340. {
  341. // Unlike in basically every other case, where it's only the last
  342. // path component (the one being created) that is allowed not to
  343. // exist, POSIX allows mkdir'ed path to have trailing slashes.
  344. // Let's handle that case by trimming any trailing slashes.
  345. path = path.trim("/"sv, TrimMode::Right);
  346. if (path.is_empty()) {
  347. // NOTE: This means the path was a series of slashes, which resolves to "/".
  348. path = "/";
  349. }
  350. RefPtr<Custody> parent_custody;
  351. auto result = resolve_path(path, base, &parent_custody);
  352. if (!result.is_error())
  353. return EEXIST;
  354. else if (!parent_custody)
  355. return result.error();
  356. // NOTE: If resolve_path fails with a non-null parent custody, the error should be ENOENT.
  357. VERIFY(result.error() == ENOENT);
  358. auto& parent_inode = parent_custody->inode();
  359. auto current_process = Process::current();
  360. if (!parent_inode.metadata().may_write(*current_process))
  361. return EACCES;
  362. if (parent_custody->is_readonly())
  363. return EROFS;
  364. auto basename = KLexicalPath::basename(path);
  365. dbgln_if(VFS_DEBUG, "VirtualFileSystem::mkdir: '{}' in {}", basename, parent_inode.identifier());
  366. return parent_inode.create_child(basename, S_IFDIR | mode, 0, current_process->euid(), current_process->egid()).result();
  367. }
  368. KResult VirtualFileSystem::access(StringView path, int mode, Custody& base)
  369. {
  370. auto custody_or_error = resolve_path(path, base);
  371. if (custody_or_error.is_error())
  372. return custody_or_error.error();
  373. auto& custody = *custody_or_error.value();
  374. auto& inode = custody.inode();
  375. auto metadata = inode.metadata();
  376. auto current_process = Process::current();
  377. if (mode & R_OK) {
  378. if (!metadata.may_read(*current_process))
  379. return EACCES;
  380. }
  381. if (mode & W_OK) {
  382. if (!metadata.may_write(*current_process))
  383. return EACCES;
  384. if (custody.is_readonly())
  385. return EROFS;
  386. }
  387. if (mode & X_OK) {
  388. if (!metadata.may_execute(*current_process))
  389. return EACCES;
  390. }
  391. return KSuccess;
  392. }
  393. KResultOr<NonnullRefPtr<Custody>> VirtualFileSystem::open_directory(StringView path, Custody& base)
  394. {
  395. auto inode_or_error = resolve_path(path, base);
  396. if (inode_or_error.is_error())
  397. return inode_or_error.error();
  398. auto& custody = *inode_or_error.value();
  399. auto& inode = custody.inode();
  400. if (!inode.is_directory())
  401. return ENOTDIR;
  402. if (!inode.metadata().may_execute(*Process::current()))
  403. return EACCES;
  404. return custody;
  405. }
  406. KResult VirtualFileSystem::chmod(Custody& custody, mode_t mode)
  407. {
  408. auto& inode = custody.inode();
  409. auto current_process = Process::current();
  410. if (current_process->euid() != inode.metadata().uid && !current_process->is_superuser())
  411. return EPERM;
  412. if (custody.is_readonly())
  413. return EROFS;
  414. // Only change the permission bits.
  415. mode = (inode.mode() & ~07777u) | (mode & 07777u);
  416. return inode.chmod(mode);
  417. }
  418. KResult VirtualFileSystem::chmod(StringView path, mode_t mode, Custody& base)
  419. {
  420. auto custody_or_error = resolve_path(path, base);
  421. if (custody_or_error.is_error())
  422. return custody_or_error.error();
  423. auto& custody = *custody_or_error.value();
  424. return chmod(custody, mode);
  425. }
  426. KResult VirtualFileSystem::rename(StringView old_path, StringView new_path, Custody& base)
  427. {
  428. RefPtr<Custody> old_parent_custody;
  429. auto old_custody_or_error = resolve_path(old_path, base, &old_parent_custody, O_NOFOLLOW_NOERROR);
  430. if (old_custody_or_error.is_error())
  431. return old_custody_or_error.error();
  432. auto& old_custody = *old_custody_or_error.value();
  433. auto& old_inode = old_custody.inode();
  434. RefPtr<Custody> new_parent_custody;
  435. auto new_custody_or_error = resolve_path(new_path, base, &new_parent_custody);
  436. if (new_custody_or_error.is_error()) {
  437. if (new_custody_or_error.error() != ENOENT || !new_parent_custody)
  438. return new_custody_or_error.error();
  439. }
  440. if (!old_parent_custody || !new_parent_custody) {
  441. return EPERM;
  442. }
  443. if (!new_custody_or_error.is_error()) {
  444. auto& new_inode = new_custody_or_error.value()->inode();
  445. if (old_inode.index() != new_inode.index() && old_inode.is_directory() && new_inode.is_directory()) {
  446. size_t child_count = 0;
  447. auto traversal_result = new_inode.traverse_as_directory([&child_count](auto&) {
  448. ++child_count;
  449. return child_count <= 2;
  450. });
  451. if (traversal_result.is_error())
  452. return traversal_result;
  453. if (child_count > 2)
  454. return ENOTEMPTY;
  455. }
  456. }
  457. auto& old_parent_inode = old_parent_custody->inode();
  458. auto& new_parent_inode = new_parent_custody->inode();
  459. if (&old_parent_inode.fs() != &new_parent_inode.fs())
  460. return EXDEV;
  461. for (auto* new_ancestor = new_parent_custody.ptr(); new_ancestor; new_ancestor = new_ancestor->parent()) {
  462. if (&old_inode == &new_ancestor->inode())
  463. return EDIRINTOSELF;
  464. }
  465. auto current_process = Process::current();
  466. if (!new_parent_inode.metadata().may_write(*current_process))
  467. return EACCES;
  468. if (!old_parent_inode.metadata().may_write(*current_process))
  469. return EACCES;
  470. if (old_parent_inode.metadata().is_sticky()) {
  471. if (!current_process->is_superuser() && old_inode.metadata().uid != current_process->euid())
  472. return EACCES;
  473. }
  474. if (old_parent_custody->is_readonly() || new_parent_custody->is_readonly())
  475. return EROFS;
  476. auto old_basename = KLexicalPath::basename(old_path);
  477. if (old_basename.is_empty() || old_basename == "."sv || old_basename == ".."sv)
  478. return EINVAL;
  479. auto new_basename = KLexicalPath::basename(new_path);
  480. if (new_basename.is_empty() || new_basename == "."sv || new_basename == ".."sv)
  481. return EINVAL;
  482. if (old_basename == new_basename && old_parent_inode.index() == new_parent_inode.index())
  483. return KSuccess;
  484. if (!new_custody_or_error.is_error()) {
  485. auto& new_custody = *new_custody_or_error.value();
  486. auto& new_inode = new_custody.inode();
  487. // FIXME: Is this really correct? Check what other systems do.
  488. if (&new_inode == &old_inode)
  489. return KSuccess;
  490. if (new_parent_inode.metadata().is_sticky()) {
  491. if (!current_process->is_superuser() && new_inode.metadata().uid != current_process->euid())
  492. return EACCES;
  493. }
  494. if (new_inode.is_directory() && !old_inode.is_directory())
  495. return EISDIR;
  496. if (auto result = new_parent_inode.remove_child(new_basename); result.is_error())
  497. return result;
  498. }
  499. if (auto result = new_parent_inode.add_child(old_inode, new_basename, old_inode.mode()); result.is_error())
  500. return result;
  501. if (auto result = old_parent_inode.remove_child(old_basename); result.is_error())
  502. return result;
  503. return KSuccess;
  504. }
  505. KResult VirtualFileSystem::chown(Custody& custody, uid_t a_uid, gid_t a_gid)
  506. {
  507. auto& inode = custody.inode();
  508. auto metadata = inode.metadata();
  509. auto current_process = Process::current();
  510. if (current_process->euid() != metadata.uid && !current_process->is_superuser())
  511. return EPERM;
  512. uid_t new_uid = metadata.uid;
  513. gid_t new_gid = metadata.gid;
  514. if (a_uid != (uid_t)-1) {
  515. if (current_process->euid() != a_uid && !current_process->is_superuser())
  516. return EPERM;
  517. new_uid = a_uid;
  518. }
  519. if (a_gid != (gid_t)-1) {
  520. if (!current_process->in_group(a_gid) && !current_process->is_superuser())
  521. return EPERM;
  522. new_gid = a_gid;
  523. }
  524. if (custody.is_readonly())
  525. return EROFS;
  526. dbgln_if(VFS_DEBUG, "VirtualFileSystem::chown(): inode {} <- uid={} gid={}", inode.identifier(), new_uid, new_gid);
  527. if (metadata.is_setuid() || metadata.is_setgid()) {
  528. dbgln_if(VFS_DEBUG, "VirtualFileSystem::chown(): Stripping SUID/SGID bits from {}", inode.identifier());
  529. if (auto result = inode.chmod(metadata.mode & ~(04000 | 02000)); result.is_error())
  530. return result;
  531. }
  532. return inode.chown(new_uid, new_gid);
  533. }
  534. KResult VirtualFileSystem::chown(StringView path, uid_t a_uid, gid_t a_gid, Custody& base)
  535. {
  536. auto custody_or_error = resolve_path(path, base);
  537. if (custody_or_error.is_error())
  538. return custody_or_error.error();
  539. auto& custody = *custody_or_error.value();
  540. return chown(custody, a_uid, a_gid);
  541. }
  542. static bool hard_link_allowed(const Inode& inode)
  543. {
  544. auto metadata = inode.metadata();
  545. if (Process::current()->euid() == metadata.uid)
  546. return true;
  547. if (metadata.is_regular_file()
  548. && !metadata.is_setuid()
  549. && !(metadata.is_setgid() && metadata.mode & S_IXGRP)
  550. && metadata.may_write(*Process::current())) {
  551. return true;
  552. }
  553. return false;
  554. }
  555. KResult VirtualFileSystem::link(StringView old_path, StringView new_path, Custody& base)
  556. {
  557. auto old_custody_or_error = resolve_path(old_path, base);
  558. if (old_custody_or_error.is_error())
  559. return old_custody_or_error.error();
  560. auto& old_custody = *old_custody_or_error.value();
  561. auto& old_inode = old_custody.inode();
  562. RefPtr<Custody> parent_custody;
  563. auto new_custody_or_error = resolve_path(new_path, base, &parent_custody);
  564. if (!new_custody_or_error.is_error())
  565. return EEXIST;
  566. if (!parent_custody)
  567. return ENOENT;
  568. auto& parent_inode = parent_custody->inode();
  569. if (parent_inode.fsid() != old_inode.fsid())
  570. return EXDEV;
  571. if (!parent_inode.metadata().may_write(*Process::current()))
  572. return EACCES;
  573. if (old_inode.is_directory())
  574. return EPERM;
  575. if (parent_custody->is_readonly())
  576. return EROFS;
  577. if (!hard_link_allowed(old_inode))
  578. return EPERM;
  579. return parent_inode.add_child(old_inode, KLexicalPath::basename(new_path), old_inode.mode());
  580. }
  581. KResult VirtualFileSystem::unlink(StringView path, Custody& base)
  582. {
  583. RefPtr<Custody> parent_custody;
  584. auto custody_or_error = resolve_path(path, base, &parent_custody, O_NOFOLLOW_NOERROR | O_UNLINK_INTERNAL);
  585. if (custody_or_error.is_error())
  586. return custody_or_error.error();
  587. auto& custody = *custody_or_error.value();
  588. auto& inode = custody.inode();
  589. if (inode.is_directory())
  590. return EISDIR;
  591. // We have just checked that the inode is not a directory, and thus it's not
  592. // the root. So it should have a parent. Note that this would be invalidated
  593. // if we were to support bind-mounting regular files on top of the root.
  594. VERIFY(parent_custody);
  595. auto& parent_inode = parent_custody->inode();
  596. auto current_process = Process::current();
  597. if (!parent_inode.metadata().may_write(*current_process))
  598. return EACCES;
  599. if (parent_inode.metadata().is_sticky()) {
  600. if (!current_process->is_superuser() && inode.metadata().uid != current_process->euid())
  601. return EACCES;
  602. }
  603. if (parent_custody->is_readonly())
  604. return EROFS;
  605. if (auto result = parent_inode.remove_child(KLexicalPath::basename(path)); result.is_error())
  606. return result;
  607. return KSuccess;
  608. }
  609. KResult VirtualFileSystem::symlink(StringView target, StringView linkpath, Custody& base)
  610. {
  611. RefPtr<Custody> parent_custody;
  612. auto existing_custody_or_error = resolve_path(linkpath, base, &parent_custody);
  613. if (!existing_custody_or_error.is_error())
  614. return EEXIST;
  615. if (!parent_custody)
  616. return ENOENT;
  617. if (existing_custody_or_error.is_error() && existing_custody_or_error.error() != ENOENT)
  618. return existing_custody_or_error.error();
  619. auto& parent_inode = parent_custody->inode();
  620. auto current_process = Process::current();
  621. if (!parent_inode.metadata().may_write(*current_process))
  622. return EACCES;
  623. if (parent_custody->is_readonly())
  624. return EROFS;
  625. auto basename = KLexicalPath::basename(linkpath);
  626. dbgln_if(VFS_DEBUG, "VirtualFileSystem::symlink: '{}' (-> '{}') in {}", basename, target, parent_inode.identifier());
  627. auto inode_or_error = parent_inode.create_child(basename, S_IFLNK | 0644, 0, current_process->euid(), current_process->egid());
  628. if (inode_or_error.is_error())
  629. return inode_or_error.error();
  630. auto& inode = inode_or_error.value();
  631. auto target_buffer = UserOrKernelBuffer::for_kernel_buffer(const_cast<u8*>((const u8*)target.characters_without_null_termination()));
  632. auto result = inode->write_bytes(0, target.length(), target_buffer, nullptr);
  633. if (result.is_error())
  634. return result.error();
  635. return KSuccess;
  636. }
  637. KResult VirtualFileSystem::rmdir(StringView path, Custody& base)
  638. {
  639. RefPtr<Custody> parent_custody;
  640. auto custody_or_error = resolve_path(path, base, &parent_custody);
  641. if (custody_or_error.is_error())
  642. return KResult(custody_or_error.error());
  643. auto& custody = *custody_or_error.value();
  644. auto& inode = custody.inode();
  645. // FIXME: We should return EINVAL if the last component of the path is "."
  646. // FIXME: We should return ENOTEMPTY if the last component of the path is ".."
  647. if (!inode.is_directory())
  648. return ENOTDIR;
  649. if (!parent_custody)
  650. return EBUSY;
  651. auto& parent_inode = parent_custody->inode();
  652. auto parent_metadata = parent_inode.metadata();
  653. if (!parent_metadata.may_write(*Process::current()))
  654. return EACCES;
  655. if (parent_metadata.is_sticky()) {
  656. if (!Process::current()->is_superuser() && inode.metadata().uid != Process::current()->euid())
  657. return EACCES;
  658. }
  659. size_t child_count = 0;
  660. auto traversal_result = inode.traverse_as_directory([&child_count](auto&) {
  661. ++child_count;
  662. return true;
  663. });
  664. if (traversal_result.is_error())
  665. return traversal_result;
  666. if (child_count != 2)
  667. return ENOTEMPTY;
  668. if (custody.is_readonly())
  669. return EROFS;
  670. if (auto result = inode.remove_child("."); result.is_error())
  671. return result;
  672. if (auto result = inode.remove_child(".."); result.is_error())
  673. return result;
  674. return parent_inode.remove_child(KLexicalPath::basename(path));
  675. }
  676. void VirtualFileSystem::for_each_mount(Function<void(Mount const&)> callback) const
  677. {
  678. m_mounts.with_shared([&](auto& mounts) {
  679. for (auto& mount : mounts) {
  680. callback(mount);
  681. }
  682. });
  683. }
  684. void VirtualFileSystem::sync()
  685. {
  686. FileSystem::sync();
  687. }
  688. Custody& VirtualFileSystem::root_custody()
  689. {
  690. return *m_root_custody;
  691. }
  692. UnveilNode const& VirtualFileSystem::find_matching_unveiled_path(StringView path)
  693. {
  694. VERIFY(Process::current()->veil_state() != VeilState::None);
  695. auto& unveil_root = Process::current()->unveiled_paths();
  696. auto path_parts = KLexicalPath::parts(path);
  697. return unveil_root.traverse_until_last_accessible_node(path_parts.begin(), path_parts.end());
  698. }
  699. KResult VirtualFileSystem::validate_path_against_process_veil(Custody const& custody, int options)
  700. {
  701. if (Process::current()->veil_state() == VeilState::None)
  702. return KSuccess;
  703. auto absolute_path = custody.try_create_absolute_path();
  704. if (!absolute_path)
  705. return ENOMEM;
  706. return validate_path_against_process_veil(absolute_path->view(), options);
  707. }
  708. KResult VirtualFileSystem::validate_path_against_process_veil(StringView path, int options)
  709. {
  710. if (Process::current()->veil_state() == VeilState::None)
  711. return KSuccess;
  712. if (path == "/usr/lib/Loader.so")
  713. return KSuccess;
  714. VERIFY(path.starts_with('/'));
  715. VERIFY(!path.contains("/../"sv) && !path.ends_with("/.."sv));
  716. VERIFY(!path.contains("/./"sv) && !path.ends_with("/."sv));
  717. auto& unveiled_path = find_matching_unveiled_path(path);
  718. if (unveiled_path.permissions() == UnveilAccess::None) {
  719. dbgln("Rejecting path '{}' since it hasn't been unveiled.", path);
  720. dump_backtrace();
  721. return ENOENT;
  722. }
  723. if (options & O_CREAT) {
  724. if (!(unveiled_path.permissions() & UnveilAccess::CreateOrRemove)) {
  725. dbgln("Rejecting path '{}' since it hasn't been unveiled with 'c' permission.", path);
  726. dump_backtrace();
  727. return EACCES;
  728. }
  729. }
  730. if (options & O_UNLINK_INTERNAL) {
  731. if (!(unveiled_path.permissions() & UnveilAccess::CreateOrRemove)) {
  732. dbgln("Rejecting path '{}' for unlink since it hasn't been unveiled with 'c' permission.", path);
  733. dump_backtrace();
  734. return EACCES;
  735. }
  736. return KSuccess;
  737. }
  738. if (options & O_RDONLY) {
  739. if (options & O_DIRECTORY) {
  740. if (!(unveiled_path.permissions() & (UnveilAccess::Read | UnveilAccess::Browse))) {
  741. dbgln("Rejecting path '{}' since it hasn't been unveiled with 'r' or 'b' permissions.", path);
  742. dump_backtrace();
  743. return EACCES;
  744. }
  745. } else {
  746. if (!(unveiled_path.permissions() & UnveilAccess::Read)) {
  747. dbgln("Rejecting path '{}' since it hasn't been unveiled with 'r' permission.", path);
  748. dump_backtrace();
  749. return EACCES;
  750. }
  751. }
  752. }
  753. if (options & O_WRONLY) {
  754. if (!(unveiled_path.permissions() & UnveilAccess::Write)) {
  755. dbgln("Rejecting path '{}' since it hasn't been unveiled with 'w' permission.", path);
  756. dump_backtrace();
  757. return EACCES;
  758. }
  759. }
  760. if (options & O_EXEC) {
  761. if (!(unveiled_path.permissions() & UnveilAccess::Execute)) {
  762. dbgln("Rejecting path '{}' since it hasn't been unveiled with 'x' permission.", path);
  763. dump_backtrace();
  764. return EACCES;
  765. }
  766. }
  767. return KSuccess;
  768. }
  769. KResultOr<NonnullRefPtr<Custody>> VirtualFileSystem::resolve_path(StringView path, Custody& base, RefPtr<Custody>* out_parent, int options, int symlink_recursion_level)
  770. {
  771. auto custody_or_error = resolve_path_without_veil(path, base, out_parent, options, symlink_recursion_level);
  772. if (custody_or_error.is_error())
  773. return custody_or_error.error();
  774. auto& custody = custody_or_error.value();
  775. if (auto result = validate_path_against_process_veil(*custody, options); result.is_error())
  776. return result;
  777. return custody;
  778. }
  779. static bool safe_to_follow_symlink(const Inode& inode, const InodeMetadata& parent_metadata)
  780. {
  781. auto metadata = inode.metadata();
  782. if (Process::current()->euid() == metadata.uid)
  783. return true;
  784. if (!(parent_metadata.is_sticky() && parent_metadata.mode & S_IWOTH))
  785. return true;
  786. if (metadata.uid == parent_metadata.uid)
  787. return true;
  788. return false;
  789. }
  790. KResultOr<NonnullRefPtr<Custody>> VirtualFileSystem::resolve_path_without_veil(StringView path, Custody& base, RefPtr<Custody>* out_parent, int options, int symlink_recursion_level)
  791. {
  792. if (symlink_recursion_level >= symlink_recursion_limit)
  793. return ELOOP;
  794. if (path.is_empty())
  795. return EINVAL;
  796. GenericLexer path_lexer(path);
  797. auto current_process = Process::current();
  798. NonnullRefPtr<Custody> custody = path[0] == '/' ? root_custody() : base;
  799. bool extra_iteration = path[path.length() - 1] == '/';
  800. while (!path_lexer.is_eof() || extra_iteration) {
  801. if (path_lexer.is_eof())
  802. extra_iteration = false;
  803. auto part = path_lexer.consume_until('/');
  804. path_lexer.consume_specific('/');
  805. Custody& parent = custody;
  806. auto parent_metadata = parent.inode().metadata();
  807. if (!parent_metadata.is_directory())
  808. return ENOTDIR;
  809. // Ensure the current user is allowed to resolve paths inside this directory.
  810. if (!parent_metadata.may_execute(*current_process))
  811. return EACCES;
  812. bool have_more_parts = !path_lexer.is_eof() || extra_iteration;
  813. if (part == "..") {
  814. // If we encounter a "..", take a step back, but don't go beyond the root.
  815. if (custody->parent())
  816. custody = *custody->parent();
  817. continue;
  818. } else if (part == "." || part.is_empty()) {
  819. continue;
  820. }
  821. // Okay, let's look up this part.
  822. auto child_or_error = parent.inode().lookup(part);
  823. if (child_or_error.is_error()) {
  824. if (out_parent) {
  825. // ENOENT with a non-null parent custody signals to caller that
  826. // we found the immediate parent of the file, but the file itself
  827. // does not exist yet.
  828. *out_parent = have_more_parts ? nullptr : &parent;
  829. }
  830. return child_or_error.error();
  831. }
  832. auto child_inode = child_or_error.release_value();
  833. int mount_flags_for_child = parent.mount_flags();
  834. // See if there's something mounted on the child; in that case
  835. // we would need to return the guest inode, not the host inode.
  836. if (auto mount = find_mount_for_host(child_inode->identifier())) {
  837. child_inode = mount->guest();
  838. mount_flags_for_child = mount->flags();
  839. }
  840. auto new_custody_or_error = Custody::try_create(&parent, part, *child_inode, mount_flags_for_child);
  841. if (new_custody_or_error.is_error())
  842. return new_custody_or_error.error();
  843. custody = new_custody_or_error.release_value();
  844. if (child_inode->metadata().is_symlink()) {
  845. if (!have_more_parts) {
  846. if (options & O_NOFOLLOW)
  847. return ELOOP;
  848. if (options & O_NOFOLLOW_NOERROR)
  849. break;
  850. }
  851. if (!safe_to_follow_symlink(*child_inode, parent_metadata))
  852. return EACCES;
  853. if (auto result = validate_path_against_process_veil(*custody, options); result.is_error())
  854. return result;
  855. auto symlink_target = child_inode->resolve_as_link(parent, out_parent, options, symlink_recursion_level + 1);
  856. if (symlink_target.is_error() || !have_more_parts)
  857. return symlink_target;
  858. // Now, resolve the remaining path relative to the symlink target.
  859. // We prepend a "." to it to ensure that it's not empty and that
  860. // any initial slashes it might have get interpreted properly.
  861. StringBuilder remaining_path;
  862. remaining_path.append('.');
  863. remaining_path.append(path.substring_view_starting_after_substring(part));
  864. return resolve_path_without_veil(remaining_path.to_string(), *symlink_target.value(), out_parent, options, symlink_recursion_level + 1);
  865. }
  866. }
  867. if (out_parent)
  868. *out_parent = custody->parent();
  869. return custody;
  870. }
  871. }