- * characters of the name to be translated. The flag
- * argument is (0, 1, 2) depending on whether the name is to be
- * (looked up, created, deleted). The follow argument is 1 when
- * symbolic links are to be followed when they occur at the end of
- * the name translation process.
+ * characters of the name to be translated.
+ *
+ * The flag argument is (LOOKUP, CREATE, DELETE) depending on whether
+ * the name is to be (looked up, created, deleted). If flag has
+ * LOCKPARENT or'ed into it and the target of the pathname exists,
+ * namei returns both the target and its parent directory locked.
+ * If the file system is not maintained in a strict tree hierarchy,
+ * this can result in a deadlock situation. When creating and
+ * LOCKPARENT is specified, the target may not be ".". When deleting
+ * and LOCKPARENT is specified, the target may be ".", but the caller
+ * must check to insure it does an irele and iput instead of two iputs.
+ *
+ * The follow argument is 1 when symbolic links are to be followed
+ * when they occur at the end of the name translation process.