authorgravatar for gereeter+code@gmail.comJonathan S <gereeter+code@gmail.com> 2020-03-28 00:33:12-05:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2020-05-29 18:27:39-04:00
logc209da1589f50dee9e961f64cb389d0b4e485aba
treee8a34da5d0822d19cc0e5391497f3558c16b71e6
parent0674b51453d5631f400936b4da7c74788f745e90

Document the failure to improve selfExe{,Dir}PathAlloc

1 files changed, 14 insertions(+), 4 deletions(-)

lib/std/fs.zig+14-4
......@@ -1800,8 +1800,13 @@ pub const SelfExePathError = os.ReadLinkError || os.SysCtlError;
18001800/// `selfExePath` except allocates the result on the heap.
18011801/// Caller owns returned memory.
18021802pub fn selfExePathAlloc(allocator: *Allocator) ![]u8 {
1803 // TODO(#4812): Consider looping with larger and larger buffers to handle
1804 // overlong paths.
1803 // Use of MAX_PATH_BYTES here is justified as, at least on one tested Linux
1804 // system, readlink will completely fail to return a result larger than
1805 // PATH_MAX even if given a sufficiently large buffer. This makes it
1806 // fundamentally impossible to get the selfExePath of a program running in
1807 // a very deeply nested directory chain in this way.
1808 // TODO(#4812): Investigate other systems and whether it is possible to get
1809 // this path by trying larger and larger buffers until one succeeds.
18051810 var buf: [MAX_PATH_BYTES]u8 = undefined;
18061811 return mem.dupe(allocator, u8, try selfExePath(&buf));
18071812}
......@@ -1858,8 +1863,13 @@ pub fn selfExePathW() [:0]const u16 {
18581863/// `selfExeDirPath` except allocates the result on the heap.
18591864/// Caller owns returned memory.
18601865pub fn selfExeDirPathAlloc(allocator: *Allocator) ![]u8 {
1861 // TODO(#4812): Consider looping with larger and larger buffers to handle
1862 // overlong paths.
1866 // Use of MAX_PATH_BYTES here is justified as, at least on one tested Linux
1867 // system, readlink will completely fail to return a result larger than
1868 // PATH_MAX even if given a sufficiently large buffer. This makes it
1869 // fundamentally impossible to get the selfExeDirPath of a program running
1870 // in a very deeply nested directory chain in this way.
1871 // TODO(#4812): Investigate other systems and whether it is possible to get
1872 // this path by trying larger and larger buffers until one succeeds.
18631873 var buf: [MAX_PATH_BYTES]u8 = undefined;
18641874 return mem.dupe(allocator, u8, try selfExeDirPath(&buf));
18651875}