Print this page
14249 pseudo-terminal nomenclature should reflect POSIX
Change-Id: Ib4a3cef899ff4c71b09cb0dc6878863c5e8357bc
@@ -33,22 +33,21 @@
#endif
#ifdef _KERNEL
/*
- * Structures and definitions supporting the pseudo terminal
- * drivers. This structure is private and should not be used by any
- * applications.
+ * Structures and definitions supporting the pseudo-terminal drivers. This
+ * structure is private and should not be used by any applications.
*/
struct pt_ttys {
- queue_t *ptm_rdq; /* master's read queue pointer */
- queue_t *pts_rdq; /* slave's read queue pointer */
+ queue_t *ptm_rdq; /* manager's read queue pointer */
+ queue_t *pts_rdq; /* subsidiary's read queue pointer */
mblk_t *pt_nullmsg; /* 0-bytes message block for pts close */
pid_t pt_pid; /* process id (for debugging) */
minor_t pt_minor; /* Minor number of this pty */
int pt_refcnt; /* reference count for ptm_rdq/pts_rdq uses */
- ushort_t pt_state; /* state of master/slave pair */
+ ushort_t pt_state; /* state of manager/subsidiary pair */
kcondvar_t pt_cv; /* condition variable for exclusive access */
kmutex_t pt_lock; /* Per-element lock */
zoneid_t pt_zoneid; /* Zone membership for this pty */
uid_t pt_ruid; /* Real owner of pty */
gid_t pt_rgid; /* Real group owner of pty */
@@ -55,14 +54,14 @@
};
/*
* pt_state values
*/
-#define PTLOCK 0x01 /* master/slave pair is locked */
-#define PTMOPEN 0x02 /* master side is open */
-#define PTSOPEN 0x04 /* slave side is open */
-#define PTSTTY 0x08 /* slave side is tty */
+#define PTLOCK 0x01 /* manager/subsidiary pair is locked */
+#define PTMOPEN 0x02 /* manager side is open */
+#define PTSOPEN 0x04 /* subsidiary side is open */
+#define PTSTTY 0x08 /* subsidiary side is tty */
/*
* Multi-threading primitives.
* Values of pt_refcnt: -1 if a writer is accessing the struct
* 0 if no one is reading or writing
@@ -108,15 +107,15 @@
extern void ptms_init(void);
extern struct pt_ttys *pt_ttys_alloc(void);
extern void ptms_close(struct pt_ttys *, uint_t);
extern struct pt_ttys *ptms_minor2ptty(minor_t);
-extern int ptms_attach_slave(void);
+extern int ptms_attach_subsidiary(void);
extern int ptms_minor_valid(minor_t ptmin, uid_t *uid, gid_t *gid);
extern int ptms_minor_exists(minor_t ptmin);
extern void ptms_set_owner(minor_t ptmin, uid_t uid, gid_t gid);
-extern major_t ptms_slave_attached(void);
+extern major_t ptms_subsidiary_attached(void);
#ifdef DEBUG
extern void ptms_log(char *, uint_t);
extern void ptms_logp(char *, uintptr_t);
#define DDBG(a, b) ptms_log(a, b)
@@ -132,32 +131,36 @@
uid_t pto_ruid;
gid_t pto_rgid;
} pt_own_t;
/*
- * ioctl commands
+ * IOCTL COMMANDS
*
- * ISPTM: Determines whether the file descriptor is that of an open master
- * device. Return code of zero indicates that the file descriptor
- * represents master device.
+ * ISPTM
+ * Determines whether the file descriptor is that of an open
+ * manager device. Return code of zero indicates that the file
+ * descriptor represents a manager device.
*
- * UNLKPT: Unlocks the master and slave devices. It returns 0 on success. On
- * failure, the errno is set to EINVAL indicating that the master
- * device is not open.
+ * UNLKPT
+ * Unlocks the manager and subsidiary devices. It returns 0 on
+ * success. On failure, the errno is set to EINVAL indicating
+ * that the manager device is not open.
*
- * ZONEPT: Sets the zoneid of the pair of master and slave devices. It
- * returns 0 upon success. Used to force a pty 'into' a zone upon
- * zone entry.
+ * ZONEPT
+ * Sets the zoneid of the pair of manager and subsidiary devices.
+ * It returns 0 upon success. Used to force a pty 'into' a zone
+ * upon zone entry.
*
- * PT_OWNER: Sets uid and gid for slave device. It returns 0 on success.
- *
+ * PT_OWNER
+ * Sets uid and gid for subsidiary device. It returns 0 on
+ * success.
*/
-#define ISPTM (('P'<<8)|1) /* query for master */
-#define UNLKPT (('P'<<8)|2) /* unlock master/slave pair */
+#define ISPTM (('P'<<8)|1) /* query for manager */
+#define UNLKPT (('P'<<8)|2) /* unlock manager/subsidiary pair */
#define PTSSTTY (('P'<<8)|3) /* set tty flag */
-#define ZONEPT (('P'<<8)|4) /* set zone of master/slave pair */
-#define OWNERPT (('P'<<8)|5) /* set owner/group for slave device */
+#define ZONEPT (('P'<<8)|4) /* set zone of manager/subsidiary pair */
+#define OWNERPT (('P'<<8)|5) /* set owner/group for subsidiary */
#ifdef __cplusplus
}
#endif