2 * Copyright (c) 1999-2013 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
30 #include <sys/systm.h>
31 #include <sys/kernel.h>
32 #include <sys/malloc.h>
33 #include <sys/mount.h>
35 #include <sys/vnode.h>
36 #include <vfs/vfs_support.h>
37 #include <libkern/libkern.h>
38 #include <sys/fsctl.h>
41 #include "hfs_catalog.h"
42 #include "hfs_format.h"
43 #include "hfs_endian.h"
46 static int cur_link_id
= 0;
49 * Private directories where hardlink inodes reside.
51 const char *hfs_private_names
[] = {
52 HFSPLUSMETADATAFOLDER
, /* FILE HARDLINKS */
53 HFSPLUS_DIR_METADATA_FOLDER
/* DIRECTORY HARDLINKS */
58 * Hardlink inodes save the head of their link chain in a
59 * private extended attribute. The following calls are
60 * used to access this attribute.
62 static int setfirstlink(struct hfsmount
* hfsmp
, cnid_t fileid
, cnid_t firstlink
);
63 static int getfirstlink(struct hfsmount
* hfsmp
, cnid_t fileid
, cnid_t
*firstlink
);
65 int hfs_makelink(struct hfsmount
*hfsmp
, struct vnode
*src_vp
, struct cnode
*cp
,
66 struct cnode
*dcp
, struct componentname
*cnp
);
68 * Create a new catalog link record
70 * An indirect link is a reference to an inode (the real
71 * file or directory record).
73 * All the indirect links for a given inode are chained
74 * together in a doubly linked list.
76 * Pre-Leopard file hard links do not have kHFSHasLinkChainBit
77 * set and do not have first/prev/next link IDs i.e. the values
78 * are zero. If a new link is being added to an existing
79 * pre-Leopard file hard link chain, do not set kHFSHasLinkChainBit.
82 createindirectlink(struct hfsmount
*hfsmp
, u_int32_t linknum
, struct cat_desc
*descp
,
83 cnid_t nextcnid
, cnid_t
*linkcnid
, int is_inode_linkchain_set
)
85 struct FndrFileInfo
*fip
;
89 printf("hfs: createindirectlink: linknum is zero!\n");
93 /* Setup the default attributes */
94 bzero(&attr
, sizeof(attr
));
96 /* Links are matched to inodes by link ID and to volumes by create date */
97 attr
.ca_linkref
= linknum
;
98 attr
.ca_itime
= hfsmp
->hfs_metadata_createdate
;
99 attr
.ca_mode
= S_IFREG
| S_IRUSR
| S_IRGRP
| S_IROTH
;
100 attr
.ca_recflags
= kHFSHasLinkChainMask
| kHFSThreadExistsMask
;
101 attr
.ca_flags
= UF_IMMUTABLE
;
102 fip
= (struct FndrFileInfo
*)&attr
.ca_finderinfo
;
104 if (descp
->cd_flags
& CD_ISDIR
) {
105 fip
->fdType
= SWAP_BE32 (kHFSAliasType
);
106 fip
->fdCreator
= SWAP_BE32 (kHFSAliasCreator
);
107 fip
->fdFlags
= SWAP_BE16 (kIsAlias
);
109 fip
->fdType
= SWAP_BE32 (kHardLinkFileType
);
110 fip
->fdCreator
= SWAP_BE32 (kHFSPlusCreator
);
111 fip
->fdFlags
= SWAP_BE16 (kHasBeenInited
);
112 /* If the file inode does not have kHFSHasLinkChainBit set
113 * and the next link chain ID is zero, assume that this
114 * is pre-Leopard file inode. Therefore clear the bit.
116 if ((is_inode_linkchain_set
== 0) && (nextcnid
== 0)) {
117 attr
.ca_recflags
&= ~kHFSHasLinkChainMask
;
120 /* Create the indirect link directly in the catalog */
121 return cat_createlink(hfsmp
, descp
, &attr
, nextcnid
, linkcnid
);
126 * Make a link to the cnode cp in the directory dp
127 * using the name in cnp. src_vp is the vnode that
128 * corresponds to 'cp' which was part of the arguments to
131 * The cnodes cp and dcp must be locked.
134 hfs_makelink(struct hfsmount
*hfsmp
, struct vnode
*src_vp
, struct cnode
*cp
,
135 struct cnode
*dcp
, struct componentname
*cnp
)
137 vfs_context_t ctx
= cnp
->cn_context
;
138 struct proc
*p
= vfs_context_proc(ctx
);
139 u_int32_t indnodeno
= 0;
141 struct cat_desc to_desc
;
142 struct cat_desc link_desc
;
149 cnid_t orig_firstlink
;
150 enum privdirtype type
;
152 type
= S_ISDIR(cp
->c_mode
) ? DIR_HARDLINKS
: FILE_HARDLINKS
;
154 if (cur_link_id
== 0) {
155 cur_link_id
= ((random() & 0x3fffffff) + 100);
158 /* We don't allow link nodes in our private system directories. */
159 if (dcp
->c_fileid
== hfsmp
->hfs_private_desc
[FILE_HARDLINKS
].cd_cnid
||
160 dcp
->c_fileid
== hfsmp
->hfs_private_desc
[DIR_HARDLINKS
].cd_cnid
) {
164 bzero(&cookie
, sizeof(cat_cookie_t
));
165 /* Reserve some space in the Catalog file. */
166 if ((retval
= cat_preflight(hfsmp
, (2 * CAT_CREATE
)+ CAT_RENAME
, &cookie
, p
))) {
170 lockflags
= SFL_CATALOG
| SFL_ATTRIBUTE
;
171 /* Directory hard links allocate space for a symlink. */
172 if (type
== DIR_HARDLINKS
) {
173 lockflags
|= SFL_BITMAP
;
175 lockflags
= hfs_systemfile_lock(hfsmp
, lockflags
, HFS_EXCLUSIVE_LOCK
);
177 /* Save the current cnid value so we restore it if an error occurs. */
178 orig_cnid
= cp
->c_desc
.cd_cnid
;
181 * If this is a new hardlink then we need to create the inode
182 * and replace the original file/dir object with a link node.
184 if ((cp
->c_linkcount
== 2) && !(cp
->c_flag
& C_HARDLINK
)) {
186 bzero(&to_desc
, sizeof(to_desc
));
187 to_desc
.cd_parentcnid
= hfsmp
->hfs_private_desc
[type
].cd_cnid
;
188 to_desc
.cd_cnid
= cp
->c_fileid
;
189 to_desc
.cd_flags
= (type
== DIR_HARDLINKS
) ? CD_ISDIR
: 0;
192 if (type
== DIR_HARDLINKS
) {
193 /* Directory hardlinks always use the cnid. */
194 indnodeno
= cp
->c_fileid
;
195 MAKE_DIRINODE_NAME(inodename
, sizeof(inodename
),
198 /* Get a unique indirect node number */
200 indnodeno
= cp
->c_fileid
;
202 indnodeno
= cur_link_id
++;
204 MAKE_INODE_NAME(inodename
, sizeof(inodename
),
207 /* Move original file/dir to data node directory */
208 to_desc
.cd_nameptr
= (const u_int8_t
*)inodename
;
209 to_desc
.cd_namelen
= strlen(inodename
);
211 retval
= cat_rename(hfsmp
, &cp
->c_desc
, &hfsmp
->hfs_private_desc
[type
],
214 if (retval
!= 0 && retval
!= EEXIST
) {
215 printf("hfs_makelink: cat_rename to %s failed (%d). fileid %d\n",
216 inodename
, retval
, cp
->c_fileid
);
218 } while ((retval
== EEXIST
) && (type
== FILE_HARDLINKS
));
223 * Replace original file/dir with a link record.
226 bzero(&link_desc
, sizeof(link_desc
));
227 link_desc
.cd_nameptr
= cp
->c_desc
.cd_nameptr
;
228 link_desc
.cd_namelen
= cp
->c_desc
.cd_namelen
;
229 link_desc
.cd_parentcnid
= cp
->c_parentcnid
;
230 link_desc
.cd_flags
= S_ISDIR(cp
->c_mode
) ? CD_ISDIR
: 0;
232 retval
= createindirectlink(hfsmp
, indnodeno
, &link_desc
, 0, &linkcnid
, true);
236 /* Restore the cnode's cnid. */
237 cp
->c_desc
.cd_cnid
= orig_cnid
;
239 /* Put the original file back. */
240 err
= cat_rename(hfsmp
, &to_desc
, &dcp
->c_desc
, &cp
->c_desc
, NULL
);
241 if (err
&& err
!= EIO
&& err
!= ENXIO
)
242 panic("hfs_makelink: error %d from cat_rename backout 1", err
);
245 cp
->c_attr
.ca_linkref
= indnodeno
;
246 cp
->c_desc
.cd_cnid
= linkcnid
;
247 /* Directory hard links store the first link in an attribute. */
248 if (type
== DIR_HARDLINKS
) {
249 if (setfirstlink(hfsmp
, cp
->c_fileid
, linkcnid
) == 0)
250 cp
->c_attr
.ca_recflags
|= kHFSHasAttributesMask
;
251 } else /* FILE_HARDLINKS */ {
252 cp
->c_attr
.ca_firstlink
= linkcnid
;
254 cp
->c_attr
.ca_recflags
|= kHFSHasLinkChainMask
;
256 indnodeno
= cp
->c_attr
.ca_linkref
;
260 * Create a catalog entry for the new link (parentID + name).
263 bzero(&link_desc
, sizeof(link_desc
));
264 link_desc
.cd_nameptr
= (const u_int8_t
*)cnp
->cn_nameptr
;
265 link_desc
.cd_namelen
= strlen(cnp
->cn_nameptr
);
266 link_desc
.cd_parentcnid
= dcp
->c_fileid
;
267 link_desc
.cd_flags
= S_ISDIR(cp
->c_mode
) ? CD_ISDIR
: 0;
269 /* Directory hard links store the first link in an attribute. */
270 if (type
== DIR_HARDLINKS
) {
271 retval
= getfirstlink(hfsmp
, cp
->c_fileid
, &orig_firstlink
);
272 } else /* FILE_HARDLINKS */ {
273 orig_firstlink
= cp
->c_attr
.ca_firstlink
;
276 retval
= createindirectlink(hfsmp
, indnodeno
, &link_desc
,
277 orig_firstlink
, &linkcnid
,
278 (cp
->c_attr
.ca_recflags
& kHFSHasLinkChainMask
));
279 if (retval
&& newlink
) {
282 /* Get rid of new link */
283 (void) cat_delete(hfsmp
, &cp
->c_desc
, &cp
->c_attr
);
285 /* Restore the cnode's cnid. */
286 cp
->c_desc
.cd_cnid
= orig_cnid
;
288 /* Put the original file back. */
289 err
= cat_rename(hfsmp
, &to_desc
, &dcp
->c_desc
, &cp
->c_desc
, NULL
);
290 if (err
&& err
!= EIO
&& err
!= ENXIO
)
291 panic("hfs_makelink: error %d from cat_rename backout 2", err
);
293 cp
->c_attr
.ca_linkref
= 0;
295 } else if (retval
== 0) {
297 /* Update the original first link to point back to the new first link. */
298 if (cp
->c_attr
.ca_recflags
& kHFSHasLinkChainMask
) {
299 (void) cat_update_siblinglinks(hfsmp
, orig_firstlink
, linkcnid
, HFS_IGNORABLE_LINK
);
301 /* Update the inode's first link value. */
302 if (type
== DIR_HARDLINKS
) {
303 if (setfirstlink(hfsmp
, cp
->c_fileid
, linkcnid
) == 0)
304 cp
->c_attr
.ca_recflags
|= kHFSHasAttributesMask
;
306 cp
->c_attr
.ca_firstlink
= linkcnid
;
310 * Finally, if this is a new hardlink then:
311 * - update the private system directory
312 * - mark the cnode as a hard link
318 panic("hfs_makelink: retval %d but newlink = 1!\n", retval
);
321 hfsmp
->hfs_private_attr
[type
].ca_entries
++;
322 /* From application perspective, directory hard link is a
323 * normal directory. Therefore count the new directory
324 * hard link for folder count calculation.
326 if (type
== DIR_HARDLINKS
) {
327 INC_FOLDERCOUNT(hfsmp
, hfsmp
->hfs_private_attr
[type
]);
329 retval
= cat_update(hfsmp
, &hfsmp
->hfs_private_desc
[type
],
330 &hfsmp
->hfs_private_attr
[type
], NULL
, NULL
);
331 if (retval
!= 0 && retval
!= EIO
&& retval
!= ENXIO
) {
332 panic("hfs_makelink: cat_update of privdir failed! (%d)\n", retval
);
334 cp
->c_flag
|= C_HARDLINK
;
337 * Now we need to mark the vnodes as being hardlinks via the vnode_setmultipath call.
338 * Note that we're calling vnode_get here, which should simply add an iocount if possible, without
339 * doing much checking. It's safe to call this because we are protected by the cnode lock, which
340 * ensures that anyone trying to reclaim it will block until we release it. vnode_get will usually
341 * give us an extra iocount, unless the vnode is about to be reclaimed (and has no iocounts).
342 * In that case, we'd error out, but we'd also not care if we added the VISHARDLINK bit to the vnode.
344 * As for the iocount we're about to add, we can't necessarily always call vnode_put here.
345 * If the one we add is the only iocount on the vnode, and there was
346 * sufficient vnode pressure, it could go through VNOP_INACTIVE immediately, which would
347 * require the cnode lock and cause us to double-lock panic. We can only call vnode_put if we know
348 * that the vnode we're operating on is the one with which we came into hfs_vnop_link, because
349 * that means VFS took an iocount on it for us. If it's *not* the one that we came into the call
350 * with, then mark it as NEED_VNODE_PUT to have hfs_unlock drop it for us. hfs_vnop_link will
351 * unlock the cnode when it is finished.
353 if ((vp
= cp
->c_vp
) != NULLVP
) {
354 if (vnode_get(vp
) == 0) {
355 vnode_setmultipath(vp
);
357 /* we have an iocount on data fork vnode already. */
361 cp
->c_flag
|= C_NEED_DVNODE_PUT
;
365 if ((vp
= cp
->c_rsrc_vp
) != NULLVP
) {
366 if (vnode_get(vp
) == 0) {
367 vnode_setmultipath(vp
);
372 cp
->c_flag
|= C_NEED_RVNODE_PUT
;
376 cp
->c_touch_chgtime
= TRUE
;
377 cp
->c_flag
|= C_FORCEUPDATE
;
379 dcp
->c_flag
|= C_FORCEUPDATE
;
382 hfs_systemfile_unlock(hfsmp
, lockflags
);
384 cat_postflight(hfsmp
, &cookie
, p
);
386 if (retval
== 0 && newlink
) {
387 hfs_volupdate(hfsmp
, VOL_MKFILE
, 0);
394 * link vnode operation
398 * IN struct componentname *a_cnp;
399 * IN vfs_context_t a_context;
402 hfs_vnop_link(struct vnop_link_args
*ap
)
404 struct hfsmount
*hfsmp
;
405 struct vnode
*vp
= ap
->a_vp
;
406 struct vnode
*tdvp
= ap
->a_tdvp
;
407 struct vnode
*fdvp
= NULLVP
;
408 struct componentname
*cnp
= ap
->a_cnp
;
411 struct cnode
*fdcp
= NULL
;
412 struct cat_desc todesc
;
420 v_type
= vnode_vtype(vp
);
422 /* No hard links in HFS standard file systems. */
423 if (hfsmp
->hfs_flags
& HFS_STANDARD
) {
426 /* Linking to a special file is not permitted. */
427 if (v_type
== VBLK
|| v_type
== VCHR
) {
430 if (v_type
== VDIR
) {
431 /* Make sure our private directory exists. */
432 if (hfsmp
->hfs_private_desc
[DIR_HARDLINKS
].cd_cnid
== 0) {
436 * Directory hardlinks (ADLs) have only been qualified on
437 * journaled HFS+. If/when they are tested on non-journaled
438 * file systems then this test can be removed.
440 if (hfsmp
->jnl
== NULL
) {
443 /* Directory hardlinks also need the parent of the original directory. */
444 if ((error
= hfs_vget(hfsmp
, hfs_currentparent(VTOC(vp
)), &fdvp
, 1, 0))) {
448 /* Make sure our private directory exists. */
449 if (hfsmp
->hfs_private_desc
[FILE_HARDLINKS
].cd_cnid
== 0) {
453 if (hfs_freeblks(hfsmp
, 0) == 0) {
460 check_for_tracked_file(vp
, VTOC(vp
)->c_ctime
, NAMESPACE_HANDLER_LINK_CREATE
, NULL
);
463 /* Lock the cnodes. */
465 if ((error
= hfs_lockfour(VTOC(tdvp
), VTOC(vp
), VTOC(fdvp
), NULL
, HFS_EXCLUSIVE_LOCK
, NULL
))) {
473 if ((error
= hfs_lockpair(VTOC(tdvp
), VTOC(vp
), HFS_EXCLUSIVE_LOCK
))) {
479 /* grab the parent CNID from originlist after grabbing cnode locks */
480 parentcnid
= hfs_currentparent(cp
);
483 * Make sure we didn't race the src or dst parent directories with rmdir.
484 * Note that we should only have a src parent directory cnode lock
485 * if we're dealing with a directory hardlink here.
488 if (fdcp
->c_flag
& (C_NOEXISTS
| C_DELETED
)) {
494 if (tdcp
->c_flag
& (C_NOEXISTS
| C_DELETED
)) {
499 /* Check the source for errors:
500 * too many links, immutable, race with unlink
502 if (cp
->c_linkcount
>= HFS_LINK_MAX
) {
506 if (cp
->c_bsdflags
& (IMMUTABLE
| APPEND
)) {
510 if (cp
->c_flag
& (C_NOEXISTS
| C_DELETED
)) {
515 tdcp
->c_flag
|= C_DIR_MODIFICATION
;
517 if (hfs_start_transaction(hfsmp
) != 0) {
523 todesc
.cd_flags
= (v_type
== VDIR
) ? CD_ISDIR
: 0;
524 todesc
.cd_encoding
= 0;
525 todesc
.cd_nameptr
= (const u_int8_t
*)cnp
->cn_nameptr
;
526 todesc
.cd_namelen
= cnp
->cn_namelen
;
527 todesc
.cd_parentcnid
= tdcp
->c_fileid
;
531 lockflags
= hfs_systemfile_lock(hfsmp
, SFL_CATALOG
, HFS_SHARED_LOCK
);
533 /* If destination exists then we lost a race with create. */
534 if (cat_lookup(hfsmp
, &todesc
, 0, NULL
, NULL
, NULL
, NULL
) == 0) {
538 if (cp
->c_flag
& C_HARDLINK
) {
539 struct cat_attr cattr
;
541 /* If inode is missing then we lost a race with unlink. */
542 if ((cat_idlookup(hfsmp
, cp
->c_fileid
, 0, 0, NULL
, &cattr
, NULL
) != 0) ||
543 (cattr
.ca_fileid
!= cp
->c_fileid
)) {
550 /* If source is missing then we lost a race with unlink. */
551 if ((cat_lookup(hfsmp
, &cp
->c_desc
, 0, NULL
, NULL
, NULL
, &fileid
) != 0) ||
552 (fileid
!= cp
->c_fileid
)) {
558 * All directory links must reside in an non-ARCHIVED hierarchy.
560 if (v_type
== VDIR
) {
562 * - Source parent and destination parent cannot match
563 * - A link is not permitted in the root directory
564 * - Parent of 'pointed at' directory is not the root directory
565 * - The 'pointed at' directory (source) is not an ancestor
566 * of the new directory hard link (destination).
567 * - No ancestor of the new directory hard link (destination)
568 * is a directory hard link.
570 if ((parentcnid
== tdcp
->c_fileid
) ||
571 (tdcp
->c_fileid
== kHFSRootFolderID
) ||
572 (parentcnid
== kHFSRootFolderID
) ||
573 cat_check_link_ancestry(hfsmp
, tdcp
->c_fileid
, cp
->c_fileid
)) {
574 error
= EPERM
; /* abide by the rules, you did not */
578 hfs_systemfile_unlock(hfsmp
, lockflags
);
582 cp
->c_touch_chgtime
= TRUE
;
583 error
= hfs_makelink(hfsmp
, vp
, cp
, tdcp
, cnp
);
586 hfs_volupdate(hfsmp
, VOL_UPDATE
, 0);
588 /* Invalidate negative cache entries in the destination directory */
589 if (tdcp
->c_flag
& C_NEG_ENTRIES
) {
590 cache_purge_negatives(tdvp
);
591 tdcp
->c_flag
&= ~C_NEG_ENTRIES
;
594 /* Update the target directory and volume stats */
596 if (v_type
== VDIR
) {
597 INC_FOLDERCOUNT(hfsmp
, tdcp
->c_attr
);
598 tdcp
->c_attr
.ca_recflags
|= kHFSHasChildLinkMask
;
600 /* Set kHFSHasChildLinkBit in the destination hierarchy */
601 error
= cat_set_childlinkbit(hfsmp
, tdcp
->c_parentcnid
);
603 printf ("hfs_vnop_link: error updating destination parent chain for %u\n", tdcp
->c_cnid
);
607 tdcp
->c_dirchangecnt
++;
608 tdcp
->c_touch_chgtime
= TRUE
;
609 tdcp
->c_touch_modtime
= TRUE
;
610 tdcp
->c_flag
|= C_FORCEUPDATE
;
612 error
= hfs_update(tdvp
, 0);
613 if (error
&& error
!= EIO
&& error
!= ENXIO
) {
614 panic("hfs_vnop_link: error %d updating tdvp %p\n", error
, tdvp
);
617 if ((v_type
== VDIR
) &&
619 ((fdcp
->c_attr
.ca_recflags
& kHFSHasChildLinkMask
) == 0)) {
621 fdcp
->c_attr
.ca_recflags
|= kHFSHasChildLinkMask
;
622 fdcp
->c_touch_chgtime
= TRUE
;
623 fdcp
->c_flag
|= C_FORCEUPDATE
;
624 error
= hfs_update(fdvp
, 0);
625 if (error
&& error
!= EIO
&& error
!= ENXIO
) {
626 panic("hfs_vnop_link: error %d updating fdvp %p\n", error
, fdvp
);
629 /* Set kHFSHasChildLinkBit in the source hierarchy */
630 error
= cat_set_childlinkbit(hfsmp
, fdcp
->c_parentcnid
);
632 printf ("hfs_vnop_link: error updating source parent chain for %u\n", fdcp
->c_cnid
);
636 hfs_volupdate(hfsmp
, VOL_MKFILE
,
637 (tdcp
->c_cnid
== kHFSRootFolderID
));
639 /* Make sure update occurs inside transaction */
640 cp
->c_flag
|= C_FORCEUPDATE
;
642 if ((error
== 0) && (ret
= hfs_update(vp
, TRUE
)) != 0 && ret
!= EIO
&& ret
!= ENXIO
) {
643 panic("hfs_vnop_link: error %d updating vp @ %p\n", ret
, vp
);
648 hfs_systemfile_unlock(hfsmp
, lockflags
);
651 hfs_end_transaction(hfsmp
);
654 tdcp
->c_flag
&= ~C_DIR_MODIFICATION
;
655 wakeup((caddr_t
)&tdcp
->c_flag
);
658 hfs_unlockfour(tdcp
, cp
, fdcp
, NULL
);
660 hfs_unlockpair(tdcp
, cp
);
670 * Remove a link to a hardlink file/dir.
672 * Note: dvp and vp cnodes are already locked.
675 hfs_unlink(struct hfsmount
*hfsmp
, struct vnode
*dvp
, struct vnode
*vp
, struct componentname
*cnp
, int skip_reserve
)
679 struct cat_desc cndesc
;
688 if (hfsmp
->hfs_flags
& HFS_STANDARD
) {
694 dcp
->c_flag
|= C_DIR_MODIFICATION
;
696 /* Remove the entry from the namei cache: */
699 if ((error
= hfs_start_transaction(hfsmp
)) != 0) {
706 * Protect against a race with rename by using the component
707 * name passed in and parent id from dvp (instead of using
708 * the cp->c_desc which may have changed).
710 * Re-lookup the component name so we get the correct cnid
711 * for the name (as opposed to the c_cnid in the cnode which
712 * could have changed before the cnode was locked).
714 cndesc
.cd_flags
= vnode_isdir(vp
) ? CD_ISDIR
: 0;
715 cndesc
.cd_encoding
= cp
->c_desc
.cd_encoding
;
716 cndesc
.cd_nameptr
= (const u_int8_t
*)cnp
->cn_nameptr
;
717 cndesc
.cd_namelen
= cnp
->cn_namelen
;
718 cndesc
.cd_parentcnid
= dcp
->c_fileid
;
719 cndesc
.cd_hint
= dcp
->c_childhint
;
721 lockflags
= SFL_CATALOG
| SFL_ATTRIBUTE
;
722 if (cndesc
.cd_flags
& CD_ISDIR
) {
723 /* We'll be removing the alias resource allocation blocks. */
724 lockflags
|= SFL_BITMAP
;
726 lockflags
= hfs_systemfile_lock(hfsmp
, lockflags
, HFS_EXCLUSIVE_LOCK
);
728 if ((error
= cat_lookuplink(hfsmp
, &cndesc
, &cndesc
.cd_cnid
, &prevlinkid
, &nextlinkid
))) {
732 /* Reserve some space in the catalog file. */
733 if (!skip_reserve
&& (error
= cat_preflight(hfsmp
, 2 * CAT_DELETE
, NULL
, 0))) {
737 /* Purge any cached origin entries for a directory or file hard link. */
738 hfs_relorigin(cp
, dcp
->c_fileid
);
739 if (dcp
->c_fileid
!= dcp
->c_cnid
) {
740 hfs_relorigin(cp
, dcp
->c_cnid
);
743 /* Delete the link record. */
744 if ((error
= cat_deletelink(hfsmp
, &cndesc
))) {
748 /* Update the parent directory. */
749 if (dcp
->c_entries
> 0) {
752 if (cndesc
.cd_flags
& CD_ISDIR
) {
753 DEC_FOLDERCOUNT(hfsmp
, dcp
->c_attr
);
755 dcp
->c_dirchangecnt
++;
757 dcp
->c_ctime
= tv
.tv_sec
;
758 dcp
->c_mtime
= tv
.tv_sec
;
759 (void ) cat_update(hfsmp
, &dcp
->c_desc
, &dcp
->c_attr
, NULL
, NULL
);
762 * If this is the last link then we need to process the inode.
763 * Otherwise we need to fix up the link chain.
766 if (cp
->c_linkcount
< 1) {
768 struct cat_desc to_desc
;
769 struct cat_desc from_desc
;
772 * If a file inode or directory inode is being deleted, rename
773 * it to an open deleted file. This ensures that deletion
774 * of inode and its corresponding extended attributes does
775 * not overflow the journal. This inode will be deleted
776 * either in hfs_vnop_inactive() or in hfs_remove_orphans().
777 * Note: a rename failure here is not fatal.
779 bzero(&from_desc
, sizeof(from_desc
));
780 bzero(&to_desc
, sizeof(to_desc
));
781 if (vnode_isdir(vp
)) {
782 if (cp
->c_entries
!= 0) {
783 panic("hfs_unlink: dir not empty (id %d, %d entries)", cp
->c_fileid
, cp
->c_entries
);
785 MAKE_DIRINODE_NAME(inodename
, sizeof(inodename
),
786 cp
->c_attr
.ca_linkref
);
787 from_desc
.cd_parentcnid
= hfsmp
->hfs_private_desc
[DIR_HARDLINKS
].cd_cnid
;
788 from_desc
.cd_flags
= CD_ISDIR
;
789 to_desc
.cd_flags
= CD_ISDIR
;
791 MAKE_INODE_NAME(inodename
, sizeof(inodename
),
792 cp
->c_attr
.ca_linkref
);
793 from_desc
.cd_parentcnid
= hfsmp
->hfs_private_desc
[FILE_HARDLINKS
].cd_cnid
;
794 from_desc
.cd_flags
= 0;
795 to_desc
.cd_flags
= 0;
797 from_desc
.cd_nameptr
= (const u_int8_t
*)inodename
;
798 from_desc
.cd_namelen
= strlen(inodename
);
799 from_desc
.cd_cnid
= cp
->c_fileid
;
801 MAKE_DELETED_NAME(delname
, sizeof(delname
), cp
->c_fileid
);
802 to_desc
.cd_nameptr
= (const u_int8_t
*)delname
;
803 to_desc
.cd_namelen
= strlen(delname
);
804 to_desc
.cd_parentcnid
= hfsmp
->hfs_private_desc
[FILE_HARDLINKS
].cd_cnid
;
805 to_desc
.cd_cnid
= cp
->c_fileid
;
807 error
= cat_rename(hfsmp
, &from_desc
, &hfsmp
->hfs_private_desc
[FILE_HARDLINKS
],
808 &to_desc
, (struct cat_desc
*)NULL
);
810 cp
->c_flag
|= C_DELETED
;
811 cp
->c_attr
.ca_recflags
&= ~kHFSHasLinkChainMask
;
812 cp
->c_attr
.ca_firstlink
= 0;
813 if (vnode_isdir(vp
)) {
814 hfsmp
->hfs_private_attr
[DIR_HARDLINKS
].ca_entries
--;
815 DEC_FOLDERCOUNT(hfsmp
, hfsmp
->hfs_private_attr
[DIR_HARDLINKS
]);
817 hfsmp
->hfs_private_attr
[FILE_HARDLINKS
].ca_entries
++;
818 INC_FOLDERCOUNT(hfsmp
, hfsmp
->hfs_private_attr
[FILE_HARDLINKS
]);
820 (void)cat_update(hfsmp
, &hfsmp
->hfs_private_desc
[DIR_HARDLINKS
],
821 &hfsmp
->hfs_private_attr
[DIR_HARDLINKS
], NULL
, NULL
);
822 (void)cat_update(hfsmp
, &hfsmp
->hfs_private_desc
[FILE_HARDLINKS
],
823 &hfsmp
->hfs_private_attr
[FILE_HARDLINKS
], NULL
, NULL
);
826 error
= 0; /* rename failure here is not fatal */
828 } else /* Still some links left */ {
832 * Update the start of the link chain.
833 * Note: Directory hard links store the first link in an attribute.
835 if (vnode_isdir(vp
) &&
836 getfirstlink(hfsmp
, cp
->c_fileid
, &firstlink
) == 0 &&
837 firstlink
== cndesc
.cd_cnid
) {
838 if (setfirstlink(hfsmp
, cp
->c_fileid
, nextlinkid
) == 0)
839 cp
->c_attr
.ca_recflags
|= kHFSHasAttributesMask
;
840 } else if (vnode_isreg(vp
) && cp
->c_attr
.ca_firstlink
== cndesc
.cd_cnid
) {
841 cp
->c_attr
.ca_firstlink
= nextlinkid
;
843 /* Update previous link. */
845 (void) cat_update_siblinglinks(hfsmp
, prevlinkid
, HFS_IGNORABLE_LINK
, nextlinkid
);
847 /* Update next link. */
849 (void) cat_update_siblinglinks(hfsmp
, nextlinkid
, prevlinkid
, HFS_IGNORABLE_LINK
);
853 /* Push new link count to disk. */
854 cp
->c_ctime
= tv
.tv_sec
;
855 (void) cat_update(hfsmp
, &cp
->c_desc
, &cp
->c_attr
, NULL
, NULL
);
857 /* All done with the system files. */
858 hfs_systemfile_unlock(hfsmp
, lockflags
);
861 /* Update file system stats. */
862 hfs_volupdate(hfsmp
, VOL_RMFILE
, (dcp
->c_cnid
== kHFSRootFolderID
));
865 * All done with this cnode's descriptor...
867 * Note: all future catalog calls for this cnode may be
868 * by fileid only. This is OK for HFS (which doesn't have
869 * file thread records) since HFS doesn't support hard links.
871 cat_releasedesc(&cp
->c_desc
);
875 hfs_systemfile_unlock(hfsmp
, lockflags
);
878 hfs_end_transaction(hfsmp
);
881 dcp
->c_flag
&= ~C_DIR_MODIFICATION
;
882 wakeup((caddr_t
)&dcp
->c_flag
);
889 * Initialize the HFS+ private system directories.
891 * These directories are used to hold the inodes
892 * for file and directory hardlinks as well as
893 * open-unlinked files.
895 * If they don't yet exist they will get created.
897 * This call is assumed to be made during mount.
900 hfs_privatedir_init(struct hfsmount
* hfsmp
, enum privdirtype type
)
902 struct vnode
* dvp
= NULLVP
;
903 struct cnode
* dcp
= NULL
;
904 struct cat_desc
*priv_descp
;
905 struct cat_attr
*priv_attrp
;
906 struct FndrDirInfo
* fndrinfo
;
912 if (hfsmp
->hfs_flags
& HFS_STANDARD
) {
916 priv_descp
= &hfsmp
->hfs_private_desc
[type
];
917 priv_attrp
= &hfsmp
->hfs_private_attr
[type
];
919 /* Check if directory already exists. */
920 if (priv_descp
->cd_cnid
!= 0) {
924 priv_descp
->cd_parentcnid
= kRootDirID
;
925 priv_descp
->cd_nameptr
= (const u_int8_t
*)hfs_private_names
[type
];
926 priv_descp
->cd_namelen
= strlen((const char *)priv_descp
->cd_nameptr
);
927 priv_descp
->cd_flags
= CD_ISDIR
| CD_DECOMPOSED
;
929 lockflags
= hfs_systemfile_lock(hfsmp
, SFL_CATALOG
, HFS_SHARED_LOCK
);
930 error
= cat_lookup(hfsmp
, priv_descp
, 0, NULL
, priv_attrp
, NULL
, NULL
);
931 hfs_systemfile_unlock(hfsmp
, lockflags
);
934 if (type
== FILE_HARDLINKS
) {
935 hfsmp
->hfs_metadata_createdate
= priv_attrp
->ca_itime
;
937 priv_descp
->cd_cnid
= priv_attrp
->ca_fileid
;
941 /* Directory is missing, if this is read-only then we're done. */
942 if (hfsmp
->hfs_flags
& HFS_READ_ONLY
) {
946 /* Grab the root directory so we can update it later. */
947 if (hfs_vget(hfsmp
, kRootDirID
, &dvp
, 0, 0) != 0) {
952 /* Setup the default attributes */
953 bzero(priv_attrp
, sizeof(struct cat_attr
));
954 priv_attrp
->ca_flags
= UF_IMMUTABLE
| UF_HIDDEN
;
955 priv_attrp
->ca_mode
= S_IFDIR
;
956 if (type
== DIR_HARDLINKS
) {
957 priv_attrp
->ca_mode
|= S_ISVTX
| S_IRUSR
| S_IXUSR
| S_IRGRP
|
958 S_IXGRP
| S_IROTH
| S_IXOTH
;
960 priv_attrp
->ca_linkcount
= 1;
961 priv_attrp
->ca_itime
= hfsmp
->hfs_itime
;
962 priv_attrp
->ca_recflags
= kHFSHasFolderCountMask
;
964 fndrinfo
= (struct FndrDirInfo
*)&priv_attrp
->ca_finderinfo
;
965 fndrinfo
->frLocation
.v
= SWAP_BE16(16384);
966 fndrinfo
->frLocation
.h
= SWAP_BE16(16384);
967 fndrinfo
->frFlags
= SWAP_BE16(kIsInvisible
+ kNameLocked
);
969 if (hfs_start_transaction(hfsmp
) != 0) {
974 lockflags
= hfs_systemfile_lock(hfsmp
, SFL_CATALOG
, HFS_EXCLUSIVE_LOCK
);
976 /* Make sure there's space in the Catalog file. */
977 if (cat_preflight(hfsmp
, CAT_CREATE
, NULL
, 0) != 0) {
978 hfs_systemfile_unlock(hfsmp
, lockflags
);
982 /* Create the private directory on disk. */
983 error
= cat_create(hfsmp
, priv_descp
, priv_attrp
, NULL
);
985 priv_descp
->cd_cnid
= priv_attrp
->ca_fileid
;
987 /* Update the parent directory */
989 INC_FOLDERCOUNT(hfsmp
, dcp
->c_attr
);
990 dcp
->c_dirchangecnt
++;
992 dcp
->c_ctime
= tv
.tv_sec
;
993 dcp
->c_mtime
= tv
.tv_sec
;
994 (void) cat_update(hfsmp
, &dcp
->c_desc
, &dcp
->c_attr
, NULL
, NULL
);
997 hfs_systemfile_unlock(hfsmp
, lockflags
);
1002 if (type
== FILE_HARDLINKS
) {
1003 hfsmp
->hfs_metadata_createdate
= priv_attrp
->ca_itime
;
1005 hfs_volupdate(hfsmp
, VOL_MKDIR
, 1);
1008 hfs_end_transaction(hfsmp
);
1014 if ((error
== 0) && (type
== DIR_HARDLINKS
)) {
1015 hfs_xattr_init(hfsmp
);
1021 * Lookup a hardlink link (from chain)
1024 hfs_lookup_siblinglinks(struct hfsmount
*hfsmp
, cnid_t linkfileid
, cnid_t
*prevlinkid
, cnid_t
*nextlinkid
)
1032 lockflags
= hfs_systemfile_lock(hfsmp
, SFL_CATALOG
, HFS_SHARED_LOCK
);
1034 error
= cat_lookup_siblinglinks(hfsmp
, linkfileid
, prevlinkid
, nextlinkid
);
1035 if (error
== ENOLINK
) {
1036 hfs_systemfile_unlock(hfsmp
, lockflags
);
1037 lockflags
= hfs_systemfile_lock(hfsmp
, SFL_ATTRIBUTE
, HFS_SHARED_LOCK
);
1039 error
= getfirstlink(hfsmp
, linkfileid
, nextlinkid
);
1041 hfs_systemfile_unlock(hfsmp
, lockflags
);
1047 * Cache the origin of a directory or file hard link
1049 * cnode must be lock on entry
1053 hfs_savelinkorigin(cnode_t
*cp
, cnid_t parentcnid
)
1055 linkorigin_t
*origin
= NULL
;
1056 void * thread
= current_thread();
1058 int maxorigins
= (S_ISDIR(cp
->c_mode
)) ? MAX_CACHED_ORIGINS
: MAX_CACHED_FILE_ORIGINS
;
1060 * Look for an existing origin first. If not found, create/steal one.
1062 TAILQ_FOREACH(origin
, &cp
->c_originlist
, lo_link
) {
1064 if (origin
->lo_thread
== thread
) {
1065 TAILQ_REMOVE(&cp
->c_originlist
, origin
, lo_link
);
1069 if (origin
== NULL
) {
1070 /* Recycle the last (i.e., the oldest) if we have too many. */
1071 if (count
> maxorigins
) {
1072 origin
= TAILQ_LAST(&cp
->c_originlist
, hfs_originhead
);
1073 TAILQ_REMOVE(&cp
->c_originlist
, origin
, lo_link
);
1075 MALLOC(origin
, linkorigin_t
*, sizeof(linkorigin_t
), M_TEMP
, M_WAITOK
);
1077 origin
->lo_thread
= thread
;
1079 origin
->lo_cnid
= cp
->c_cnid
;
1080 origin
->lo_parentcnid
= parentcnid
;
1081 TAILQ_INSERT_HEAD(&cp
->c_originlist
, origin
, lo_link
);
1085 * Release any cached origins for a directory or file hard link
1087 * cnode must be lock on entry
1091 hfs_relorigins(struct cnode
*cp
)
1093 linkorigin_t
*origin
, *prev
;
1095 TAILQ_FOREACH_SAFE(origin
, &cp
->c_originlist
, lo_link
, prev
) {
1096 FREE(origin
, M_TEMP
);
1098 TAILQ_INIT(&cp
->c_originlist
);
1102 * Release a specific origin for a directory or file hard link
1104 * cnode must be lock on entry
1108 hfs_relorigin(struct cnode
*cp
, cnid_t parentcnid
)
1110 linkorigin_t
*origin
, *prev
;
1111 void * thread
= current_thread();
1113 TAILQ_FOREACH_SAFE(origin
, &cp
->c_originlist
, lo_link
, prev
) {
1114 if ((origin
->lo_thread
== thread
) ||
1115 (origin
->lo_parentcnid
== parentcnid
)) {
1116 TAILQ_REMOVE(&cp
->c_originlist
, origin
, lo_link
);
1117 FREE(origin
, M_TEMP
);
1124 * Test if a directory or file hard link has a cached origin
1126 * cnode must be lock on entry
1130 hfs_haslinkorigin(cnode_t
*cp
)
1132 if (cp
->c_flag
& C_HARDLINK
) {
1133 linkorigin_t
*origin
;
1134 void * thread
= current_thread();
1136 TAILQ_FOREACH(origin
, &cp
->c_originlist
, lo_link
) {
1137 if (origin
->lo_thread
== thread
) {
1146 * Obtain the current parent cnid of a directory or file hard link
1148 * cnode must be lock on entry
1152 hfs_currentparent(cnode_t
*cp
)
1154 if (cp
->c_flag
& C_HARDLINK
) {
1155 linkorigin_t
*origin
;
1156 void * thread
= current_thread();
1158 TAILQ_FOREACH(origin
, &cp
->c_originlist
, lo_link
) {
1159 if (origin
->lo_thread
== thread
) {
1160 return (origin
->lo_parentcnid
);
1164 return (cp
->c_parentcnid
);
1168 * Obtain the current cnid of a directory or file hard link
1170 * cnode must be lock on entry
1174 hfs_currentcnid(cnode_t
*cp
)
1176 if (cp
->c_flag
& C_HARDLINK
) {
1177 linkorigin_t
*origin
;
1178 void * thread
= current_thread();
1180 TAILQ_FOREACH(origin
, &cp
->c_originlist
, lo_link
) {
1181 if (origin
->lo_thread
== thread
) {
1182 return (origin
->lo_cnid
);
1186 return (cp
->c_cnid
);
1191 * Set the first link attribute for a given file id.
1193 * The attributes b-tree must already be locked.
1194 * If journaling is enabled, a transaction must already be started.
1197 setfirstlink(struct hfsmount
* hfsmp
, cnid_t fileid
, cnid_t firstlink
)
1200 BTreeIterator
* iterator
;
1201 FSBufferDescriptor btdata
;
1202 u_int8_t attrdata
[FIRST_LINK_XATTR_REC_SIZE
];
1203 HFSPlusAttrData
*dataptr
;
1207 if (hfsmp
->hfs_attribute_cp
== NULL
) {
1210 MALLOC(iterator
, BTreeIterator
*, sizeof(*iterator
), M_TEMP
, M_WAITOK
);
1211 bzero(iterator
, sizeof(*iterator
));
1213 result
= hfs_buildattrkey(fileid
, FIRST_LINK_XATTR_NAME
, (HFSPlusAttrKey
*)&iterator
->key
);
1217 dataptr
= (HFSPlusAttrData
*)&attrdata
[0];
1218 dataptr
->recordType
= kHFSPlusAttrInlineData
;
1219 dataptr
->reserved
[0] = 0;
1220 dataptr
->reserved
[1] = 0;
1223 * Since attrData is variable length, we calculate the size of
1224 * attrData by subtracting the size of all other members of
1225 * structure HFSPlusAttData from the size of attrdata.
1227 (void)snprintf((char *)&dataptr
->attrData
[0],
1228 sizeof(dataptr
) - (4 * sizeof(uint32_t)),
1229 "%lu", (unsigned long)firstlink
);
1230 dataptr
->attrSize
= 1 + strlen((char *)&dataptr
->attrData
[0]);
1232 /* Calculate size of record rounded up to multiple of 2 bytes. */
1233 datasize
= sizeof(HFSPlusAttrData
) - 2 + dataptr
->attrSize
+ ((dataptr
->attrSize
& 1) ? 1 : 0);
1235 btdata
.bufferAddress
= dataptr
;
1236 btdata
.itemSize
= datasize
;
1237 btdata
.itemCount
= 1;
1239 btfile
= hfsmp
->hfs_attribute_cp
->c_datafork
;
1241 /* Insert the attribute. */
1242 result
= BTInsertRecord(btfile
, iterator
, &btdata
, datasize
);
1243 if (result
== btExists
) {
1244 result
= BTReplaceRecord(btfile
, iterator
, &btdata
, datasize
);
1246 (void) BTFlushPath(btfile
);
1248 FREE(iterator
, M_TEMP
);
1250 return MacToVFSError(result
);
1254 * Get the first link attribute for a given file id.
1256 * The attributes b-tree must already be locked.
1259 getfirstlink(struct hfsmount
* hfsmp
, cnid_t fileid
, cnid_t
*firstlink
)
1262 BTreeIterator
* iterator
;
1263 FSBufferDescriptor btdata
;
1264 u_int8_t attrdata
[FIRST_LINK_XATTR_REC_SIZE
];
1265 HFSPlusAttrData
*dataptr
;
1269 if (hfsmp
->hfs_attribute_cp
== NULL
) {
1272 MALLOC(iterator
, BTreeIterator
*, sizeof(*iterator
), M_TEMP
, M_WAITOK
);
1273 bzero(iterator
, sizeof(*iterator
));
1275 result
= hfs_buildattrkey(fileid
, FIRST_LINK_XATTR_NAME
, (HFSPlusAttrKey
*)&iterator
->key
);
1279 dataptr
= (HFSPlusAttrData
*)&attrdata
[0];
1280 datasize
= sizeof(attrdata
);
1282 btdata
.bufferAddress
= dataptr
;
1283 btdata
.itemSize
= sizeof(attrdata
);
1284 btdata
.itemCount
= 1;
1286 btfile
= hfsmp
->hfs_attribute_cp
->c_datafork
;
1288 result
= BTSearchRecord(btfile
, iterator
, &btdata
, NULL
, NULL
);
1292 if (dataptr
->attrSize
< 3) {
1296 *firstlink
= strtoul((char*)&dataptr
->attrData
[0], NULL
, 10);
1298 FREE(iterator
, M_TEMP
);
1300 return MacToVFSError(result
);