Function SearchNPathRecursively

internal/fsext/fs.go:173–208

SearchNPathRecursively walks up the directory tree starting at the given path, calling the Search function in each directory and adding each matching file that it finds to a list until it reaches the root directory or the length of the list exceeds n. On supported operating systems, it will also che

(path string, possibleFilenames []string, n int)

// length of the list exceeds n. On supported operating systems, it will also
// check if the user ID of the directory changes and abort if it does.
func SearchNPathRecursively(path string, possibleFilenames []string, n int) ([]string, error) {
	var paths []string

	owner, err := sysinfo.Owner(path)
	if err != nil {
		return nil, err
	}

	for n == -1 || len(paths) < n {
		fpath, err := SearchPath(path, possibleFilenames)
		if err == nil {
			paths = append(paths, fpath)
		}

		// Get the parent path/user id
		parentPath := filepath.Dir(path)
		parentOwner, err := sysinfo.Owner(parentPath)
		if err != nil {
			return nil, err
		}

		// If the user id of the directory changes indicate a permission error, otherwise
		// the calling code will infer an error condition based on the accumulated
		// contents of paths.
		if path == parentPath {
			return paths, nil
		} else if parentOwner != owner {
			return paths, os.ErrPermission
		}

		owner = parentOwner
		path = parentPath
	}

	return paths, nil
}