linux/fs/xfs/scrub/orphanage.h

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * Copyright (c) 2021-2024 Oracle.  All Rights Reserved.
 * Author: Darrick J. Wong <djwong@kernel.org>
 */
#ifndef __XFS_SCRUB_ORPHANAGE_H__
#define __XFS_SCRUB_ORPHANAGE_H__

#ifdef CONFIG_XFS_ONLINE_REPAIR
int xrep_orphanage_create(struct xfs_scrub *sc);

/*
 * If we're doing a repair, ensure that the orphanage exists and attach it to
 * the scrub context.
 */
static inline int
xrep_orphanage_try_create(
	struct xfs_scrub	*sc)
{
	int			error;

	ASSERT(sc->sm->sm_flags & XFS_SCRUB_IFLAG_REPAIR);

	error = xrep_orphanage_create(sc);
	switch (error) {
	case 0:
	case -ENOENT:
	case -ENOTDIR:
	case -ENOSPC:
		/*
		 * If the orphanage can't be found or isn't a directory, we'll
		 * keep going, but we won't be able to attach the file to the
		 * orphanage if we can't find the parent.
		 */
		return 0;
	}

	return error;
}

int xrep_orphanage_iolock_two(struct xfs_scrub *sc);

void xrep_orphanage_ilock(struct xfs_scrub *sc, unsigned int ilock_flags);
bool xrep_orphanage_ilock_nowait(struct xfs_scrub *sc,
		unsigned int ilock_flags);
void xrep_orphanage_iunlock(struct xfs_scrub *sc, unsigned int ilock_flags);

void xrep_orphanage_rele(struct xfs_scrub *sc);

/* Information about a request to add a file to the orphanage. */
struct xrep_adoption {
	struct xfs_scrub	*sc;

	/* Name used for the adoption. */
	struct xfs_name		*xname;

	/* Parent pointer context tracking */
	struct xfs_parent_args	ppargs;

	/* Block reservations for orphanage and child (if directory). */
	unsigned int		orphanage_blkres;
	unsigned int		child_blkres;

	/*
	 * Does the caller want us to bump the child link count?  This is not
	 * needed when reattaching files that have become disconnected but have
	 * nlink > 1.  It is necessary when changing the directory tree
	 * structure.
	 */
	bool			bump_child_nlink:1;
};

bool xrep_orphanage_can_adopt(struct xfs_scrub *sc);

int xrep_adoption_trans_alloc(struct xfs_scrub *sc,
		struct xrep_adoption *adopt);
int xrep_adoption_compute_name(struct xrep_adoption *adopt,
		struct xfs_name *xname);
int xrep_adoption_move(struct xrep_adoption *adopt);
int xrep_adoption_trans_roll(struct xrep_adoption *adopt);
#else
struct xrep_adoption { /* empty */ };
# define xrep_orphanage_rele(sc)	((void)0)
#endif /* CONFIG_XFS_ONLINE_REPAIR */

#endif /* __XFS_SCRUB_ORPHANAGE_H__ */